Backport Wave 1: chimeric-lib shared API, fixes and test harness (26.1.2)

[chimericdream]

Wave 1 of the main → 26.1.2 backport. Plan: docs/backport-26.1.2/chimeric-lib.md.

Stacked on #81 — base is backport/26.1.2/shared-build, merge that first. This PR blocks all 14 per-mod PRs, which compile against the API added here.

Bug fixes

• 1.6 ImplementedInventory.isMatchingPartialStack used ItemStack.matches, which also compares counts — so two otherwise-identical partial stacks only merged when their counts happened to be equal. Every tryInsert consumer (minekea shelves/armoires/glass jars, the block painter, the hopper filter) silently failed to merge partials.
• 4.7 clearContent now preserves the fixed slot count of a NonNullList.withSize.
• 2.4 BlockConfig.getTexture() used Map.getOrDefault, whose default argument is evaluated unconditionally — a config with an explicit texture but no ingredient threw IllegalStateException: No default ingredient set from a fallback it never needed.

New shared API (what Wave 2 depends on)

Class	Item	Replaces
screen/InventoryScreenHandler	3.2, 2.6	Simple/DoubleWide collapse to thin subclasses that only pin the column count
inventories/ContainerOpenersCounters	3.5	Three hand-rolled anonymous counters. Takes the menu class as a required parameter — which is what makes shulker-stuff's 2.5 unrepeatable
item/AbstractWrenchItem	3.4	Wrench logic duplicated byte-for-byte between minekea and hopper-xtreme
blocks/BlockUtils	3.9	Moved here from sponj
neoforge/loot/LootModifierHelper	3.6	DeferredRegister.create(NeoForgeRegistries...) boilerplate in two mods

ColorHelpers gains getTints() with a private, defensively-copied palette and a lower bound on getTint. The 26.1.2 flat constants are kept — main's Blocks.WOOL.red() accessors don't exist here.

Test harness

common/testFixtures publishes BootstrapMinecraft + GameTestContainers/Entities/Menus; 9 JUnit classes (43 tests) and 5 fabric GameTest classes (11 tests) in the never-shipped gametest source set.

Two adaptations the plan did not predict

1. Data components ARE lazily bound on 26.1.2. The plan said the "Components not bound yet" bake was 26.2-only and should be deleted. Wrong — that was inferred from git grep DATA_COMPONENT_INITIALIZERS 26.1.2 returning nothing, which only proves the repo never used it. Removing the bake failed 8 of 43 tests; javap on the 26.1.2 jar shows BuiltInRegistries.DATA_COMPONENT_INITIALIZERS and DataComponentInitializers.build(Provider) -> List<PendingComponents> with apply(), identically shaped to 26.2.

This also means minekea must keep its datagen component bind. minekea.md, README.md, docs/TESTING.md and CLAUDE.md are all corrected in this PR.

2. new BlockEntityType<>(factory, blocks) is private on 26.1.2 (public on 26.2). Mods that call it directly each widen it in their own access widener; chimeric-lib has none enabled. Rather than add a shipping access widener to serve a test fixture, the gametest uses fabric-api's public FabricBlockEntityTypeBuilder — that source set is fabric-only and never ships.

Verification

• :chimeric-lib:{common,fabric,neoforge}:build green
• :chimeric-lib:fabric:test — 43/43
• :chimeric-lib:fabric:runGameTest — 11/11

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 79f1b7d5-dc16-4945-a0d8-1351e7a3b6ec

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch backport/26.1.2/chimeric-lib

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}