using System.Collections.Generic;
using System.Numerics;
using DatReaderWriter.Enums;

namespace AcDream.Core.Physics;

/// <summary>
/// Indoor walking Phase 2 (2026-05-19). Cached building portal data
/// for outdoor→indoor cell entry. One per outdoor landcell that contains
/// a building stab. Mirrors retail's <c>BuildingObj.Portals</c> array
/// (per the pseudocode doc §"LandCell.find_transit_cells").
/// </summary>
public sealed class BuildingPhysics
{
    public required Matrix4x4 WorldTransform { get; init; }
    public required Matrix4x4 InverseWorldTransform { get; init; }
    public required IReadOnlyList<BldPortalInfo> Portals { get; init; }
}

/// <summary>
/// One building portal: the connection from a SortCell's BuildingObj to
/// an interior EnvCell. ExactMatch is decoded from <see cref="Flags"/>
/// bit 0 (<c>PortalFlags.ExactMatch = 0x0001</c>).
/// </summary>
public readonly struct BldPortalInfo
{
    public BldPortalInfo(uint otherCellId, ushort otherPortalId, ushort flags)
    {
        OtherCellId   = otherCellId;
        OtherPortalId = otherPortalId;
        Flags         = flags;
    }

    /// <summary>Full id of the interior EnvCell this portal connects to.</summary>
    public uint   OtherCellId   { get; }
    /// <summary>The portal id within the destination EnvCell.</summary>
    public ushort OtherPortalId { get; }
    public ushort Flags         { get; }

    /// <summary>
    /// Bit 0 of <see cref="Flags"/> (<c>DatReaderWriter.Enums.PortalFlags.ExactMatch</c>).
    ///
    /// <para>
    /// Reserved per retail's <c>CBldPortal::exact_match</c>. NOT currently
    /// consumed by <see cref="CellTransit.CheckBuildingTransit"/> — every
    /// portal overlap is treated as a valid entry trigger. If a future
    /// regression surfaces (e.g., a building entered by overlapping a
    /// non-exact-match portal), wire this into the entry test.
    /// </para>
    /// </summary>
    public bool ExactMatch => (Flags & (ushort)PortalFlags.ExactMatch) != 0;
}