ash_phoenix_gen_api

defmodule AshPhoenixGenApi.MixProject do
  use Mix.Project

  @description """
  Ash extension for generating function configurations for PhoenixGenApi framework from Ash resources.
  """

  @version "1.4.0"

  def project do
    [
      app: :ash_phoenix_gen_api,
      version: @version,
      description: @description,
      elixir: "~> 1.18",
      start_permanent: Mix.env() == :prod,
      deps: deps(),
      elixirc_paths: elixirc_paths(Mix.env()),
      test_elixirc_options: [debug_info: true],
      aliases: aliases(),
      docs: &docs/0,
      package: package(),
      test_coverage: [
        # Compile-time-only modules (macros, protocol impls for test fixtures)
        # have no meaningful runtime coverage.
        ignore_modules: [
          ~r/^Inspect\.AshPhoenixGenApi\./,
          # Compile-time-only macro module
          AshPhoenixGenApi.Resource.EffectiveField,
          # Spark DSL schema/entity modules — dominated by framework-injected code
          AshPhoenixGenApi.Resource.GenApi.Action,
          AshPhoenixGenApi.Resource.GenApi.Mfa,
          AshPhoenixGenApi.Resource.GenApi.Options,
          AshPhoenixGenApi.Domain.GenApi.Options,
          # DSL fixtures whose executable content is entirely compile-time
          AshPhoenixGenApi.InfoFixtures.PlainDomain,
          AshPhoenixGenApi.InfoFixtures.DisabledSupporterDomain,
          AshPhoenixGenApi.InfoFixtures.EmptyGenApiResource,
          AshPhoenixGenApi.InfoFixtures.MfaWithCallbackResource,
          AshPhoenixGenApi.InfoFixtures.Hooks,
          AshPhoenixGenApi.InfoFixtures.AcceptListResource
        ],
        summary: [threshold: 88]
      ],
      source_url: "https://github.com/ohhi-vn/ash_phoenix_gen_api",
      homepage_url: "https://github.com/ohhi-vn/ash_phoenix_gen_api",
      usage_rules: usage_rules(),
      consolidate_protocols: Mix.env() not in [:dev, :test]
    ]
  end

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

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

  defp deps do
    [
      {:ash, ash_version("~> 3.32")},
      {:spark, "~> 2.7"},
      {:phoenix_gen_api, "~> 2.24"},
      # Dev/Test
      {:igniter, "~> 0.7", only: [:dev, :test], runtime: false},
      {:ex_doc, "~> 0.40", only: [:dev, :test], runtime: false},
      {:ex_check, "~> 0.16", only: [:dev, :test]},
      {:credo, ">= 0.0.0", only: [:dev, :test], runtime: false},
      {:dialyxir, ">= 0.0.0", only: [:dev, :test], runtime: false},
      {:mix_test_watch, "~> 1.0", only: [:dev, :test]},
      {:simple_sat, "~> 0.1", only: [:dev, :test]},
      {:usage_rules, "~> 1.2", only: [:dev]},
      {:excoveralls, "~> 0.18", only: :test}
    ]
  end

  defp ash_version(default_version) do
    case System.get_env("ASH_VERSION") do
      nil -> default_version
      "local" -> [path: "../ash"]
      "main" -> [git: "https://github.com/ash-project/ash.git"]
      version -> "~> #{version}"
    end
  end

  defp package do
    [
      maintainers: ["Manh Vu"],
      licenses: ["MPL-2.0"],
      files: ~w(lib .formatter.exs mix.exs README* LICENSE* CHANGELOG*),
      links: %{
        "GitHub" => "https://github.com/ohhi-vn/ash_phoenix_gen_api",
        "PhoenixGenApi" => "https://github.com/ohhi-vn/phoenix_gen_api",
        "Ash Framework" => "https://ash-hq.org"
      }
    ]
  end

  defp docs do
    [
      main: "readme",
      source_ref: "v#{@version}",
      extras: [
        {"README.md", title: "Home"},
        {"documentation/tutorials/getting-started.md", title: "Getting Started"},
        {"documentation/dsls/DSL-AshPhoenixGenApi.Resource.md",
         search_data: Spark.Docs.search_data_for(AshPhoenixGenApi.Resource)},
        {"documentation/dsls/DSL-AshPhoenixGenApi.Domain.md",
         search_data: Spark.Docs.search_data_for(AshPhoenixGenApi.Domain)}
      ],
      groups_for_extras: [
        Tutorials: ~r'documentation/tutorials',
        Reference: ~r"documentation/dsls"
      ],
      groups_for_modules: [
        Extensions: [
          AshPhoenixGenApi.Resource,
          AshPhoenixGenApi.Resource.ActionConfig,
          AshPhoenixGenApi.Resource.MfaConfig,
          AshPhoenixGenApi.Domain
        ],
        "Shared Internals": [
          AshPhoenixGenApi.Resource.SharedTypes,
          AshPhoenixGenApi.Resource.EffectiveField
        ],
        Introspection: [
          AshPhoenixGenApi.Resource.Info,
          AshPhoenixGenApi.Domain.Info
        ],
        Transformers: [
          AshPhoenixGenApi.Transformers.DefineFunConfigs,
          AshPhoenixGenApi.Transformers.DefineDomainSupporter
        ],
        "Type Mapping": [
          AshPhoenixGenApi.TypeMapper
        ],
        Utilities: [
          AshPhoenixGenApi.Codec,
          AshPhoenixGenApi.JsonConfig
        ]
      ]
    ]
  end

  defp aliases do
    [
      docs: [
        "spark.cheat_sheets",
        "docs",
        "spark.replace_doc_links"
      ],
      "spark.formatter":
        "spark.formatter --extensions AshPhoenixGenApi.Resource,AshPhoenixGenApi.Domain",
      "spark.cheat_sheets":
        "spark.cheat_sheets --extensions AshPhoenixGenApi.Resource,AshPhoenixGenApi.Domain",
      "spark.cheat_sheets_in_search":
        "spark.cheat_sheets_in_search --extensions AshPhoenixGenApi.Resource,AshPhoenixGenApi.Domain",
      # Testing & Coverage
      coveralls: ["test --cover", "coveralls.html"],
      # Code Quality
      quality: ["format --check-formatted", "credo --strict", "dialyzer"]
    ]
  end

  defp usage_rules do
    # Example for those using claude.
    [
      file: "CLAUDE.md",
      # :usage_rules itself provides rules for search_docs, docs, etc.
      # use a regex to match multiple deps, or atoms/strings for specific ones
      # If your CLAUDE.md is getting too big, link instead of inlining:
      usage_rules: [:ash, {~r/^ash_/, link: :markdown}],
      # or use skills
      skills: [
        location: ".claude/skills",
        # build skills that combine multiple usage rules
        build: [
          "ash-framework": [
            # The description tells people how to use this skill.
            description:
              "Use this skill working with Ash Framework or any of its extensions. Always consult this when making any domain changes, features or fixes.",
            # Include all Ash dependencies
            usage_rules: [:ash, ~r/^ash_/]
          ]
        ]
      ]
    ]
  end
end