phoenix_kit_publishing

defmodule PhoenixKitPublishing.MixProject do
  use Mix.Project

  @version "0.5.0"
  @source_url "https://github.com/BeamLabEU/phoenix_kit_publishing"

  def project do
    [
      app: :phoenix_kit_publishing,
      version: @version,
      elixir: "~> 1.18",
      elixirc_paths: elixirc_paths(Mix.env()),
      start_permanent: Mix.env() == :prod,
      deps: deps(),
      aliases: aliases(),

      # Hex
      description:
        "Publishing module for PhoenixKit — database-backed CMS with multi-language support",
      package: package(),

      # Dialyzer
      dialyzer: [plt_add_apps: [:phoenix_kit], ignore_warnings: ".dialyzer_ignore.exs"],

      # Test coverage — filter test-support modules out of `mix test --cover`
      # so the percentage reflects production code only.
      test_coverage: [
        ignore_modules: [
          ~r/^PhoenixKitPublishing\.Test\./,
          PhoenixKitPublishing.ConnCase,
          PhoenixKitPublishing.LiveCase,
          PhoenixKitPublishing.DataCase,
          PhoenixKitPublishing.PhoenixKitDataCase,
          PhoenixKitPublishing.ActivityLogAssertions,
          PhoenixKitPublishing.TestRepo
        ]
      ],

      # Docs
      name: "PhoenixKitPublishing",
      source_url: @source_url,
      docs: docs()
    ]
  end

  def application do
    [
      extra_applications: [:logger, :gettext]
    ]
  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",
        # Scan for retired Hex deps. Run via `cmd` so Hex bootstraps in a fresh
        # process — the hex.* archive tasks aren't resolvable via Mix.Task.run
        # inside an alias.
        "cmd mix hex.audit",
        "quality.ci"
      ]
    ]
  end

  # phoenix_kit deps resolve from Hex by default. For cross-repo work against a
  # local checkout, export <APP>_PATH — e.g. PHOENIX_KIT_PATH=../phoenix_kit or
  # PHOENIX_KIT_AI_PATH=../phoenix_kit_ai. Unset => the published pin, so
  # mix hex.publish is unaffected.
  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
    [
      # PhoenixKit provides the Module behaviour, Settings API, and core infrastructure.
      # 1.7.170 introduces PhoenixKit.Module.reserved_route_prefixes/0 +
      # ModuleRegistry.all_reserved_route_prefixes/0, which router_dispatch.ex
      # depends on (falls back to a runtime function_exported?/3 guard on an
      # older core, but the floor should track what's actually required).
      pk_dep(:phoenix_kit, "~> 2.0"),
      # PhoenixKitAI owns the generic AI-translation pipeline that this module's
      # `AITranslatable` adapter plugs into. 0.17 ships ai_multilang_tabs/1,
      # which the group editor imports directly.
      pk_dep(:phoenix_kit_ai, "~> 0.18"),
      # Test-only: exercises the OPTIONAL comments seam (public thread + POST
      # form). Production installs opt in by adding the package themselves —
      # publishing runs fine without it.
      {:phoenix_kit_comments, "~> 0.3", only: :test},

      # The post editor. Leaf is a standalone package (phoenix_kit depends on it
      # too, for the comment composer), so publishing declares it directly now
      # that the editor calls it. The 0.4.1 floor is load-bearing: inline
      # suggestions — the `{:leaf_suggest, …}` message, the `:suggestions`
      # command and the caret popup that `#hashtag` autocomplete rides on —
      # arrived in 0.4.0, and `:flush` lets a save collect the last keystrokes
      # instead of whatever the debounce had settled.
      #
      # The range is a FLOOR plus a major-ish ceiling, not `~> 0.4.1` — that
      # reads as `>= 0.4.1 and < 0.5.0`, which locked publishing out of leaf
      # 0.5 entirely. phoenix_kit core declares `~> 0.3`, so a host resolving
      # both got leaf 0.5.1 + publishing 0.4.4 and silently stayed a release
      # behind. 0.5 removed nothing publishing calls (its attr set is a strict
      # superset of 0.4.1's; the message contract only gained `:leaf_flushed`).
      {:leaf, "~> 0.4.1 or ~> 0.5"},

      # LiveView for admin pages
      {:phoenix_live_view, "~> 1.0"},

      # Markdown rendering (MDEx/comrak; also pulled in by phoenix_kit core)
      {:mdex, "~> 0.13"},

      # XML parsing for PHK page builder components
      {:saxy, "~> 1.5"},

      # Background jobs (translation worker, migration worker)
      {:oban, "~> 2.18"},

      # Own Gettext backend for admin/editor UI strings — priv/gettext catalogues.
      {:gettext, "~> 1.0"},

      # Optional rustler pin so the transitive `mdex_native` NIF can
      # source-build on hosts where its precompiled variant doesn't
      # match the local NIF version. Matches the parent app's pin.
      {:rustler, ">= 0.0.0", optional: true},

      # Code quality (dev/test only)
      {:ex_doc, "~> 0.34", only: :dev, runtime: false},
      {:credo, "~> 1.7", only: [:dev, :test], runtime: false},
      {:dialyxir, "~> 1.4", only: [:dev, :test], runtime: false},

      # LiveView test parser (test only)
      {:lazy_html, "~> 0.1", only: :test}
    ]
  end

  defp package do
    [
      licenses: ["MIT"],
      links: %{"GitHub" => @source_url},
      files: ~w(lib priv .formatter.exs mix.exs README.md CHANGELOG.md LICENSE)
    ]
  end

  defp docs do
    [
      main: "PhoenixKit.Modules.Publishing",
      source_ref: "v#{@version}",
      extras: ["phk-publishing-format.md"]
    ]
  end
end