diff --git a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/ClientDataSpec.kt b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/ClientDataSpec.kt index 2185c3069..efad970a4 100644 --- a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/ClientDataSpec.kt +++ b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/ClientDataSpec.kt @@ -15,7 +15,7 @@ import kotlin.reflect.KClass /** * Client-side mirror of a [DataSpec], built lazily as [DataSpec.client]. Every `boolean`/ - * `int`/... method here is called by its [DataSpec] counterpart (via [DataSpec.onClient]) + * `int`/... method here is called by its [DataSpec] counterpart (via [net.kernelpanicsoft.archie.util.onClient]) * with matching parameters, and queues a [ConfigEntryBuilder]-based entry that reads from and * writes back into the same backing maps on [spec]. [buildRoot]/[buildSub] then turn the queued * entries into an actual Cloth Config [ConfigCategory]/[SubCategoryListEntry]. None of this is diff --git a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/DataSpec.kt b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/DataSpec.kt index 522648f89..6384a4d18 100644 --- a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/DataSpec.kt +++ b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/DataSpec.kt @@ -81,7 +81,7 @@ abstract class DataSpec(val title: Component, val id: String = title.string.toSn */ open val isEnabled: Boolean = true - /** Registers [subcategories] as fields on this category, recursively. */ + /** Registers [CategorySpec.subcategories] as fields on this category, recursively. */ internal open fun init() { SerializationManager { diff --git a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/IConfigSerializer.kt b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/IConfigSerializer.kt index 9edf90a8f..0fa383773 100644 --- a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/IConfigSerializer.kt +++ b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/config/IConfigSerializer.kt @@ -11,7 +11,7 @@ import java.nio.file.StandardCopyOption * implementations live in `net.kernelpanicsoft.archie.config.serializer`; [ConfigSpec.fileSerializer] * picks one per-platform by default. * - * [configPath], [load], and [save] all take a [configFolder] that defaults to the platform's shared + * [configPath], [load], and [save] all take a `configFolder` that defaults to the platform's shared * config folder ([Platform.getConfigFolder]); [ConfigSpec] passes its own [ConfigSpec.configFolder] * instead, which a [ConfigSpec.Server] repoints at the current world's per-save `serverconfig/` folder. */ diff --git a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/ComposeScreen.kt b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/ComposeScreen.kt index 1cc0456f6..47c1e58f5 100644 --- a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/ComposeScreen.kt +++ b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/ComposeScreen.kt @@ -79,7 +79,7 @@ interface LayerManagerProvider * (`compileOnly` in `common`, `runtimeLibrary` - present for local runs, never bundled - in the * loader modules; see `common/build.gradle.kts`). [ComposeScreen] is loaded by every screen in * the mod, so its own class file must never reference a symbol that isn't resolvable in a real - * player's game; only [AClientGameTestHarness]'s method bodies (never invoked outside + * player's game; only `AClientGameTestHarness`'s method bodies (never invoked outside * `AGameTestPlatform.isGameTest`) construct the actual `StandardTestDispatcher`/ * `TestCoroutineScheduler` instances installed here. */ diff --git a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/modifiers/input/Interactable.kt b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/modifiers/input/Interactable.kt index 59e68e40a..d72e9ab54 100644 --- a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/modifiers/input/Interactable.kt +++ b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/modifiers/input/Interactable.kt @@ -105,7 +105,7 @@ fun Modifier.hoverable( } /** - * Emits [PressInteraction] and invokes [onPress]/[onRelease] across a press - the + * Emits [PressInteraction] and invokes [onPress] across a press - the * `net.kernelpanicsoft.archie` equivalent of the press-recognition half of Compose * Foundation's `Modifier.clickable`. Observe release via * [net.kernelpanicsoft.archie.gui.interaction.collectIsPressedAsState] rather than a callback - diff --git a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/theme/ComposableTheme.kt b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/theme/ComposableTheme.kt index bf8f35a6f..3710e6799 100644 --- a/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/theme/ComposableTheme.kt +++ b/core/common/src/main/kotlin/net/kernelpanicsoft/archie/gui/theme/ComposableTheme.kt @@ -59,7 +59,7 @@ data class SimpleThemeState( data class StatefulTheme(val states: Map) /** - * Inner spacing a composable using a theme should reserve around its own [content], so e.g. a + * Inner spacing a composable using a theme should reserve around its own content, so e.g. a * button's label never renders flush against the button's edges once it grows past * [ComposableTheme.minSize] to fit a longer label. * diff --git a/datagen/common/src/main/kotlin/net/kernelpanicsoft/archie/data/common/conditions/gen/AConditionBuilder.kt b/datagen/common/src/main/kotlin/net/kernelpanicsoft/archie/data/common/conditions/gen/AConditionBuilder.kt index 23af0b34e..f74335d80 100644 --- a/datagen/common/src/main/kotlin/net/kernelpanicsoft/archie/data/common/conditions/gen/AConditionBuilder.kt +++ b/datagen/common/src/main/kotlin/net/kernelpanicsoft/archie/data/common/conditions/gen/AConditionBuilder.kt @@ -25,9 +25,6 @@ import net.minecraft.resources.ResourceLocation */ object AConditionBuilder { - /** [AAndCondition] of `this` and [other]. */ - - fun and(vararg values: IACondition): IACondition = AAndCondition(*values) fun or(vararg values: IACondition): IACondition = AOrCondition(*values) fun xor(vararg values: IACondition): IACondition = AXorCondition(*values) diff --git a/datagen/fabric/src/main/kotlin/net/kernelpanicsoft/archie/data/ADataGeneratorPlatformInternal.kt b/datagen/fabric/src/main/kotlin/net/kernelpanicsoft/archie/data/ADataGeneratorPlatformInternal.kt index 19ec5c231..a41820115 100644 --- a/datagen/fabric/src/main/kotlin/net/kernelpanicsoft/archie/data/ADataGeneratorPlatformInternal.kt +++ b/datagen/fabric/src/main/kotlin/net/kernelpanicsoft/archie/data/ADataGeneratorPlatformInternal.kt @@ -25,7 +25,7 @@ internal object ADataGeneratorPlatformInternal * Appends one [EntrypointContainer] per mod in [ADatagenEvents.MODS] to * [dataGeneratorInitializers], each of which fires [ADatagenEvents.GATHER_DATA] with an * [ADataGeneratorFabric] for that mod. No-op outside a datagen run - * ([ADataGeneratorPlatform.isDataGen] false). + * ([net.kernelpanicsoft.archie.data.platform.ADataGeneratorPlatform.isDataGen] false). */ @JvmStatic @JvmName("addEntrypoints") diff --git a/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/AClientGameTestHarness.kt b/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/AClientGameTestHarness.kt index d82c1c0ac..f09e622d1 100644 --- a/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/AClientGameTestHarness.kt +++ b/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/AClientGameTestHarness.kt @@ -199,7 +199,7 @@ interface TestInput { /** * Builds a test world from [ClientGameTestContext.worldBuilder]: either a singleplayer world via * [create]/[withSingleplayer], or a same-JVM dedicated server via [createServer]/[withServer] for - * tests that need a real client↔server boundary (e.g. exercising [ConfigSpec.Server] sync or + * tests that need a real client↔server boundary (e.g. exercising [net.kernelpanicsoft.archie.config.ConfigSpec.Server] sync or * other multiplayer-only codepaths) rather than the integrated server a singleplayer world uses. */ @Suppress("unused") @@ -1493,13 +1493,13 @@ data class AClientGameTestSummary( val failedDetails: List = emptyList(), ) -/** - * Runs every [ClientGameTest]-annotated method across [modToClasses] (as collected by - * [AGameTestPlatform.register] via [AGameTestEventObject]/`AGametestEvents.ArchieGameTestBuilder`'s - * `client { }` block) sequentially on the client thread, then returns to the title screen. - * No-ops (returning an all-zero summary) unless [side] is [AGameTestSide.CLIENT]. - */ object AClientGameTestHarness { + /** + * Runs every [ClientGameTest]-annotated method across [modToClasses] (as collected by + * [AGameTestPlatform.register] via [AGameTestEventObject]/`AGametestEvents.ArchieGameTestBuilder`'s + * `client { }` block) sequentially on the client thread, then returns to the title screen. + * No-ops (returning an all-zero summary) unless [side] is [AGameTestSide.CLIENT]. + */ @OptIn(ExperimentalCoroutinesApi::class) fun run(modToClasses: Map>>, side: AGameTestSide?): AClientGameTestSummary { if (side != AGameTestSide.CLIENT) return AClientGameTestSummary(passed = 0, failed = 0, skipped = 0) diff --git a/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/ComposeScreenTestContext.kt b/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/ComposeScreenTestContext.kt index 7023aa684..5af4b5330 100644 --- a/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/ComposeScreenTestContext.kt +++ b/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/ComposeScreenTestContext.kt @@ -31,7 +31,7 @@ class TestNodeScope( ) { /** * Waits for compose to settle before reading [node]'s on-screen bounds - without this, a - * node's very first interaction (right after [ComposeScreenTestContext.waitForScreen]/ + * node's very first interaction (right after [waitForScreen]/ * [ComposeScreenTestContext.node] finds it) can read a transient pre-layout-settle position * (e.g. before a wrapping Scrollable's initial measure has stabilized), computing a click/ * hover target that no longer matches the node's real bounds one frame later - silently @@ -51,7 +51,7 @@ class TestNodeScope( context.getInput().click(x, y, button) } - /** Moves the cursor to the center of this node's on-screen bounds, without clicking - e.g. to assert a [TextureStates.FOCUSED] visual state. */ + /** Moves the cursor to the center of this node's on-screen bounds, without clicking - e.g. to assert a [net.kernelpanicsoft.archie.gui.composables.theme.TextureStates.FOCUSED] visual state. */ fun hover() { val (x, y) = centerCoords() context.getInput().setCursor(x, y) @@ -79,7 +79,7 @@ class TestNodeScope( } /** - * The [TextureStates] key this node's [net.kernelpanicsoft.archie.gui.layout.Renderer] most + * The [net.kernelpanicsoft.archie.gui.composables.theme.TextureStates] key this node's [net.kernelpanicsoft.archie.gui.layout.Renderer] most * recently selected to draw (e.g. `"hovered"`), or `null` if this node doesn't render a * theme-state-driven visual. See [net.kernelpanicsoft.archie.gui.nodes.UINode.renderState]. */ diff --git a/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/NoOpGameTest.kt b/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/NoOpGameTest.kt index f937a5cac..24143a511 100644 --- a/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/NoOpGameTest.kt +++ b/gametest/common/src/main/kotlin/net/kernelpanicsoft/archie/gametest/NoOpGameTest.kt @@ -5,10 +5,10 @@ import net.minecraft.gametest.framework.GameTest import net.minecraft.gametest.framework.GameTestHelper /** - * A trivially-succeeding placeholder, registered by [AGameTestPlatformInternal] on each loader + * A trivially-succeeding placeholder, registered by `AGameTestPlatformInternal` on each loader * when a mod's [net.kernelpanicsoft.archie.gametest.platform.AGameTestModFilter]-selected suite has no real test functions for the current * [net.kernelpanicsoft.archie.gametest.platform.AGameTestSide] - e.g. a mod with only client-side coverage (like Archie-Test, whose own suite - * registers just [net.kernelpanicsoft.archie.test.gametest.TestScreenGameTest]) running its + * registers just `net.kernelpanicsoft.archie.test.gametest.TestScreenGameTest`) running its * server invocation. Vanilla's `GameTestServer` refuses to boot with zero registered test * functions at all (`IllegalArgumentException: No test functions were given!`); this keeps that * boot trivially satisfied instead of crashing the whole invocation.