-- SPDX-FileCopyrightText: 2026 Alexandra de Wit
--
-- SPDX-License-Identifier: MIT

-- | RubyGems ownership declarations use exact names and separator-delimited prefixes.
module Ecluse.Core.Registry.RubyGems.FirstParty (
    RubyGemsFirstParty,
    projectFirstPartyEntry,
    rubyGemsFirstPartyName,
    rubyGemsFirstPartyNames,
) where

import Ecluse.Core.Package (PackageName, renderPackageName)
import Ecluse.Core.Registry (ParseError)
import Ecluse.Core.Registry.FirstParty (FirstPartyEntry, FirstPartyGrammar (..), FirstPartyNames (..), ownsFirstPartyName, parseFirstPartyEntry)
import Ecluse.Core.Registry.RubyGems.Project (projectName, unscopedRubyGems)

-- | The tag that keeps RubyGems entries apart from another ecosystem's.
data RubyGemsNames

-- | An exact name or a prefix declared by the registry operator.
type RubyGemsFirstParty = FirstPartyEntry RubyGemsNames

-- Exact native spelling, a @-@, @_@ or @.@ before a prefix's @*@, and no foreign or scoped name.
rubyGemsFirstPartyGrammar :: FirstPartyGrammar RubyGemsNames
rubyGemsFirstPartyGrammar :: FirstPartyGrammar RubyGemsNames
rubyGemsFirstPartyGrammar =
    FirstPartyGrammar
        { fpLabel :: Text
fpLabel = Text
"RubyGems"
        , fpSeparator :: Char -> Bool
fpSeparator = (Char -> String -> Bool
forall (f :: * -> *) a.
(Foldable f, DisallowElem f, Eq a) =>
a -> f a -> Bool
`elem` [Char
'-', Char
'_', Char
'.'])
        , fpProjectName :: Text -> Either ParseError PackageName
fpProjectName = Text -> Either ParseError PackageName
projectName
        , fpOwnershipKey :: PackageName -> Maybe Text
fpOwnershipKey = \PackageName
name -> PackageName -> Text
renderPackageName PackageName
name Text -> Maybe () -> Maybe Text
forall a b. a -> Maybe b -> Maybe a
forall (f :: * -> *) a b. Functor f => a -> f b -> f a
<$ Bool -> Maybe ()
forall (f :: * -> *). Alternative f => Bool -> f ()
guard (PackageName -> Bool
unscopedRubyGems PackageName
name)
        }

-- | Parse an exact gem name or a prefix with a terminal separator followed by @*@.
projectFirstPartyEntry :: Text -> Either ParseError RubyGemsFirstParty
projectFirstPartyEntry :: Text -> Either ParseError RubyGemsFirstParty
projectFirstPartyEntry = FirstPartyGrammar RubyGemsNames
-> Text -> Either ParseError RubyGemsFirstParty
forall {k} (ecosystem :: k).
FirstPartyGrammar ecosystem
-> Text -> Either ParseError (FirstPartyEntry ecosystem)
parseFirstPartyEntry FirstPartyGrammar RubyGemsNames
rubyGemsFirstPartyGrammar

-- | Match exact native identities, excluding foreign ecosystems and npm scopes.
rubyGemsFirstPartyName :: NonEmpty RubyGemsFirstParty -> PackageName -> Bool
rubyGemsFirstPartyName :: NonEmpty RubyGemsFirstParty -> PackageName -> Bool
rubyGemsFirstPartyName = FirstPartyGrammar RubyGemsNames
-> NonEmpty RubyGemsFirstParty -> PackageName -> Bool
forall {k} (ecosystem :: k).
FirstPartyGrammar ecosystem
-> NonEmpty (FirstPartyEntry ecosystem) -> PackageName -> Bool
ownsFirstPartyName FirstPartyGrammar RubyGemsNames
rubyGemsFirstPartyGrammar

-- | Names and prefixes the mount's @firstParty@ entries declare.
rubyGemsFirstPartyNames :: FirstPartyNames RubyGemsFirstParty
rubyGemsFirstPartyNames :: FirstPartyNames RubyGemsFirstParty
rubyGemsFirstPartyNames =
    FirstPartyNames
        { namesEntry :: Text -> Either ParseError RubyGemsFirstParty
namesEntry = Text -> Either ParseError RubyGemsFirstParty
projectFirstPartyEntry
        , namesOwn :: NonEmpty RubyGemsFirstParty -> PackageName -> Bool
namesOwn = NonEmpty RubyGemsFirstParty -> PackageName -> Bool
rubyGemsFirstPartyName
        , namesEntryNoun :: Text
namesEntryNoun = Text
"RubyGems entry"
        , namesListNoun :: Text
namesListNoun = Text
"gem or prefix"
        }