finitomata

defmodule Finitomata.MixProject do
  use Mix.Project

  major = System.otp_release()

  otp_version =
    try do
      {:ok, contents} = File.read(Path.join([:code.root_dir(), "releases", major, "OTP_VERSION"]))
      String.split(contents, "\n", trim: true)
    else
      [full] -> full
      _ -> major
    catch
      :error, _ -> major
    end
    |> String.split("-")
    |> hd()
    |> String.split(".")
    |> case do
      [major] -> [major, 0, 0]
      [major, minor] -> [major, minor, 0]
      [major, minor, patch | _] -> [major, minor, patch]
    end
    |> Enum.join(".")

  @modern_libs if Version.compare(otp_version, "25.1.0") == :lt,
                 do: [],
                 else: [{:enfiladex, "~> 0.1", only: [:dev, :test, :finitomata]}]

  @app :finitomata
  @version "0.43.0"

  def lib?(lib), do: lib in Enum.map(@modern_libs, &elem(&1, 0))

  def project do
    [
      app: @app,
      name: "Finitomata",
      version: @version,
      elixir: "~> 1.14",
      compilers: compilers(Mix.env()),
      elixirc_paths: elixirc_paths(Mix.env()),
      prune_code_paths: Mix.env() == :prod,
      consolidate_protocols: Mix.env() not in [:dev, :test],
      description: description(),
      package: package(),
      deps: deps(),
      aliases: aliases(),
      xref: [exclude: []],
      docs: docs(),
      # elixirc_options: [debug_info: Mix.env() in [:dev, :test, :ci]],
      releases: [],
      dialyzer: [
        plt_file: {:no_warn, ".dialyzer/dialyzer.plt"},
        plt_add_deps: :app_tree,
        plt_add_apps: [:mix],
        list_unused_filters: true,
        ignore_warnings: ".dialyzer/ignore.exs"
      ],
      # `--cover` is informational: the test suites are split (standard, distributed,
      #   `:finitomata`, examples) and each exercises different code paths, so a single
      #   run must not gate on the partial number. Raise the `summary` threshold only with
      #   cross-suite aggregation.
      test_coverage: [summary: [threshold: 0]]
    ]
  end

  def application do
    [
      mod: {Finitomata.Application, []},
      extra_applications: [:logger]
    ]
  end

  def cli do
    [preferred_envs: ["enfiladex.suite": :test]]
  end

  defp deps do
    [
      # core
      {:nimble_parsec, "~> 1.0"},
      {:nimble_options, "~> 0.3 or ~> 1.0"},
      {:gen_stage, "~> 1.0"},
      {:estructura, "~> 1.6"},
      # optional
      {:telemetry, "~> 1.0", optional: true},
      {:telemetry_poller, "~> 1.0", optional: true},
      {:telemetria, "~> 0.21", optional: true},
      # dev / test
      {:nimble_ownership, "~> 1.0", only: [:dev, :test, :ci, :finitomata]},
      {:mox, "~> 1.2", only: [:dev, :test, :ci, :finitomata]},
      {:stream_data, "~> 1.0", only: [:dev, :test, :finitomata, :ci]},
      {:observer_cli, "~> 1.5", only: [:dev]},
      {:credo, "~> 1.0", only: [:dev, :ci]},
      {:dialyxir, "~> 1.0", only: [:dev, :ci], runtime: false},
      {:ex_doc, "~> 0.11", only: [:dev]}
    ] ++ @modern_libs
  end

  defp aliases do
    [
      test: ["test --exclude distributed", "test --exclude test --include distributed"],
      quality: ["format", "credo --strict", "dialyzer --unmatched_returns"],
      "quality.ci": [
        "format --check-formatted",
        "credo --strict",
        "dialyzer --unmatched_returns"
      ]
    ]
  end

  defp description do
    """
    The FSM implementation generated from PlantUML textual representation.
    """
  end

  defp package do
    [
      name: @app,
      files: ~w|stuff lib mix.exs README.md LICENSE .formatter.exs|,
      maintainers: ["Aleksei Matiushkin"],
      licenses: ["MIT"],
      links: %{
        "GitHub" => "https://github.com/am-kantox/#{@app}",
        "Docs" => "https://hexdocs.pm/#{@app}"
      }
    ]
  end

  defp docs do
    [
      main: "readme",
      source_ref: "v#{@version}",
      canonical: "http://hexdocs.pm/#{@app}",
      logo: "stuff/#{@app}-48x48.png",
      source_url: "https://github.com/am-kantox/#{@app}",
      assets: %{"stuff/images" => "assets"},
      extras: ~w[README.md stuff/fsm.md stuff/compiler.md stuff/cheatsheet.md],
      # These modules/functions are intentionally `@moduledoc false`/`@doc false` yet are
      #   referenced by name in the docs; skip autolinking to avoid "references ... but it is
      #   hidden" warnings from `mix docs` while keeping the inline monospace text.
      skip_code_autolink_to: [
        "Finitomata.Engine",
        "Finitomata.ConfigBuilder",
        "Finitomata.StateCache",
        "Finitomata.timer_tick/2",
        "Finitomata.ExUnit.refute_receive_timeout/0"
      ],
      groups_for_modules: [
        FSM: [Finitomata, Infinitomata, Finitomata.Flow, Finitomata.Error],
        Test: [Finitomata.ExUnit, Finitomata.ExUnit.Listener],
        Goods: [Finitomata.Throttler, Finitomata.Pool, Finitomata.Cache, Finitomata.Accessible],
        Internals: [
          Finitomata.Listener,
          Finitomata.ClusterInfo,
          Finitomata.Parser,
          Finitomata.Pool.Actor,
          Finitomata.Supervisor,
          Finitomata.State,
          Finitomata.Transition,
          Finitomata.Transition.Path
        ],
        Persistence: [
          Finitomata.Persistency,
          Finitomata.Persistency.ETS,
          Finitomata.Persistency.DETS,
          Finitomata.Persistency.Persistable,
          Finitomata.Persistency.Protocol
        ]
      ],
      before_closing_body_tag: &before_closing_body_tag/1
    ]
  end

  defp compilers(_), do: Mix.compilers() ++ [:finitomata]

  defp elixirc_paths(:test), do: ["lib", "test/support"]
  defp elixirc_paths(:finitomata), do: ["lib", "test/support"]
  defp elixirc_paths(:ci), do: ["lib"]
  defp elixirc_paths(:dev), do: ["lib", "test/support"]
  defp elixirc_paths(_), do: ["lib"]

  defp before_closing_body_tag(:html) do
    """
    <script defer src="https://cdn.jsdelivr.net/npm/mermaid@10.2.3/dist/mermaid.min.js"></script>
    <script>
      let initialized = false;

      window.addEventListener("exdoc:loaded", () => {
        if (!initialized) {
          mermaid.initialize({
            startOnLoad: false,
            theme: document.body.className.includes("dark") ? "dark" : "default"
          });
          initialized = true;
        }

        let id = 0;
        for (const codeEl of document.querySelectorAll("pre code.mermaid")) {
          const preEl = codeEl.parentElement;
          const graphDefinition = codeEl.textContent;
          const graphEl = document.createElement("div");
          const graphId = "mermaid-graph-" + id++;
          mermaid.render(graphId, graphDefinition).then(({svg, bindFunctions}) => {
            graphEl.innerHTML = svg;
            bindFunctions?.(graphEl);
            preEl.insertAdjacentElement("afterend", graphEl);
            preEl.remove();
          });
        }
      });
    </script>
    """
  end

  defp before_closing_body_tag(_), do: ""
end