@qontinui/ui-bridge-native 0.6.12 → 0.6.14

package/dist/control/index.js

@@ -1,12 +1,469 @@
 'use strict';
 
 // src/core/registry.ts
+function pageRectOf(state) {
+  const layout = state.layout;
+  if (!layout) return null;
+  if (layout.pageOriginUnmeasured === true) return null;
+  const hasPage = typeof layout.pageX === "number" && typeof layout.pageY === "number" && Number.isFinite(layout.pageX) && Number.isFinite(layout.pageY);
+  if (!hasPage) return null;
+  const left = layout.pageX;
+  const top = layout.pageY;
+  if (typeof layout.width !== "number" || typeof layout.height !== "number" || !Number.isFinite(layout.width) || !Number.isFinite(layout.height)) {
+    return null;
+  }
+  return { left, top, right: left + layout.width, bottom: top + layout.height };
+}
+function isEmptyRect(rect) {
+  return rect.right <= rect.left || rect.bottom <= rect.top;
+}
+function intersectRects(a, b) {
+  if (!a) return b;
+  if (!b) return a;
+  return {
+    left: Math.max(a.left, b.left),
+    top: Math.max(a.top, b.top),
+    right: Math.min(a.right, b.right),
+    bottom: Math.min(a.bottom, b.bottom)
+  };
+}
 
 // src/core/element-identifier.ts
 function findElementByIdentifier(identifier) {
   return null;
 }
 
+// src/core/abortable.ts
+var MAX_ACTION_TIMEOUT_MS = 864e5;
+function normalizeActionTimeoutMs(raw) {
+  if (raw === void 0 || raw === null) {
+    return { ok: true, timeoutMs: void 0, clamped: false };
+  }
+  if (typeof raw !== "number") {
+    return {
+      ok: false,
+      reason: `timeoutMs must be a number of milliseconds, received ${typeof raw === "string" ? JSON.stringify(raw) : typeof raw}`
+    };
+  }
+  if (!Number.isFinite(raw)) {
+    return {
+      ok: false,
+      reason: `timeoutMs must be a finite number of milliseconds, received ${String(raw)}`
+    };
+  }
+  if (raw < 0) {
+    return {
+      ok: false,
+      reason: `timeoutMs must not be negative, received ${String(raw)}`
+    };
+  }
+  if (raw > MAX_ACTION_TIMEOUT_MS) {
+    return { ok: true, timeoutMs: MAX_ACTION_TIMEOUT_MS, clamped: true };
+  }
+  return { ok: true, timeoutMs: Math.floor(raw), clamped: false };
+}
+function inertAbortSignal() {
+  return new AbortController().signal;
+}
+async function runAbortable(invoke, options = {}) {
+  const callerSignal = options.signal;
+  const timeoutMs = options.timeoutMs;
+  if (callerSignal?.aborted) {
+    return { aborted: true, reason: "signal" };
+  }
+  const controller = new AbortController();
+  let reason = "signal";
+  let timer;
+  const onCallerAbort = () => {
+    reason = "signal";
+    controller.abort();
+  };
+  callerSignal?.addEventListener("abort", onCallerAbort, { once: true });
+  if (typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs >= 0) {
+    timer = setTimeout(
+      () => {
+        reason = "timeout";
+        controller.abort();
+      },
+      Math.min(timeoutMs, MAX_ACTION_TIMEOUT_MS)
+    );
+  }
+  try {
+    const abandoned = new Promise((resolve) => {
+      controller.signal.addEventListener("abort", () => resolve({ aborted: true, reason }), {
+        once: true
+      });
+    });
+    const completed = (async () => ({
+      aborted: false,
+      result: await invoke(controller.signal)
+    }))();
+    return await Promise.race([completed, abandoned]);
+  } finally {
+    if (timer !== void 0) clearTimeout(timer);
+    callerSignal?.removeEventListener("abort", onCallerAbort);
+  }
+}
+
+// src/core/param-schema.ts
+var DEFAULT_PARAM_VALIDATION_MODE = "warn";
+var currentDefaultMode = DEFAULT_PARAM_VALIDATION_MODE;
+function getDefaultParamValidationMode() {
+  return currentDefaultMode;
+}
+var PRIMITIVE_TYPE_NAMES = /* @__PURE__ */ new Set([
+  "string",
+  "number",
+  "integer",
+  "boolean",
+  "object",
+  "array",
+  "null"
+]);
+var OBJECT_SCHEMA_KEYWORDS = /* @__PURE__ */ new Set([
+  "type",
+  "properties",
+  "required",
+  "additionalProperties",
+  "patternProperties",
+  "propertyNames",
+  "minProperties",
+  "maxProperties",
+  "dependentRequired",
+  "dependentSchemas",
+  "unevaluatedProperties",
+  "allOf",
+  "anyOf",
+  "oneOf",
+  "not",
+  "if",
+  "then",
+  "else",
+  "enum",
+  "const",
+  "default",
+  "examples",
+  "title",
+  "description",
+  "deprecated",
+  "readOnly",
+  "writeOnly",
+  "$schema",
+  "$id",
+  "$ref",
+  "$comment",
+  "$defs",
+  "definitions"
+]);
+var MAX_SCHEMA_DEPTH = 32;
+var MAX_PATTERN_LENGTH = 200;
+function hasNestedQuantifiers(pattern) {
+  return /(\((?:[^()]*[+*}])[^()]*\))[+*?]|\(\?:[^()]*[+*}][^()]*\)[+*?]/.test(pattern);
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var hasOwnProperty = Object.prototype.hasOwnProperty;
+function hasOwn(value, key) {
+  return hasOwnProperty.call(value, key);
+}
+function render(value) {
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  if (Array.isArray(value)) return `array(${value.length})`;
+  const t = typeof value;
+  if (t === "string") return JSON.stringify(value);
+  if (t === "number" || t === "boolean") return String(value);
+  if (t === "object") return "object";
+  return t;
+}
+var MAX_RENDERED_JSON_LENGTH = 120;
+function renderJson(value) {
+  if (value === void 0) return "undefined";
+  let text;
+  try {
+    text = JSON.stringify(value) ?? String(value);
+  } catch {
+    return render(value);
+  }
+  return text.length > MAX_RENDERED_JSON_LENGTH ? `${text.slice(0, MAX_RENDERED_JSON_LENGTH)}\u2026` : text;
+}
+function jsonTypeOf(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  const t = typeof value;
+  if (t === "number") return Number.isInteger(value) ? "integer" : "number";
+  if (t === "string" || t === "boolean" || t === "object") return t;
+  return t;
+}
+function matchesType(value, typeName) {
+  switch (typeName) {
+    case "string":
+      return typeof value === "string";
+    case "number":
+      return typeof value === "number" && Number.isFinite(value);
+    case "integer":
+      return typeof value === "number" && Number.isInteger(value);
+    case "boolean":
+      return typeof value === "boolean";
+    case "null":
+      return value === null;
+    case "array":
+      return Array.isArray(value);
+    case "object":
+      return isPlainObject(value);
+    default:
+      return true;
+  }
+}
+function jsonEquals(a, b, depth = 0) {
+  if (a === b) return true;
+  if (depth > MAX_SCHEMA_DEPTH) return false;
+  if (a === null || b === null || a === void 0 || b === void 0) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  const aIsArray = Array.isArray(a);
+  if (aIsArray !== Array.isArray(b)) return false;
+  if (aIsArray) {
+    const bArr = b;
+    const aArr = a;
+    if (aArr.length !== bArr.length) return false;
+    return aArr.every((item, i) => jsonEquals(item, bArr[i], depth + 1));
+  }
+  const aObj = a;
+  const bObj = b;
+  const aKeys = Object.keys(aObj);
+  const bKeys = Object.keys(bObj);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every((key) => hasOwn(bObj, key) && jsonEquals(aObj[key], bObj[key], depth + 1));
+}
+function joinPath(base, key) {
+  return base === "" ? key : `${base}.${key}`;
+}
+function readTypes(schema) {
+  const raw = schema["type"];
+  if (typeof raw === "string") return [raw];
+  if (Array.isArray(raw)) {
+    const names = raw.filter((t) => typeof t === "string");
+    return names.length > 0 ? names : null;
+  }
+  return null;
+}
+function validateValue(value, schema, path, issues, depth) {
+  if (depth > MAX_SCHEMA_DEPTH) return;
+  if (typeof schema === "string") {
+    if (PRIMITIVE_TYPE_NAMES.has(schema) && !matchesType(value, schema)) {
+      issues.push({
+        path,
+        keyword: "type",
+        expected: schema,
+        received: render(value),
+        message: `Parameter "${path}" must be of type ${schema}, received ${jsonTypeOf(value)} (${render(value)}).`
+      });
+    }
+    return;
+  }
+  if (!isPlainObject(schema)) return;
+  const types = readTypes(schema);
+  if (types !== null && !types.some((t) => matchesType(value, t))) {
+    const expected = types.join(" | ");
+    issues.push({
+      path,
+      keyword: "type",
+      expected,
+      received: render(value),
+      message: `Parameter "${path}" must be of type ${expected}, received ${jsonTypeOf(value)} (${render(value)}).`
+    });
+    return;
+  }
+  if (hasOwn(schema, "const") && !jsonEquals(value, schema["const"])) {
+    const expected = renderJson(schema["const"]);
+    const received = renderJson(value);
+    issues.push({
+      path,
+      keyword: "const",
+      expected,
+      received,
+      message: `Parameter "${path}" must equal ${expected}, received ${received}.`
+    });
+    return;
+  }
+  const enumValues = schema["enum"];
+  if (Array.isArray(enumValues) && !enumValues.some((allowed) => jsonEquals(value, allowed))) {
+    const expected = enumValues.map((v) => renderJson(v)).join(", ");
+    const received = renderJson(value);
+    issues.push({
+      path,
+      keyword: "enum",
+      expected,
+      received,
+      message: `Parameter "${path}" must be one of [${expected}], received ${received}.`
+    });
+    return;
+  }
+  if (typeof value === "number") {
+    const min = schema["minimum"];
+    if (typeof min === "number" && value < min) {
+      issues.push({
+        path,
+        keyword: "minimum",
+        expected: `>= ${min}`,
+        received: render(value),
+        message: `Parameter "${path}" must be >= ${min}, received ${value}.`
+      });
+    }
+    const max = schema["maximum"];
+    if (typeof max === "number" && value > max) {
+      issues.push({
+        path,
+        keyword: "maximum",
+        expected: `<= ${max}`,
+        received: render(value),
+        message: `Parameter "${path}" must be <= ${max}, received ${value}.`
+      });
+    }
+  }
+  if (typeof value === "string") {
+    const minLength = schema["minLength"];
+    if (typeof minLength === "number" && value.length < minLength) {
+      issues.push({
+        path,
+        keyword: "minLength",
+        expected: `length >= ${minLength}`,
+        received: `length ${value.length}`,
+        message: `Parameter "${path}" must be at least ${minLength} characters, received ${value.length}.`
+      });
+    }
+    const maxLength = schema["maxLength"];
+    if (typeof maxLength === "number" && value.length > maxLength) {
+      issues.push({
+        path,
+        keyword: "maxLength",
+        expected: `length <= ${maxLength}`,
+        received: `length ${value.length}`,
+        message: `Parameter "${path}" must be at most ${maxLength} characters, received ${value.length}.`
+      });
+    }
+    const pattern = schema["pattern"];
+    if (typeof pattern === "string" && pattern.length <= MAX_PATTERN_LENGTH && !hasNestedQuantifiers(pattern)) {
+      let re;
+      try {
+        re = new RegExp(pattern);
+      } catch {
+        re = null;
+      }
+      if (re !== null && !re.test(value)) {
+        issues.push({
+          path,
+          keyword: "pattern",
+          expected: `match /${pattern}/`,
+          received: render(value),
+          message: `Parameter "${path}" must match /${pattern}/, received ${render(value)}.`
+        });
+      }
+    }
+  }
+  if (Array.isArray(value) && hasOwn(schema, "items")) {
+    const items = schema["items"];
+    value.forEach((element, index) => {
+      validateValue(element, items, `${path}[${index}]`, issues, depth + 1);
+    });
+  }
+  if (isPlainObject(value) && (isPlainObject(schema["properties"]) || hasOwn(schema, "required") || schema["additionalProperties"] === false)) {
+    validateObject(value, schema, path, issues, depth);
+  }
+}
+function validateObject(value, schema, basePath, issues, depth) {
+  if (depth > MAX_SCHEMA_DEPTH) return;
+  const properties = isPlainObject(schema["properties"]) ? schema["properties"] : {};
+  const requiredRaw = schema["required"];
+  const required = Array.isArray(requiredRaw) ? requiredRaw.filter((k) => typeof k === "string") : [];
+  for (const key of required) {
+    if (!hasOwn(value, key) || value[key] === void 0) {
+      const at = joinPath(basePath, key);
+      issues.push({
+        path: at,
+        keyword: "required",
+        expected: "present",
+        message: `Required parameter "${at}" is missing.`
+      });
+    }
+  }
+  if (schema["additionalProperties"] === false) {
+    const declared = new Set(Object.keys(properties));
+    const expected = declared.size === 0 ? "no parameters" : `one of [${[...declared].join(", ")}]`;
+    for (const key of Object.keys(value)) {
+      if (!declared.has(key)) {
+        const at = joinPath(basePath, key);
+        issues.push({
+          path: at,
+          keyword: "additionalProperties",
+          expected,
+          received: render(value[key]),
+          message: `Parameter "${at}" is not declared by the schema, which sets additionalProperties: false.`
+        });
+      }
+    }
+  }
+  for (const [key, propSchema] of Object.entries(properties)) {
+    if (!hasOwn(value, key) || value[key] === void 0) continue;
+    validateValue(value[key], propSchema, joinPath(basePath, key), issues, depth + 1);
+  }
+}
+function isObjectSchemaForm(schema) {
+  if (isPlainObject(schema["properties"])) return true;
+  if (schema["type"] !== "object") return false;
+  return Object.keys(schema).every((key) => OBJECT_SCHEMA_KEYWORDS.has(key));
+}
+function normalizeMapForm(schema) {
+  if (isObjectSchemaForm(schema)) return null;
+  const properties = {};
+  for (const [key, raw] of Object.entries(schema)) {
+    if (raw === null || raw === void 0) continue;
+    if (typeof raw === "string") {
+      properties[key] = PRIMITIVE_TYPE_NAMES.has(raw) ? { type: raw } : {};
+      continue;
+    }
+    if (isPlainObject(raw)) {
+      const { optional: _optional, ...rest } = raw;
+      properties[key] = rest;
+      continue;
+    }
+  }
+  return { type: "object", properties };
+}
+function validateActionParams(schema, params) {
+  if (!isPlainObject(schema)) return { valid: true, issues: [] };
+  const normalized = normalizeMapForm(schema) ?? schema;
+  const hasProperties = isPlainObject(normalized["properties"]);
+  const hasRequired = Array.isArray(normalized["required"]);
+  const forbidsExtras = normalized["additionalProperties"] === false;
+  if (!hasProperties && !hasRequired && !forbidsExtras) {
+    return { valid: true, issues: [] };
+  }
+  const issues = [];
+  if (params === void 0 || params === null) {
+    validateObject({}, normalized, "", issues, 0);
+    return { valid: issues.length === 0, issues };
+  }
+  if (!isPlainObject(params)) {
+    issues.push({
+      path: "",
+      keyword: "type",
+      expected: "object",
+      received: render(params),
+      message: `Action params must be an object, received ${jsonTypeOf(params)} (${render(params)}).`
+    });
+    return { valid: false, issues };
+  }
+  validateObject(params, normalized, "", issues, 0);
+  return { valid: issues.length === 0, issues };
+}
+function formatParamValidationFailure(componentId, actionId, issues) {
+  const detail = issues.map((i) => i.message).join(" ");
+  return `Action "${actionId}" on component "${componentId}" was rejected: params do not match the action's declared paramSchema. ${detail}`;
+}
+
 // src/control/action-executor.ts
 var DEFAULT_WAIT_OPTIONS = {
   visible: true,
@@ -16,6 +473,68 @@ var DEFAULT_WAIT_OPTIONS = {
   timeout: 1e4,
   interval: 100
 };
+var NativeActionError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "NativeActionError";
+  }
+};
+var DEFAULT_SCROLL_INTO_VIEW_PADDING = 16;
+var SCROLL_INTO_VIEW_MEASURE_TIMEOUT_MS = 1e3;
+var SCROLL_INTO_VIEW_WINDOW_MEASURE_TIMEOUT_MS = 250;
+function measurePageRectNow(element, preferred) {
+  const preferredNode = preferred;
+  const node = preferredNode && typeof preferredNode.measureInWindow === "function" ? preferredNode : element.ref.current;
+  if (!node || typeof node.measureInWindow !== "function") {
+    const state = element.getState();
+    return Promise.resolve(state.visible ? pageRectOf(state) : null);
+  }
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (rect) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(rect);
+    };
+    const timer = setTimeout(() => done(null), SCROLL_INTO_VIEW_WINDOW_MEASURE_TIMEOUT_MS);
+    try {
+      node.measureInWindow(
+        (x, y, w, h) => done(
+          [x, y, w, h].every(Number.isFinite) && w > 0 && h > 0 ? { left: x, top: y, right: x + w, bottom: y + h } : null
+        )
+      );
+    } catch {
+      done(null);
+    }
+  });
+}
+function resolveScrollView(current) {
+  const c = current;
+  if (!c) return null;
+  if (typeof c.scrollTo === "function")
+    return c;
+  for (const unwrap of [c.getNativeScrollRef, c.getScrollResponder]) {
+    if (typeof unwrap !== "function") continue;
+    let inner;
+    try {
+      inner = unwrap.call(c);
+    } catch {
+      inner = null;
+    }
+    if (inner && typeof inner.scrollTo === "function")
+      return inner;
+  }
+  return null;
+}
+function isDeclaredHorizontal(registeredProps, ...refs) {
+  if (registeredProps?.horizontal === true) return true;
+  return refs.some((r) => {
+    const props = r?.props;
+    return props !== null && typeof props === "object" && props.horizontal === true;
+  });
+}
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -135,6 +654,7 @@ var DefaultNativeActionExecutor = class {
       return {
         success: false,
         error: errorMsg,
+        ...error instanceof NativeActionError ? { code: error.code } : {},
         stack: error instanceof Error ? error.stack : void 0,
         durationMs: failTime - startTime,
         timestamp: failTime,
@@ -152,7 +672,7 @@ var DefaultNativeActionExecutor = class {
     }
     const props = element.props || {};
     if (element.customActions && action in element.customActions) {
-      return element.customActions[action].handler(params);
+      return element.customActions[action].handler(params, { signal: inertAbortSignal() });
     }
     switch (action) {
       case "click":
@@ -175,6 +695,11 @@ var DefaultNativeActionExecutor = class {
         return this.performBlur(element);
       case "scroll":
         return this.performScroll(props, params);
+      case "scrollIntoView":
+        return this.performScrollIntoView(
+          element,
+          params
+        );
       case "swipe":
         return this.performSwipe(props, params);
       case "toggle":
@@ -341,6 +866,138 @@ var DefaultNativeActionExecutor = class {
       props.onScroll(event);
     }
   }
+  /**
+   * Perform scrollIntoView: scroll the element's DECLARED scroll container so
+   * the element sits `padding` dp below the top of its viewport.
+   *
+   * The container comes from `scrollAncestorId` and nowhere else — the
+   * registry keeps no parent chain (`RegisterElementOptions.scrollAncestorId`),
+   * so there is no "nearest ScrollView" to find. Nothing here tracks a
+   * ScrollView's content offset either (`performScroll` only fakes an
+   * `onScroll` event), so the target is measured CONTENT-relative with
+   * `measureLayout` against the container's inner content view: stateless,
+   * and immune to a stale-offset race.
+   *
+   * Result shape mirrors the web executor's `scrollIntoView`
+   * (`@qontinui/ui-bridge` `control/action-executor.ts`):
+   * `{ alreadyVisible, scrolled }`, short-circuiting when the element is
+   * already fully inside its clip region. "Fully visible" is only claimed when
+   * it is MEASURED — a page-space rect for the element and a known,
+   * non-empty clip (window ∩ declared container), both measured at call
+   * time. Anything unknown scrolls.
+   *
+   * Containers: a ScrollView, or a VirtualizedList (FlatList / SectionList)
+   * unwrapped through `getNativeScrollRef()` / `getScrollResponder()`.
+   * Vertical only — a `horizontal` container is NOT_SUPPORTED. The action
+   * returns once `scrollTo` is dispatched; positions settle on the next frame.
+   *
+   * Prerequisites are checked BEFORE the visibility short-circuit, so whether
+   * the element supports the action does not depend on where it happens to be
+   * on screen. Each missing prerequisite is a `NOT_SUPPORTED` failure.
+   */
+  async performScrollIntoView(element, params) {
+    const padding = params?.padding ?? DEFAULT_SCROLL_INTO_VIEW_PADDING;
+    if (typeof padding !== "number" || !Number.isFinite(padding) || padding < 0) {
+      throw new Error('scrollIntoView "padding" must be a finite, non-negative number');
+    }
+    const ancestorId = element.scrollAncestorId;
+    if (!ancestorId) {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": it declares no scrollAncestorId, and the registry keeps no parent chain to find its scroll container from`,
+        "NOT_SUPPORTED"
+      );
+    }
+    const ancestor = ancestorId === element.id ? void 0 : this.registry.getElement(ancestorId);
+    if (!ancestor) {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": its declared scrollAncestorId "${ancestorId}" is not a registered element`,
+        "NOT_SUPPORTED"
+      );
+    }
+    const container = resolveScrollView(ancestor.ref.current);
+    if (!container) {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": its scroll ancestor "${ancestorId}" has no scrollTo (not a mounted ScrollView, and no getNativeScrollRef/getScrollResponder yielding one)`,
+        "NOT_SUPPORTED"
+      );
+    }
+    if (isDeclaredHorizontal(ancestor.props, ancestor.ref.current, container)) {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": its scroll ancestor "${ancestorId}" is horizontal (only vertical containers are supported)`,
+        "NOT_SUPPORTED"
+      );
+    }
+    const innerViewRef = container.getInnerViewRef?.();
+    const innerView = innerViewRef ?? container.getInnerViewNode?.();
+    const innerViewIsTag = innerViewRef == null && typeof innerView === "number";
+    if (innerView === void 0 || innerView === null) {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": its scroll ancestor "${ancestorId}" exposes no inner content view to measure against`,
+        "NOT_SUPPORTED"
+      );
+    }
+    const target = element.ref.current;
+    if (!target || typeof target.measureLayout !== "function") {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": its ref has no measureLayout (not a mounted host view)`,
+        "NOT_SUPPORTED"
+      );
+    }
+    const [rect, ancestorRect] = await Promise.all([
+      measurePageRectNow(element),
+      measurePageRectNow(ancestor, container)
+    ]);
+    const viewport = this.registry.getViewportRect();
+    const clip = ancestorRect ? intersectRects(viewport, ancestorRect) : null;
+    if (rect && clip && !isEmptyRect(clip) && rect.right > rect.left && rect.bottom > rect.top && rect.top >= clip.top && rect.left >= clip.left && rect.bottom <= clip.bottom && rect.right <= clip.right) {
+      return { alreadyVisible: true, scrolled: false };
+    }
+    const measured = await new Promise(
+      (resolve, reject) => {
+        let settled = false;
+        const timer = setTimeout(() => {
+          if (settled) return;
+          settled = true;
+          reject(
+            new Error(
+              `scrollIntoView: measureLayout did not call back within ${SCROLL_INTO_VIEW_MEASURE_TIMEOUT_MS}ms` + (innerViewIsTag ? " (measured against a numeric inner-view tag from getInnerViewNode, which the new architecture does not support)" : "")
+            )
+          );
+        }, SCROLL_INTO_VIEW_MEASURE_TIMEOUT_MS);
+        const finish = (fn) => {
+          if (settled) return;
+          settled = true;
+          clearTimeout(timer);
+          fn();
+        };
+        try {
+          target.measureLayout(
+            innerView,
+            (x, y, width) => finish(
+              () => Number.isFinite(y) ? resolve({ x, y, width }) : reject(new Error("scrollIntoView: measureLayout returned a non-finite y"))
+            ),
+            () => finish(
+              () => reject(
+                new Error(
+                  `scrollIntoView: measureLayout failed for "${element.id}" relative to "${ancestorId}"`
+                )
+              )
+            )
+          );
+        } catch (error) {
+          finish(() => reject(error));
+        }
+      }
+    );
+    if (ancestorRect && Number.isFinite(measured.x) && Number.isFinite(measured.width) && measured.x + measured.width > ancestorRect.right - ancestorRect.left + 1) {
+      throw new NativeActionError(
+        `scrollIntoView is not supported on element "${element.id}": it is laid out beyond the horizontal extent of its scroll ancestor "${ancestorId}" (sideways overflow, a horizontal container, or a nested horizontal container \u2014 declare that inner container as its scrollAncestorId); only vertical scrolling is supported`,
+        "NOT_SUPPORTED"
+      );
+    }
+    container.scrollTo({ y: Math.max(0, measured.y - padding), animated: false });
+    return { alreadyVisible: false, scrolled: true };
+  }
   /**
    * Perform swipe action
    */
@@ -395,7 +1052,7 @@ var DefaultNativeActionExecutor = class {
   /**
    * Execute a component action
    */
-  async executeComponentAction(componentId, request) {
+  async executeComponentAction(componentId, request, options = {}) {
     const startTime = Date.now();
     try {
       const component = this.registry.getComponent(componentId);
@@ -418,10 +1075,71 @@ var DefaultNativeActionExecutor = class {
           requestId: request.requestId
         };
       }
-      const result = await action.handler(request.params);
+      const timeout = normalizeActionTimeoutMs(request.timeoutMs);
+      if (!timeout.ok) {
+        return {
+          success: false,
+          error: `Action "${request.action}" on component "${componentId}" was rejected: ${timeout.reason}.`,
+          durationMs: Date.now() - startTime,
+          timestamp: Date.now(),
+          requestId: request.requestId
+        };
+      }
+      const timeoutMs = timeout.timeoutMs;
+      const validationMode = options.paramValidation ?? getDefaultParamValidationMode();
+      if (validationMode !== "off" && action.paramSchema !== void 0) {
+        let validation;
+        try {
+          validation = validateActionParams(action.paramSchema, request.params);
+        } catch (validatorFault) {
+          const detail = validatorFault instanceof Error ? validatorFault.message : String(validatorFault);
+          const faultMessage = `Action "${request.action}" on component "${componentId}": its declared paramSchema could not be evaluated (${detail}).`;
+          if (validationMode === "enforce") {
+            return {
+              success: false,
+              error: faultMessage,
+              durationMs: Date.now() - startTime,
+              timestamp: Date.now(),
+              requestId: request.requestId
+            };
+          }
+          console.warn(`[ui-bridge-native] ${faultMessage}`);
+          validation = { valid: true, issues: [] };
+        }
+        if (!validation.valid) {
+          const message = formatParamValidationFailure(
+            componentId,
+            request.action,
+            validation.issues
+          );
+          if (validationMode === "enforce") {
+            return {
+              success: false,
+              error: message,
+              durationMs: Date.now() - startTime,
+              timestamp: Date.now(),
+              requestId: request.requestId
+            };
+          }
+          console.warn(`[ui-bridge-native] ${message}`);
+        }
+      }
+      const outcome = await runAbortable((signal) => action.handler(request.params, { signal }), {
+        signal: options.signal,
+        timeoutMs
+      });
+      if (outcome.aborted) {
+        return {
+          success: false,
+          error: outcome.reason === "timeout" ? `Action "${request.action}" on component "${componentId}" was abandoned after its ${timeoutMs}ms timeout elapsed.` : `Action "${request.action}" on component "${componentId}" was cancelled by the caller's abort signal.`,
+          durationMs: Date.now() - startTime,
+          timestamp: Date.now(),
+          requestId: request.requestId
+        };
+      }
       return {
         success: true,
-        result,
+        result: outcome.result,
         durationMs: Date.now() - startTime,
         timestamp: Date.now(),
         requestId: request.requestId
@@ -543,6 +1261,7 @@ function createNativeActionExecutor(registry) {
 }
 
 exports.DefaultNativeActionExecutor = DefaultNativeActionExecutor;
+exports.NativeActionError = NativeActionError;
 exports.createNativeActionExecutor = createNativeActionExecutor;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map