Function ensureFocusContainerId

packages/core/src/runtime/commit/validation.ts:79–110

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

}

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

  const id = (vnode as { props: { id?: unknown } }).props.id;
  if (typeof id !== "string" || id.length === 0) {
    return {
      code: "ZRUI_INVALID_PROPS",
      detail: `focus container missing required id (kind=${vnode.kind}, instanceId=${String(instanceId)})`,
    };
  }
  if (id.trim().length === 0) {
    return {
      code: "ZRUI_INVALID_PROPS",
      detail: `focus container 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 focus container id "${id}". First: <${existing}>, second: <${vnode.kind}>. Hint: focusZone, focusTrap, and modal ids must be unique across the tree.`,
    };
  }

  seen.set(id, vnode.kind);
  return null;
}

export function isVNode(v: unknown): v is VNode {
  return typeof v === "object" && v !== null && "kind" in v;