crosswake

defmodule Crosswake.MixProject do
  use Mix.Project

  @version "0.2.0" # x-release-please-version
  @source_url "https://github.com/szTheory/crosswake"

  def project do
    [
      app: :crosswake,
      version: @version,
      name: "crosswake",
      elixir: "~> 1.19",
      elixirc_paths: elixirc_paths(Mix.env()),
      start_permanent: Mix.env() == :prod,
      deps: deps(),
      aliases: aliases(),
      description: description(),
      source_url: @source_url,
      homepage_url: @source_url,
      package: package(),
      docs: docs()
    ]
  end

  def application do
    [
      extra_applications: [:logger]
    ]
  end

  # Shared test fixtures (test/support/*.ex) are compiled once as project
  # modules in the test env, instead of being loaded per-file via
  # Code.require_file/2. The latter races during parallel test compilation —
  # multiple test files requiring the same fixture concurrently intermittently
  # fails with {:error, :enoent}.
  defp elixirc_paths(:test), do: ["lib", "test/support"]
  defp elixirc_paths(_), do: ["lib"]

  defp deps do
    # D-21: No companion-conditional dep blocks. Core names no companion in any env.
    # The conditional env-hack blocks were deleted in Phase 130 — companions now live
    # as standalone Hex packages (crosswake_rulestead in Phase 130, crosswake_rindle in
    # Phase 132, crosswake_sigra in Phase 137, crosswake_chimeway in Phase 138). Their
    # dependencies are declared in the companion's own mix.exs. The dress-rehearsal for
    # each companion runs via `mix companions.test` alias (runs each package's own test
    # lane separately).
    [
      {:jason, "~> 1.4"},
      {:nimble_options, "~> 1.1"},
      {:phoenix, "~> 1.8"},
      {:phoenix_live_view, "~> 1.1"},
      {:telemetry, "~> 1.0"},
      {:ex_doc, "~> 0.38", only: :dev, runtime: false}
    ]
  end

  # D-26: Root aliases so contributors never need a bare `cd`.
  # mix companions.test — runs each companion's own test lane (rulestead + rindle + sigra + chimeway + threadline).
  #   Each lane's default tag exclusions apply (engine-present advisory + example-host
  #   tests are excluded). Adapter-behavior tests run with the engine in the lane's lock.
  # mix verify — runs companions.test + core hermetic test lane (excludes advisory tags).
  defp aliases do
    [
      "companions.test": [
        # deps.get each package first so the alias is self-sufficient on a fresh checkout
        # (the lanes only fetch one package's deps; `mix test` does not auto-fetch).
        "cmd --cd packages/crosswake_rulestead mix deps.get",
        "cmd --cd packages/crosswake_rulestead mix test",
        "cmd --cd packages/crosswake_rindle mix deps.get",
        "cmd --cd packages/crosswake_rindle mix test",
        "cmd --cd packages/crosswake_sigra mix deps.get",
        "cmd --cd packages/crosswake_sigra mix test",
        "cmd --cd packages/crosswake_chimeway mix deps.get",
        "cmd --cd packages/crosswake_chimeway mix test",
        "cmd --cd packages/crosswake_threadline mix deps.get",
        "cmd --cd packages/crosswake_threadline mix test"
      ],
      verify: [
        "companions.test",
        "test --exclude requires_example_host --exclude advisory_only"
      ]
    ]
  end

  defp description do
    "Route policy and runtime contracts for Phoenix apps that go mobile."
  end

  defp package do
    [
      name: "crosswake",
      licenses: ["Apache-2.0"],
      links: %{
        "Changelog" => "#{@source_url}/blob/main/CHANGELOG.md",
        "Documentation" => "https://hexdocs.pm/crosswake",
        "GitHub" => @source_url
      },
      files: ~w(lib priv mix.exs README.md LICENSE CHANGELOG.md guides),
      exclude_patterns: ["brandbook"]
    ]
  end

  defp docs do
    [
      logo: "brandbook/logo/crosswake-mark.svg",
      main: "readme",
      source_ref: "v#{@version}",
      source_url: @source_url,
      formatters: ["html"],
      extras: [
        "README.md",
        "guides/see_it_run.md",
        "CHANGELOG.md",
        "LICENSE",
        "guides/install.md",
        "guides/route_policy.md",
        "guides/web_to_mobile_migration.md",
        "guides/troubleshooting.md",
        "guides/support_matrix.md",
        "guides/adopter_profiles.md",
        "guides/adoption.md",
        "guides/user_flows.md",
        "guides/capabilities.md",
        "guides/bridge.md",
        "guides/offline.md",
        "guides/tokens.md",
        "guides/commerce.md",
        "guides/companions.md",
        "guides/companion_contract.md",
        "guides/companion_compatibility.md",
        "guides/compatibility.md",
        "guides/native_shell.md",
        "guides/native_shell_upgrade.md",
        "guides/android_uat.md",
        "guides/packs.md",
        "guides/threadline.md",
        "guides/telemetry.md"
      ],
      groups_for_modules: [
        Policy: [Crosswake.Policy, Crosswake.Router],
        Bridge: ~r/Crosswake\.Bridge(\.|$)/,
        Manifest: [Crosswake.Manifest],
        Capabilities: ~r/Crosswake\.(Commerce|Offline|Packs)/,
        "Companion Contract": [
          Crosswake.Companion,
          Crosswake.Companion.State,
          Crosswake.Compatibility.Finding,
          Crosswake.Compatibility.Target,
          Crosswake.Manifest.Types.RouteEntry
        ],
        "Telemetry": [
          Crosswake.Telemetry,
          Crosswake.Offline.Telemetry
        ]
      ],
      groups_for_extras: [
        Start: [
          "README.md",
          "guides/see_it_run.md",
          "guides/route_policy.md",
          "guides/install.md"
        ],
        Adopt: [
          "guides/web_to_mobile_migration.md",
          "guides/user_flows.md",
          "guides/adopter_profiles.md",
          "guides/adoption.md"
        ],
        "Runtime Owners": [
          "guides/native_shell.md",
          "guides/bridge.md",
          "guides/capabilities.md",
          "guides/offline.md",
          "guides/packs.md",
          "guides/tokens.md",
          "guides/commerce.md"
        ],
        Truth: [
          "guides/troubleshooting.md",
          "guides/support_matrix.md",
          "guides/compatibility.md",
          "guides/android_uat.md"
        ],
        "Telemetry": [
          "guides/telemetry.md"
        ],
        "Extension Authors": [
          "guides/companion_contract.md",
          "guides/companion_compatibility.md"
        ],
        "Advanced/Companions": [
          "guides/companions.md",
          "guides/threadline.md",
          "CHANGELOG.md",
          "LICENSE"
        ]
      ]
    ]
  end
end