📝 Update More API Document

docs/api/build-application-text-async-logger.md

@@ -0,0 +1,71 @@
+---
+name: build-application-text-async-logger
+group: api
+category: facade
+update-time: 20260520
+description: Build the application-facing text-console async logger facade from an AsyncLoggerBuildConfig.
+key-word:
+    - application
+    - async
+    - text
+    - public
+---
+
+## Build-application-text-async-logger
+
+Build an `ApplicationTextAsyncLogger` from `AsyncLoggerBuildConfig`. This facade is the application-oriented async builder for the text-console runtime sink shape returned by `build_async_text_logger(...)`.
+
+### Interface
+
+```moonbit
+pub fn build_application_text_async_logger(
+  config : AsyncLoggerBuildConfig,
+) -> ApplicationTextAsyncLogger {
+```
+
+#### input
+
+- `config : AsyncLoggerBuildConfig` - Combined sync logger config and async queue/runtime config.
+
+#### output
+
+- `ApplicationTextAsyncLogger` - Application-facing async logger backed by `FormattedConsoleSink`.
+
+### Explanation
+
+Detailed rules explaining key parameters and behaviors
+
+- This API delegates to `build_async_text_logger(...)`.
+- It is intended for config-driven async text console output where callers want the concrete text sink shape rather than the broader runtime sink enum wrapper.
+- The returned logger keeps the usual async lifecycle helpers.
+
+### How to Use
+
+Here are some specific examples provided.
+
+#### When Need An App Async Builder With Text Sink Shape
+
+When async output should stay on text console formatting:
+```moonbit
+let logger = build_application_text_async_logger(
+  AsyncLoggerBuildConfig::new(
+    logger=text_console(target="app.text.async"),
+    async_config=AsyncLoggerConfig::new(max_pending=4),
+  ),
+)
+```
+
+In this example, the async logger is built for text-console output specifically.
+
+### Error Case
+
+e.g.:
+- If the embedded logger config selects a non-text sink shape, the caller should use the general async builder facade instead.
+
+- If runtime draining is never started, records still follow the normal async queue lifecycle rules.
+
+### Notes
+
+1. This is a narrower text-console async facade than `build_application_async_logger(...)`.
+
+2. It is most useful when callers want the `FormattedConsoleSink`-backed async type explicitly.