@vortexm/vjt 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { renderApp, renderJson } from './lib/render.js';
 export { ResourceManager } from './lib/resource-manager.js';
 export { DEFAULT_STYLE_MAP } from './lib/default-styles.js';
-export type { ActionDefinition, ActionMap, AdaptiveLayoutNode, BaseNode, ButtonNode, CheckboxNode, ComboboxNode, ConditionExpression, ConditionalContainerNode, ContextMenuNode, ContainerCell, ContainerLayoutNode, CellConstraints, DescriptionNode, GridViewNode, HeadingTag, I18nMap, ImageNode, LayoutType, LinkNode, ListElementContext, ListNode, ListboxNode, MdTextNode, ModalWindowNode, MountJsonOptions, OverlayContainerNode, OverlayLayer, PanelNode, PrimitiveRequestType, RadioGroupNode, RequestDefinition, RequestMap, RequestSchema, RenderJsonOptions, RuntimeSnapshot, SseConfig, SseConfigInput, SseEventDefinition, SpoilerNode, SplitterNode, StaticTextNode, StyleMap, SystemEventName, TabsNode, TextAlign, TextareaNode, UiReferenceNode, Theme, VerticalAlign, WidgetEventName, WidgetState } from './lib/types.js';
+export type { ActionDefinition, ActionMap, AdaptiveLayoutNode, BaseNode, ButtonNode, CheckboxNode, ComboboxNode, ConditionExpression, ConditionalContainerNode, ContextMenuNode, ContainerCell, ContainerLayoutNode, CellConstraints, DescriptionNode, GridViewNode, HeadingTag, I18nMap, ImageNode, LayoutType, LinkNode, ListElementContext, ListNode, ListboxNode, MdTextNode, ModalWindowNode, MountJsonOptions, OverlayContainerNode, OverlayLayer, PanelNode, PrimitiveRequestType, RadioGroupNode, RouteDefinition, RoutesConfigInput, RequestDefinition, RequestMap, RequestSchema, RenderJsonOptions, RuntimeSnapshot, SseConfig, SseConfigInput, SseEventDefinition, SpoilerNode, SplitterNode, StaticTextNode, StyleMap, SystemEventName, TabsNode, TextAlign, TextareaNode, UiReferenceNode, Theme, VerticalAlign, WidgetEventName, WidgetState } from './lib/types.js';

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("."));
@@ -4374,8 +4405,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.")) {
@@ -4443,6 +4478,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 +4541,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 +4550,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 +4564,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 +4585,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 +4593,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
@@ -4580,6 +4648,9 @@ var ActionRuntime = class {
   clearWidget;
   clearListElementState;
   focusWidget;
+  scrollWidgetToTop;
+  scrollWidgetToBottom;
+  scrollWidgetToElementByIndex;
   playAudio;
   stopPlaying;
   copyToClipboard;
@@ -4617,6 +4688,9 @@ var ActionRuntime = class {
     this.clearWidget = options.clearWidget;
     this.clearListElementState = options.clearListElementState;
     this.focusWidget = options.focusWidget;
+    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 +4752,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 +4839,7 @@ var ActionRuntime = class {
       return null;
     }
     if (name === "startListening") {
-      await this.startListening();
+      await this.startListening(action.args);
       return null;
     }
     if (name === "stopListening") {
@@ -4817,6 +4891,18 @@ var ActionRuntime = class {
       this.focusWidget(name.slice(9));
       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 +4913,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 +4986,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 +5012,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 +5042,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,8 +5062,8 @@ 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);
     }
@@ -4964,6 +5110,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 +5579,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 +5632,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 +5743,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 +5775,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 +5797,9 @@ var VoiceRuntime = class {
           void step();
         });
       };
+      logRuntimeDebug(this.debugLogging, "voice-listening-started", {
+        silenceThreshold
+      });
       void step();
     } catch (error) {
       await this.handleListeningError(error);
@@ -6010,7 +6215,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 +6261,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 +6298,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 +6324,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 +6364,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");
@@ -6224,10 +6429,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)}"` : "";
@@ -6984,6 +7189,7 @@ var RuntimeRenderer = class {
   i18n;
   actionsMap;
   requestsMap;
+  routes;
   sseConfigs;
   systemEvents;
   resourceManager;
@@ -7003,6 +7209,7 @@ var RuntimeRenderer = class {
   vars = /* @__PURE__ */ new Map();
   resizeHandler = null;
   pointerHandler = null;
+  popstateHandler = null;
   eventSources = [];
   referenceRuntime;
   networkRuntime;
@@ -7015,6 +7222,9 @@ var RuntimeRenderer = class {
   activeConfirmModal = null;
   lastPointer = { x: 24, y: 24 };
   pendingResetModalIds = /* @__PURE__ */ new Set();
+  pendingScrollAction = null;
+  pendingScrollFrameId = null;
+  activeScrollAnimationFrameId = null;
   constructor(description, options = {}) {
     this.description = deepClone(description);
     this.resourceManager = options.resourceManager ?? null;
@@ -7028,6 +7238,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,6 +7253,7 @@ 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":
@@ -7114,6 +7327,9 @@ var RuntimeRenderer = class {
       clearWidget: (widgetId) => this.clearWidget(widgetId),
       clearListElementState: (listKey) => this.clearListElementState(listKey),
       focusWidget: (reference) => this.focusWidget(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 +7337,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 +7367,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 +7422,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 +7440,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 +7465,7 @@ var RuntimeRenderer = class {
     this.attachInputBehavior(this.root);
     this.attachWidgetEvents(this.root);
     restoreElementState(this.root, preservedState, this.stateByKey);
+    this.applyPendingScrollAction();
     this.activeContextMenu = adjustContextMenuPosition(this.root, this.activeContextMenu);
     this.pendingResetModalIds.clear();
     if (typeof this.onRuntimeSnapshot === "function") {
@@ -7413,7 +7645,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") {
@@ -7871,6 +8209,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 +8241,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),
@@ -8434,6 +8787,138 @@ var RuntimeRenderer = class {
       nestedTarget.focus({ preventScroll: true });
     }
   }
+  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;
+    const element = this.findScrollableWidgetElement(pending.reference);
+    if (!element) {
+      return;
+    }
+    if (pending.kind === "top") {
+      this.animateScrollTop(element, 0);
+      this.pendingScrollAction = null;
+      return;
+    }
+    if (pending.kind === "bottom") {
+      this.animateScrollTop(element, element.scrollHeight);
+      this.pendingScrollAction = null;
+      return;
+    }
+    const index = this.toScrollableIndex(pending.indexValue);
+    if (index === null) {
+      this.pendingScrollAction = null;
+      return;
+    }
+    this.performScrollToElementByIndex(element, index);
+    this.pendingScrollAction = null;
+  }
+  performScrollToElementByIndex(element, index) {
+    if (element instanceof HTMLSelectElement) {
+      const option = element.options.item(index);
+      if (!option) {
+        return;
+      }
+      const maxScrollTop = Math.max(0, element.scrollHeight - element.clientHeight);
+      this.animateScrollTop(element, 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(element, nextScrollTop);
+    }
+  }
+  animateScrollTop(element, targetTop) {
+    if (typeof window === "undefined") {
+      element.scrollTop = targetTop;
+      return;
+    }
+    if (this.activeScrollAnimationFrameId !== null) {
+      window.cancelAnimationFrame(this.activeScrollAnimationFrameId);
+      this.activeScrollAnimationFrameId = null;
+    }
+    const startTop = element.scrollTop;
+    const clampedTargetTop = Math.max(0, targetTop);
+    const delta = clampedTargetTop - startTop;
+    if (Math.abs(delta) < 1) {
+      element.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 elapsed = now - startTime;
+      const progress = Math.min(1, elapsed / durationMs);
+      element.scrollTop = startTop + delta * easeInOutCubic(progress);
+      if (progress < 1) {
+        this.activeScrollAnimationFrameId = window.requestAnimationFrame(tick);
+      } else {
+        element.scrollTop = clampedTargetTop;
+        this.activeScrollAnimationFrameId = null;
+      }
+    };
+    this.activeScrollAnimationFrameId = window.requestAnimationFrame(tick);
+  }
+  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 +8934,7 @@ var ResourceManager = class {
   ui = /* @__PURE__ */ new Map();
   actions = {};
   requests = {};
+  routes = [];
   sse = {};
   systemEvents = {};
   i18n = {};
@@ -8459,6 +8945,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 +8963,9 @@ var ResourceManager = class {
   getRequestsMap() {
     return this.requests;
   }
+  getRoutes() {
+    return this.routes.map((route) => ({ ...route }));
+  }
   getSseConfigs() {
     return Object.values(this.sse);
   }

package/dist/lib/action-runtime.d.ts

@@ -32,6 +32,9 @@ type ActionRuntimeOptions = {
     clearWidget: (widgetId: string) => void;
     clearListElementState: (listKey: string) => void;
     focusWidget: (reference: string) => void;
+    scrollWidgetToTop: (reference: string) => void;
+    scrollWidgetToBottom: (reference: string) => void;
+    scrollWidgetToElementByIndex: (reference: string, index: unknown) => void;
     playAudio: (value: unknown) => Promise<void>;
     stopPlaying: () => Promise<void>;
     copyToClipboard: (value: unknown) => Promise<void>;
@@ -39,7 +42,7 @@ type ActionRuntimeOptions = {
     confirmModal: (options: unknown, inputValue: unknown) => Promise<boolean>;
     startRecording: () => Promise<void>;
     stopRecording: () => Promise<void>;
-    startListening: () => Promise<void>;
+    startListening: (args?: unknown) => Promise<void>;
     stopListening: () => Promise<void>;
     setUiReference: (widgetId: string, resourceRef: string) => void;
     refreshWidgetTree: (widgetId: string) => Promise<void>;
@@ -82,6 +85,9 @@ export declare class ActionRuntime {
     private readonly clearWidget;
     private readonly clearListElementState;
     private readonly focusWidget;
+    private readonly scrollWidgetToTop;
+    private readonly scrollWidgetToBottom;
+    private readonly scrollWidgetToElementByIndex;
     private readonly playAudio;
     private readonly stopPlaying;
     private readonly copyToClipboard;
@@ -115,5 +121,8 @@ export declare class ActionRuntime {
     private cloneValue;
     private stringifyValue;
     private isCurrentScopedReference;
+    private countValue;
+    private toNumber;
+    private asListWidgetState;
 }
 export {};

package/dist/lib/references.d.ts

@@ -4,6 +4,7 @@ type ReferenceRuntimeHost = {
     readonly stateByKey: Map<string, WidgetState>;
     readonly nodeById: Map<string, DescriptionNode>;
     readonly nodeByKey: Map<string, DescriptionNode>;
+    getUiResource: (ref: string) => DescriptionNode | null;
     getAppValue: (name: string) => unknown;
     setAppValue: (name: string, value: unknown) => void;
     getVarValue: (name: string) => unknown;
@@ -19,12 +20,15 @@ export declare class ReferenceRuntime {
     resolveReference(reference: string, currentValue: unknown, responseValue: unknown): unknown;
     resolveCurrentReference(reference: string, currentValue: unknown): unknown;
     readWidgetField(state: WidgetState, field: string): unknown;
-    assignReference(reference: string, inputValue: unknown, _currentValue: unknown, options?: {
+    assignReference(reference: string, inputValue: unknown, currentValue: unknown, options?: {
         cookieTtl?: unknown;
     }): void;
+    private assignCurrentReference;
     clearListElementState(listKey: string): void;
     resolveMappedValue(template: unknown, currentValue: unknown, responseValue: unknown): unknown;
     isListElementContext(value: unknown): value is ListElementContext;
-    findNamedWidget(node: DescriptionNode | undefined, name: string): DescriptionNode | null;
+    findNamedWidget(node: DescriptionNode | undefined, name: string, currentValue?: unknown): DescriptionNode | null;
+    private resolveListDescriptorNode;
+    private resolveUiReferenceNode;
 }
 export {};

package/dist/lib/resource-manager.d.ts

@@ -1,8 +1,9 @@
-import type { ActionMap, DescriptionNode, I18nMap, RequestMap, SseConfig, SystemEventsMap, StyleMap } from './types.js';
+import type { ActionMap, DescriptionNode, I18nMap, RequestMap, RouteDefinition, RoutesConfigInput, SseConfig, SystemEventsMap, StyleMap } from './types.js';
 export type ResourceManagerInput = {
     ui?: Record<string, DescriptionNode>;
     actions?: ActionMap;
     requests?: RequestMap;
+    routes?: RoutesConfigInput;
     sse?: Record<string, SseConfig>;
     systemEvents?: SystemEventsMap;
     i18n?: I18nMap;
@@ -12,6 +13,7 @@ export declare class ResourceManager {
     private readonly ui;
     private actions;
     private requests;
+    private routes;
     private sse;
     private systemEvents;
     private i18n;
@@ -21,6 +23,7 @@ export declare class ResourceManager {
     setUi(name: string, description: DescriptionNode): void;
     getActionsMap(): ActionMap;
     getRequestsMap(): RequestMap;
+    getRoutes(): RouteDefinition[];
     getSseConfigs(): SseConfig[];
     getSystemEvents(): SystemEventsMap;
     getI18n(): I18nMap;

package/dist/lib/types.d.ts

@@ -6,6 +6,13 @@ export type HeadingTag = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
 export type WidgetEventName = 'onClick' | 'onUserValueChange' | 'onRefresh' | 'onEnter' | 'onShiftEnter' | 'onControlEnter';
 export type SystemEventName = 'onBeforeRender' | 'onAfterRender' | 'onBeforeNavigate' | 'onAfterNavigate' | 'onSpeechDetected' | 'onRecordingStarted' | 'onRecordingStopped' | 'onRecordingError' | 'onListeningError' | 'onListeringError' | 'onPlayFinished' | 'onPlayingStopped';
 export type PrimitiveRequestType = 'int' | 'float' | 'boolean' | 'string';
+export type RouteDefinition = {
+    path: string;
+    ui: string;
+};
+export type RoutesConfigInput = RouteDefinition[] | {
+    routes: RouteDefinition[];
+};
 export type ActionDefinition = {
     action: string;
     andThen?: ActionDefinition[];
@@ -139,6 +146,7 @@ export type RenderJsonOptions = {
     requestsMap?: RequestMap;
     sseConfigs?: SseConfigInput;
     systemEvents?: SystemEventsMap;
+    routes?: RoutesConfigInput;
     actionFunctions?: Record<string, () => unknown>;
     backendUrl?: string;
     resourceManager?: ResourceManager;

package/dist/lib/voice-runtime.d.ts

@@ -27,7 +27,7 @@ export declare class VoiceRuntime {
     stopPlaying(): Promise<void>;
     startRecording(): Promise<void>;
     stopRecording(): void;
-    startListening(): Promise<void>;
+    startListening(args?: unknown): Promise<void>;
     stopListening(): Promise<void>;
     dispose(): void;
     private startRecordingInternal;

package/dist/lib/widgets/context.d.ts

@@ -29,6 +29,7 @@ export type WidgetRenderEnvironment = {
     escapeHtml: (value: unknown) => string;
     buildStyleString: (node: DescriptionNode) => string;
     resolveI18nValue: (value: string | undefined) => string;
+    resolveTextValue: (value: string | undefined, itemContext: ListElementContext | null) => string;
     getUiResource: (ref: string) => DescriptionNode | null;
     resolveReference: (reference: string, currentValue: unknown, responseValue: unknown) => unknown;
     buildWidgetDataAttributes: (key: string, node: DescriptionNode) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vortexm/vjt",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",