yeow-api 0.2.106 → 0.2.107

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yeow-api",
-    "version": "0.2.106",
+    "version": "0.2.107",
     "description": "Yeow API",
     "type": "module",
     "main": "./src/index.ts",

package/src/core.ts

@@ -0,0 +1,91 @@
+/// <reference path="global.d.ts" />
+
+export { call } from './task.js';
+export { Location } from './location.js';
+export { Player } from './player.js';
+export { World } from './world.js';
+export { Chunk, ChunkSnapshot, ChunkTopSnapshot } from './chunk.js';
+export type { ChunkData } from './chunk.js';
+export { Entity, LivingEntity } from './entity.js';
+export type { BoundingBox } from './entity.js';
+export { Block } from './block.js';
+export { Inventory } from './inventory.js';
+export { registerCommand } from './command.js';
+export type { CommandOptions, CommandPayload, CommandSender, ManualCompleter } from './command.js';
+export { eventOn, eventOff } from './event.js';
+export type {
+    PlayerJoinEvent, PlayerQuitEvent, PlayerChatEvent, PlayerMoveEvent,
+    PlayerInteractEvent, PlayerCommandEvent, PlayerDeathEvent, PlayerRespawnEvent,
+    PlayerTeleportEvent, PlayerItemConsumeEvent,
+    PlayerAdvancementDoneEvent, PlayerToggleSneakEvent, PlayerToggleFlightEvent,
+    PlayerDropItemEvent, PlayerPickupItemEvent, PlayerBucketFillEvent, PlayerBucketEmptyEvent,
+    PlayerExpChangeEvent, PlayerLevelChangeEvent, PlayerGameModeChangeEvent, FoodLevelChangeEvent,
+    EntityDamageEvent, EntityDeathEvent, EntitySpawnEvent, EntityExplodeEvent,
+    EntityRegainHealthEvent, EntityTargetEvent,
+    ProjectileLaunchEvent, ProjectileHitEvent,
+    BlockBreakEvent, BlockPlaceEvent, BlockFadeEvent, BlockGrowEvent, BlockSpreadEvent, BlockExplodeEvent,
+    InventoryOpenEvent, InventoryCloseEvent, InventoryClickEvent,
+    ServerPingEvent, ServerCommandEvent,
+    PlayerResourcePackStatusEvent,
+} from './event.js';
+export { onInit, onLoad, onUnload } from './lifecycle.js';
+export {
+    broadcast, broadcastSync, dispatchCommand, dispatchCommandSync,
+    setMotd, setMotdSync, setIcon, setIconSync,
+    getMotd, getMotdSync, getVersion, getVersionSync,
+    getTps, getTpsSync, getMaxPlayers, getMaxPlayersSync,
+} from './server.js';
+export type { TpsInfo } from './server.js';
+export {
+    fs,
+    readFile, readFileSync, readFileBase64, readFileBase64Sync,
+    writeFile, writeFileSync, writeFileBase64, writeFileBase64Sync,
+    appendFile, appendFileSync,
+    exists, existsSync, isDirectory, isDirectorySync,
+    deleteFile, deleteFileSync, mkdir, mkdirSync, list, listSync,
+} from './fs.js';
+export { assets, read as assetsRead, readSync as assetsReadSync,
+    readBase64 as assetsReadBase64, readBase64Sync as assetsReadBase64Sync,
+    extract as assetsExtract, extractSync as assetsExtractSync,
+    extractDir as assetsExtractDir, extractDirSync as assetsExtractDirSync } from './assets.js';
+export { path } from './path.js';
+export { listen, respond, close, request, requestSync } from './http.js';
+export { logError } from './log-error.js';
+export { InstanceId, GUIHandle, BossBarHandle, InventoryHandle } from './instance-id.js';
+export type { ItemStack } from './item.js';
+export type { PotionEffect } from './potion.js';
+export { addPotionEffect, removePotionEffect, clearPotionEffects, getActivePotionEffects } from './potion.js';
+export { playSound, stopSound, stopAllSounds } from './sound.js';
+export type { ParticleOptions } from './particle.js';
+export { spawnParticle } from './particle.js';
+export { get as pdcGet, set as pdcSet, has as pdcHas, remove as pdcRemove, keys as pdcKeys,
+    getBlock as pdcGetBlock, setBlock as pdcSetBlock, hasBlock as pdcHasBlock, removeBlock as pdcRemoveBlock } from './pdc.js';
+export { createBossBar, destroy as destroyBossBar,
+    setTitle as setBossBarTitle, setProgress as setBossBarProgress,
+    setColor as setBossBarColor, setStyle as setBossBarStyle,
+    setVisible as setBossBarVisible, addPlayer as addBossBarPlayer,
+    removePlayer as removeBossBarPlayer, removeAll as removeAllBossBarPlayers,
+    addFlag as addBossBarFlag, removeFlag as removeBossBarFlag } from './bossbar.js';
+export type { BossBarOptions } from './bossbar.js';
+export { createGUI, destroy as destroyGUI, open as openGUI,
+    close as closeGUI, setItem as setGUIItem, fill as fillGUI, clear as clearGUI } from './gui.js';
+export type { AdvancementProgress } from './advancement.js';
+export { grant as grantAdvancement, revoke as revokeAdvancement,
+    getProgress as getAdvancementProgress, awardCriteria, revokeCriteria } from './advancement.js';
+export { add as addRecipe, remove as removeRecipe, getForItem as getRecipesForItem } from './recipe.js';
+export type {
+    ObjectiveInfo, TeamInfo,
+} from './scoreboard.js';
+export { createBoard as createScoreboard, deleteBoard as deleteScoreboard,
+    createObjective, deleteObjective, getObjectives,
+    setObjectiveDisplay, getScore, setScore, resetScore,
+    createTeam, deleteTeam, getTeam, getTeams,
+    setTeamDisplayName, setTeamPrefix, setTeamSuffix, setTeamColor,
+    setTeamFriendlyFire, setTeamSeeInvisible, setTeamOption,
+    teamAddEntry, teamRemoveEntry, teamGetEntries,
+    setPlayerBoard } from './scoreboard.js';
+export { getMaterials, getBlocks, getItems } from './material.js';
+export type { MaterialInfo } from './material.js';
+export { registerService, registerNativeService, request as serviceRequest, subscribe as serviceSubscribe, publish as servicePublish } from './service.js';
+export type { ServiceResult, NativeServiceResult } from './service.js';
+export { log, Logger } from './log.js';

package/src/http.ts

@@ -48,11 +48,27 @@ _registerCallback(() => {
   _servers.clear();
 }, { persistent: true });
 
+/**
+ * 异步 HTTP 请求（不阻塞 JS 线程）——底层走 `http:requestAsync` 通道。
+ * 推荐用于事件处理器与高频场景。需要同步阻塞返回的用 `requestSync`。
+ */
 export function request(url: string, opts: Record<string, unknown> = {}): Promise<HttpResult> {
   return new Promise((resolve, reject) => {
+    const cbId = _registerCallback((result: unknown) => {
+      if ((result as any)?.err) reject(new Error((result as any).err));
+      else resolve(result as HttpResult);
+    });
     try {
-      const result = _sendHttp({ t: 'request', p: { url, ...opts } });
-      resolve(result);
+      _sendHttp({ t: 'requestAsync', p: { url, ...opts, cb: String(cbId) } });
     } catch (e) { reject(e); }
   });
 }
+
+/**
+ * 同步 HTTP 请求（**阻塞 JS 线程**直到响应返回）——底层走 `http:request` 通道。
+ * 阻塞期间 JS 线程无法处理事件/命令/回调（可能触发 event.timeout 告警）；
+ * 仅适合低频、非事件上下文。事件处理器或高频场景请用 `request`（异步）或全局 `fetch`。
+ */
+export function requestSync(url: string, opts: Record<string, unknown> = {}): HttpResult {
+  return _sendHttp({ t: 'request', p: { url, ...opts } });
+}

package/src/index.ts

@@ -1,91 +1,15 @@
-/// <reference path="global.d.ts" />
+/**
+ * Yeow API 入口。
+ *
+ * 全部具名导出来自 `core.ts`（与历史导出面完全一致）；默认导出 `Yeow` 为
+ * 聚合全部具名导出的**大对象**——不推荐使用：默认导入会破坏 tree-shaking，
+ * 显著增大插件体积，仅适用于简化动态执行含任意逻辑的代码。请按需命名导入。
+ */
+export * from './core.js';
 
-export { call } from './task.js';
-export { Location } from './location.js';
-export { Player } from './player.js';
-export { World } from './world.js';
-export { Chunk, ChunkSnapshot, ChunkTopSnapshot } from './chunk.js';
-export type { ChunkData } from './chunk.js';
-export { Entity, LivingEntity } from './entity.js';
-export type { BoundingBox } from './entity.js';
-export { Block } from './block.js';
-export { Inventory } from './inventory.js';
-export { registerCommand } from './command.js';
-export type { CommandOptions, CommandPayload, CommandSender, ManualCompleter } from './command.js';
-export { eventOn, eventOff } from './event.js';
-export type {
-    PlayerJoinEvent, PlayerQuitEvent, PlayerChatEvent, PlayerMoveEvent,
-    PlayerInteractEvent, PlayerCommandEvent, PlayerDeathEvent, PlayerRespawnEvent,
-    PlayerTeleportEvent, PlayerItemConsumeEvent,
-    PlayerAdvancementDoneEvent, PlayerToggleSneakEvent, PlayerToggleFlightEvent,
-    PlayerDropItemEvent, PlayerPickupItemEvent, PlayerBucketFillEvent, PlayerBucketEmptyEvent,
-    PlayerExpChangeEvent, PlayerLevelChangeEvent, PlayerGameModeChangeEvent, FoodLevelChangeEvent,
-    EntityDamageEvent, EntityDeathEvent, EntitySpawnEvent, EntityExplodeEvent,
-    EntityRegainHealthEvent, EntityTargetEvent,
-    ProjectileLaunchEvent, ProjectileHitEvent,
-    BlockBreakEvent, BlockPlaceEvent, BlockFadeEvent, BlockGrowEvent, BlockSpreadEvent, BlockExplodeEvent,
-    InventoryOpenEvent, InventoryCloseEvent, InventoryClickEvent,
-    ServerPingEvent, ServerCommandEvent,
-    PlayerResourcePackStatusEvent,
-} from './event.js';
-export { onInit, onLoad, onUnload } from './lifecycle.js';
-export {
-    broadcast, broadcastSync, dispatchCommand, dispatchCommandSync,
-    setMotd, setMotdSync, setIcon, setIconSync,
-    getMotd, getMotdSync, getVersion, getVersionSync,
-    getTps, getTpsSync,
-} from './server.js';
-export type { TpsInfo } from './server.js';
-export {
-    fs,
-    readFile, readFileSync, readFileBase64, readFileBase64Sync,
-    writeFile, writeFileSync, writeFileBase64, writeFileBase64Sync,
-    appendFile, appendFileSync,
-    exists, existsSync, isDirectory, isDirectorySync,
-    deleteFile, deleteFileSync, mkdir, mkdirSync, list, listSync,
-} from './fs.js';
-export { assets, read as assetsRead, readSync as assetsReadSync,
-    readBase64 as assetsReadBase64, readBase64Sync as assetsReadBase64Sync,
-    extract as assetsExtract, extractSync as assetsExtractSync,
-    extractDir as assetsExtractDir, extractDirSync as assetsExtractDirSync } from './assets.js';
-export { path } from './path.js';
-export { listen, respond, close, request } from './http.js';
-export { logError } from './log-error.js';
-export { InstanceId, GUIHandle, BossBarHandle, InventoryHandle } from './instance-id.js';
-export type { ItemStack } from './item.js';
-export type { PotionEffect } from './potion.js';
-export { addPotionEffect, removePotionEffect, clearPotionEffects, getActivePotionEffects } from './potion.js';
-export { playSound, stopSound, stopAllSounds } from './sound.js';
-export type { ParticleOptions } from './particle.js';
-export { spawnParticle } from './particle.js';
-export { get as pdcGet, set as pdcSet, has as pdcHas, remove as pdcRemove, keys as pdcKeys,
-    getBlock as pdcGetBlock, setBlock as pdcSetBlock, hasBlock as pdcHasBlock, removeBlock as pdcRemoveBlock } from './pdc.js';
-export { createBossBar, destroy as destroyBossBar,
-    setTitle as setBossBarTitle, setProgress as setBossBarProgress,
-    setColor as setBossBarColor, setStyle as setBossBarStyle,
-    setVisible as setBossBarVisible, addPlayer as addBossBarPlayer,
-    removePlayer as removeBossBarPlayer, removeAll as removeAllBossBarPlayers,
-    addFlag as addBossBarFlag, removeFlag as removeBossBarFlag } from './bossbar.js';
-export type { BossBarOptions } from './bossbar.js';
-export { createGUI, destroy as destroyGUI, open as openGUI,
-    close as closeGUI, setItem as setGUIItem, fill as fillGUI, clear as clearGUI } from './gui.js';
-export type { AdvancementProgress } from './advancement.js';
-export { grant as grantAdvancement, revoke as revokeAdvancement,
-    getProgress as getAdvancementProgress, awardCriteria, revokeCriteria } from './advancement.js';
-export { add as addRecipe, remove as removeRecipe, getForItem as getRecipesForItem } from './recipe.js';
-export type {
-    ObjectiveInfo, TeamInfo,
-} from './scoreboard.js';
-export { createBoard as createScoreboard, deleteBoard as deleteScoreboard,
-    createObjective, deleteObjective, getObjectives,
-    setObjectiveDisplay, getScore, setScore, resetScore,
-    createTeam, deleteTeam, getTeam, getTeams,
-    setTeamDisplayName, setTeamPrefix, setTeamSuffix, setTeamColor,
-    setTeamFriendlyFire, setTeamSeeInvisible, setTeamOption,
-    teamAddEntry, teamRemoveEntry, teamGetEntries,
-    setPlayerBoard } from './scoreboard.js';
-export { getMaterials, getBlocks, getItems } from './material.js';
-export type { MaterialInfo } from './material.js';
-export { registerService, registerNativeService, request as serviceRequest, subscribe as serviceSubscribe, publish as servicePublish } from './service.js';
-export type { ServiceResult, NativeServiceResult } from './service.js';
-export { log, Logger } from './log.js';
+import * as api from './core.js';
+
+const Yeow = { ...api };
+
+export default Yeow;
+export { Yeow };

package/src/server.ts

@@ -28,3 +28,7 @@ export interface TpsInfo {
  */
 export function getTps(options?: TaskOptions): Promise<TpsInfo> { return post<TpsInfo>('server.getTps', {}, options); }
 export function getTpsSync(options?: TaskOptions): TpsInfo { return call<TpsInfo>('server.getTps', {}, options); }
+
+/** 服务器最大玩家数。 */
+export function getMaxPlayers(options?: TaskOptions): Promise<number> { return post<number>('server.getMaxPlayers', {}, options); }
+export function getMaxPlayersSync(options?: TaskOptions): number { return call<number>('server.getMaxPlayers', {}, options); }