add paper module

Author: InvalidJoker

README.md

@@ -1,38 +1 @@
-![Ascend Banner](https://user-images.githubusercontent.com/28064149/192885894-e412f3e6-9efe-4195-891e-7ba54f0edd7e.jpg)
-
-<br>
-
-## 🚀 Ascend: Elevating Your Coding Experience
-[![Build Library](https://github.com/TheFruxz/Ascend/actions/workflows/build-Ascend.yml/badge.svg)](https://github.com/TheFruxz/Ascend/actions/workflows/build-Ascend.yml)
-[![Publish Library](https://github.com/TheFruxz/Ascend/actions/workflows/publish-Ascend.yml/badge.svg)](https://github.com/TheFruxz/Ascend/actions/workflows/publish-Ascend.yml)
-
-Welcome to Ascend, your one-stop utility belt to supercharge your code.
-This toolkit is an ensemble of various nifty features and tools I've found essential for my projects.
-The design of these tools aims to be seamless, unobtrusive, and easily discoverable via code completions thanks to extensive use of extension functions.
-
-> "Ascend is reshaping the coding landscape with its powerful suite of tools and extensions. Effortless to incorporate, intuitive to use, and transformative in effect, Ascend is an indispensable companion for the modern developer. It's more than just a toolkit: it's the launchpad for turning your coding dreams into reality."
-~ JetBrains AI Assistant
-
-## 🔧 Setting the Stage - The Ascend Installation Guide
-
-Depending on the nature of your project, you may incorporate Ascend via `Gradle`, or `Maven`. However, we highly recommend `Gradle` for a streamlined experience.
-(Gradle standard was Groovy, now is Kotlin)
-
-### Use in your Gradle Project
-
-#### Repository
-```kotlin
-maven("https://nexus.fruxz.dev/repository/public/")
-```
-
-##### Dependency
-```kotlin
-implementation("dev.fruxz:ascend:$ascendVersion")
-```
-
-# 💡 Collaboration - Together We Ascend!
-
-Contribution to Ascend is deeply appreciated. When submitting pull requests, abide by the community guidelines of GitHub. Furthermore, respect licensing within this and all repositories you interact with. Feel free to initiate or engage in discussions in the repository's 'Discussions' section.
-
-###### We build & use Ascend on Java 21 - [Eclipse Temurin](https://adoptium.net/).
-###### Also build & run Ascend with [Eclipse Temurin](https://adoptium.net/) to get the best possible development experience!
+> WIP: But basicly, I imported https://github.com/TheFruxz/Ascend and split it up and added custom paper & adventure modules. Just don't use this just yet

adventure/src/extensions/ComponentExtensions.kt

@@ -5,6 +5,7 @@ import net.kyori.adventure.audience.Audience
 import net.kyori.adventure.text.Component
 import net.kyori.adventure.text.TextReplacementConfig
 import net.kyori.adventure.text.event.ClickEvent
+import net.kyori.adventure.text.format.NamedTextColor
 import net.kyori.adventure.text.minimessage.MiniMessage
 import net.kyori.adventure.text.minimessage.tag.resolver.TagResolver
 import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer
@@ -125,4 +126,13 @@ fun Component.legacy() = LegacyComponentSerializer.legacy('§').serialize(this)
  * @author Max Bossing
  * @since 0.0.1
  */
-fun Component.plain() = PlainTextComponentSerializer.plainText().serialize(this)
+fun Component.plain() = PlainTextComponentSerializer.plainText().serialize(this)
+
+/**
+ * Convert a [NamedTextColor] into a [Component] of that color
+ * @return A [Component] with the color of this [NamedTextColor]
+ * @author Max Bossing
+ * @since 0.0.1
+ */
+val NamedTextColor.component: Component
+    get() = Component.text("?").color(this).replaceLiteral("?", "")

adventure/src/extensions/ReplaceExtensions.kt

@@ -8,7 +8,7 @@ import java.util.regex.Pattern
 /**
  * Replaces all occurrences of the given [key] with the given [value]
  * and then returns the result component.
- * @param key The key to replace.
+ * @param key The regex to replace.
  * @param value The value to replace the key with.
  * @return The result component.
  * @author Fruxz
@@ -20,6 +20,21 @@ fun <T : Component> T.replace(@RegExp key: String, value: String): Component =
         it.replacement(value)
     }
 
+/**
+ * Replaces all occurrences of the given [key] with the given [value]
+ * and then returns the result component.
+ * @param key The key to replace.
+ * @param value The value to replace the key with.
+ * @return The result component.
+ * @author InvalidJoker
+ * @since 1.0
+ */
+fun <T : Component> T.replaceLiteral(key: String, value: String): Component =
+    replaceText {
+        it.matchLiteral(key)
+        it.replacement(value)
+    }
+
 /**
  * Replaces all occurrences of the given [key] with the given [value]
  * and then returns the result component.

build.gradle.kts

@@ -27,6 +27,7 @@ subprojects {
 
     repositories {
         mavenCentral()
+        maven("https://repo.papermc.io/repository/maven-public/")
     }
 
     java {

…/src/annotation/ExperimentalAscendApi.kt …re/src/annotation/ExperimentalGlueApi.ktcore/src/annotation/ExperimentalAscendApi.kt renamed to core/src/annotation/ExperimentalGlueApi.kt core/src/annotation/ExperimentalAscendApi.kt renamed to core/src/annotation/ExperimentalGlueApi.kt

@@ -11,4 +11,4 @@ package dev.fruxz.ascend.annotation
  **/
 @MustBeDocumented
 @RequiresOptIn("This is a experimental feature, proceed with caution!")
-annotation class ExperimentalAscendApi
+annotation class ExperimentalGlueApi

core/src/annotation/InternalGlueApi.kt

@@ -0,0 +1,14 @@
+package dev.fruxz.ascend.annotation
+
+/**
+ * Marks the annotated element as part of the internal Ascend API.
+ *
+ * This annotation should be used to indicate that the annotated element is internal
+ * and not intended for public use. It serves as a warning for developers to avoid
+ * using the element outside of the Ascend library.
+ * @author Fruxz
+ * @since 2023.1
+ **/
+@MustBeDocumented
+@RequiresOptIn("This is an internal feature, not intended for public use!")
+annotation class InternalGlueApi

core/src/extension/Developer.kt

@@ -128,3 +128,12 @@ inline fun <T> T?.ifNotNull(process: () -> Unit) = if (isNotNull) process() else
  * @since 2023.1
  */
 fun <T, D> Pair<T?, D>.asDefaultNullDodge() = first.isNull.switch(first, second)
+
+/**
+ * Returns true if this [T] is annotated with [Deprecated], otherwise false.
+ * @author InvalidJoker
+ */
+fun <T> T.isDeprecated(): Boolean {
+    val deprecatedAnnotation = this?.javaClass?.isAnnotationPresent(Deprecated::class.java)
+    return deprecatedAnnotation == true
+}

core/src/tool/exception/BaseException.kt

@@ -0,0 +1,17 @@
+package dev.fruxz.ascend.tool.exception
+
+import dev.fruxz.ascend.annotation.LanguageFeature
+
+/**
+ * Exception thrown when unreachable code is executed.
+ * @author InvalidJoker
+ */
+class UnreachableCodeException : IllegalStateException("This code should be unreachable!")
+
+/**
+ * Marks a code path as unreachable.
+ * @throws UnreachableCodeException always
+ * @author InvalidJoker
+ */
+@LanguageFeature
+fun unreachable(): Nothing = throw UnreachableCodeException()

ext-utils/src/tool/map/CollectionMap.kt

@@ -1,4 +1,4 @@
-package dev.fruxz.tool.map
+package dev.fruxz.ascend.tool.map
 
 /**
  * This class represents a map of collections of type [C].

ext-utils/src/tool/map/MutableCollectionMap.kt

@@ -1,4 +1,4 @@
-package dev.fruxz.tool.map
+package dev.fruxz.ascend.tool.map
 
 /**
  * This class represents a mutable map of collections of type [C].