EmakiCoreLib Changelog

[2.0.0] - 2026-04-04

Added

Asynchronous Infrastructure & Performance Monitoring

• Added AsyncTaskScheduler, AsyncFileService, AsyncYamlFiles to provide unified asynchronous execution capabilities for actions, file I/O, GUI, and assembly processes.
• Added PerformanceMonitor, PerformanceSnapshot, and an operation-level statistics model for continuous tracking of execution time, success rates, and warning counts.
• Added generic CacheManager / CacheStats for caching high-frequency hotspot data such as preview results.

GUI Asynchronous Rendering

• GuiService now has an openAsync(...) opening flow.
• Added AsyncGuiRenderer, supporting slot item preparation on async threads followed by a single batch fill-back on the main thread.
• GuiSession gained the ability to fill back rendering results, facilitating the decoupling of "computation" and "display" for complex GUIs.

Item Assembly 2.0

• EmakiItemAssemblyService added previewAsync(...), giveAsync(...), and preview caching.
• Added AssemblyFeedbackHandler, allowing business plugins to receive feedback on Lore search-and-insert failures, regex errors, and configuration errors.
• Added ItemPresentationCompiler, PresentationCompileResult, PresentationCompileIssue.
• Name modification, Lore modification, and search-and-insert rules can now be compiled first and then rendered, making it easier for upper-level plugins like EmakiForge to reuse them.

Changed

Action System Scheduling Upgrade

• The Action interface added extension points: executionMode() and timeoutMillis().
• Added ActionExecutionMode, currently supporting SYNC and ASYNC_IO.
• ActionDispatchScheduler will automatically choose between main-thread scheduling or async I/O scheduling based on the action's execution mode.
• ActionExecutor uniformly integrates delay, timeout, failure fallback, and asynchronous execution pipelines.

YAML & Resource Loading Optimizations

• YamlDirectoryLoader added loadAsync(), allowing directory-type configurations to directly utilize the CoreLib async scheduler.
• EmakiCoreLibPlugin will now automatically migrate bundled resources from the legacy defaults/ directory during startup.
• Plugin initialization phase uniformly integrates the async file service, namespace registration, performance monitoring, and assembly service async configuration.

Build & Dependencies

• Module version upgraded to 2.0.0.
• Added gson dependency and supplemented Shade filtering rules to avoid packaging conflicts with module-info.class and some manifest files.

Upgrade Notes

• Both EmakiAttribute 2.0.0 and EmakiForge 2.0.0 are adapted based on this version of CoreLib.
• Custom actions involving I/O operations (e.g., database, HTTP, file) are recommended to be explicitly declared as ASYNC_IO.
• Plugins relying on the assembly system can start using async preview, async distribution, and assembly feedback callbacks.

Known Issues

• None