phoenix_kit_boards

defmodule PhoenixKitBoards.MixProject do
  use Mix.Project

  @version "0.2.0"
  @source_url "https://github.com/BeamLabEU/phoenix_kit_boards"

  def project do
    [
      app: :phoenix_kit_boards,
      version: @version,
      elixir: "~> 1.18",
      elixirc_paths: elixirc_paths(Mix.env()),
      start_permanent: Mix.env() == :prod,
      deps: deps(),
      aliases: aliases(),
      description:
        "Collaborative infinite-canvas boards for PhoenixKit — create boards in the admin, draw/write/place images together in real time, persisted to the database.",
      package: package(),
      dialyzer: [plt_add_apps: [:phoenix_kit, :fresco, :etcher]],
      name: "PhoenixKitBoards",
      source_url: @source_url,
      docs: docs()
    ]
  end

  def application do
    # `:phoenix_kit` in extra_applications is REQUIRED for ModuleDiscovery to
    # find this module's `.beam` at host startup.
    [
      extra_applications: [:logger, :phoenix_kit]
    ]
  end

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

  defp aliases do
    [
      quality: ["format", "credo --strict", "dialyzer"],
      "quality.ci": ["format --check-formatted", "credo --strict", "dialyzer"],
      precommit: [
        "compile --force --warnings-as-errors",
        "deps.unlock --check-unused",
        "cmd mix hex.audit",
        "quality.ci"
      ]
    ]
  end

  # phoenix_kit resolves from Hex by default; export PHOENIX_KIT_PATH=../phoenix_kit
  # for cross-repo work against a local checkout. Unset => the published pin.
  defp pk_dep(app, requirement, opts \\ []) do
    env_var = String.upcase(Atom.to_string(app)) <> "_PATH"

    case System.get_env(env_var) do
      nil when opts == [] -> {app, requirement}
      nil -> {app, requirement, opts}
      path -> {app, [path: path, override: true] ++ opts}
    end
  end

  defp deps do
    [
      pk_dep(:phoenix_kit, "~> 1.7"),
      {:phoenix_live_view, "~> 1.1"},

      # The infinite-canvas engine + annotation layer. The host already loads
      # their JS + hooks (the media annotation feature), so these constraints
      # exist to agree with PhoenixKit core rather than to pull anything new.
      #
      # fresco matches core exactly. etcher is deliberately tighter than
      # core's `~> 0.9`: the collab hook calls `setImageUploader` and
      # `setLinkUnfurler`, which arrived in 0.10.0, and core's constraint
      # would resolve to 0.9.0 and leave both features silently degraded.
      # Narrower is still compatible — a two-part `~>` runs to the next
      # major, so core admits everything this asks for.
      pk_dep(:fresco, "~> 0.10"),
      pk_dep(:etcher, "~> 0.10"),

      # Link previews: fetch the page (req), read its OpenGraph tags (floki),
      # draw the card (open_fresco). open_fresco emits SVG by itself and
      # needs a rasterizer for PNG — the HOST supplies that, either the
      # `{:resvg, "~> 0.5"}` NIF or a resvg / rsvg-convert / magick binary on
      # PATH. Without one an unfurl fails and a pasted link stays text, so
      # this is a soft requirement rather than a dependency here.
      {:req, "~> 0.5"},
      {:floki, ">= 0.34.0"},
      pk_dep(:open_fresco, "~> 0.2"),
      {:ex_doc, "~> 0.34", only: :dev, runtime: false},
      {:credo, "~> 1.7", only: [:dev, :test], runtime: false},
      {:dialyxir, "~> 1.4", only: [:dev, :test], runtime: false},
      {:lazy_html, ">= 0.1.0", only: :test}
    ]
  end

  defp package do
    [
      licenses: ["MIT"],
      links: %{"GitHub" => @source_url},
      # priv/ ships the collab JS hook bundle (declared via js_sources/0).
      files: ~w(lib priv .formatter.exs mix.exs README.md CHANGELOG.md LICENSE)
    ]
  end

  defp docs do
    [
      main: "PhoenixKitBoards",
      # Tags in this repo are v-prefixed (`git tag -a v0.1.0`), matching phoenix_kit
      # core and the rest of the umbrella. Tagging a bare version number instead
      # would 404 every HexDocs source link — keep the two in step.
      source_ref: "v#{@version}"
    ]
  end
end