Function ensureInteractiveId

packages/core/src/runtime/commit/validation.ts:37–73

(
  seen: Map<string, string>,
  instanceId: InstanceId,
  vnode: VNode,
)

}

export function ensureInteractiveId(
  seen: Map<string, string>,
  instanceId: InstanceId,
  vnode: VNode,
): CommitFatal | null {
  if (!isInteractiveVNode(vnode)) return null;

  const id = (vnode as { props: { id?: unknown } }).props.id;
  if (typeof id !== "string" || id.length === 0) {
    if (!kindRequiresId(vnode.kind)) return null;
    return {
      code: "ZRUI_INVALID_PROPS",
      detail: `interactive node missing required id (kind=${vnode.kind}, instanceId=${String(instanceId)})`,
    };
  }
  if (id.trim().length === 0) {
    return {
      code: "ZRUI_INVALID_PROPS",
      detail: `interactive node id must contain non-whitespace characters (kind=${vnode.kind}, instanceId=${String(instanceId)})`,
    };
  }

  const existing = seen.get(id);
  if (existing !== undefined) {
    return {
      code: "ZRUI_DUPLICATE_ID",
      detail: `Duplicate interactive widget id "${id}". First: <${existing}>, second: <${vnode.kind}>. Hint: Use ctx.id() inside defineWidget to generate unique IDs for list items.`,
    };
  }
  if (DEV_MODE && id.length > MAX_INTERACTIVE_ID_LENGTH) {
    warnDev(
      `[rezi][commit] interactive widget id exceeds ${String(MAX_INTERACTIVE_ID_LENGTH)} chars (kind=${vnode.kind}, id length=${String(id.length)}). Consider using shorter IDs.`,
    );
  }
  seen.set(id, vnode.kind);
  return null;
}

export function isFocusContainerVNode(vnode: VNode): vnode is VNode & { kind: FocusContainerKind } {
  return vnode.kind === "focusZone" || vnode.kind === "focusTrap" || vnode.kind === "modal";