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

-- | Cargo ownership declarations use native collision keys and separator-delimited prefixes.
module Ecluse.Core.Registry.Cargo.FirstParty (
    CargoFirstParty,
    projectFirstPartyEntry,
    cargoFirstPartyName,
    cargoFirstPartyNames,
) where

import Ecluse.Core.Package (PackageName)
import Ecluse.Core.Registry (ParseError)
import Ecluse.Core.Registry.Cargo.Project (cargoCollisionKey, projectName)
import Ecluse.Core.Registry.FirstParty (FirstPartyEntry, FirstPartyGrammar (..), FirstPartyNames (..), ownsFirstPartyName, parseFirstPartyEntry)

-- | The tag that keeps Cargo entries apart from other ecosystems'. It has no values.
data CargoNames

-- | An exact crate name or a native collision prefix declared by the registry operator.
type CargoFirstParty = FirstPartyEntry CargoNames

-- | Prefixes end in a hyphen or underscore, and names compare by their collision key.
cargoFirstPartyGrammar :: FirstPartyGrammar CargoNames
cargoFirstPartyGrammar :: FirstPartyGrammar CargoNames
cargoFirstPartyGrammar =
    FirstPartyGrammar
        { fpLabel :: Text
fpLabel = Text
"Cargo"
        , fpSeparator :: Char -> Bool
fpSeparator = \Char
c -> Char
c Char -> Char -> Bool
forall a. Eq a => a -> a -> Bool
== Char
'-' Bool -> Bool -> Bool
|| Char
c Char -> Char -> Bool
forall a. Eq a => a -> a -> Bool
== Char
'_'
        , fpProjectName :: Text -> Either ParseError PackageName
fpProjectName = Text -> Either ParseError PackageName
projectName
        , fpOwnershipKey :: PackageName -> Maybe Text
fpOwnershipKey = PackageName -> Maybe Text
cargoCollisionKey
        }

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

-- | Match native ownership aliases, excluding foreign ecosystems and npm scopes.
cargoFirstPartyName :: NonEmpty CargoFirstParty -> PackageName -> Bool
cargoFirstPartyName :: NonEmpty CargoFirstParty -> PackageName -> Bool
cargoFirstPartyName = FirstPartyGrammar CargoNames
-> NonEmpty CargoFirstParty -> PackageName -> Bool
forall {k} (ecosystem :: k).
FirstPartyGrammar ecosystem
-> NonEmpty (FirstPartyEntry ecosystem) -> PackageName -> Bool
ownsFirstPartyName FirstPartyGrammar CargoNames
cargoFirstPartyGrammar

-- | Names and prefixes the mount's @firstParty@ entries declare.
cargoFirstPartyNames :: FirstPartyNames CargoFirstParty
cargoFirstPartyNames :: FirstPartyNames CargoFirstParty
cargoFirstPartyNames =
    FirstPartyNames
        { namesEntry :: Text -> Either ParseError CargoFirstParty
namesEntry = Text -> Either ParseError CargoFirstParty
projectFirstPartyEntry
        , namesOwn :: NonEmpty CargoFirstParty -> PackageName -> Bool
namesOwn = NonEmpty CargoFirstParty -> PackageName -> Bool
cargoFirstPartyName
        , namesEntryNoun :: Text
namesEntryNoun = Text
"Cargo entry"
        , namesListNoun :: Text
namesListNoun = Text
"crate or prefix"
        }