yeow-api 0.2.103 → 0.2.105

package/package.json

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

package/src/assets.ts

@@ -43,4 +43,16 @@ export function extractSync(path: string, dest?: string): string {
   return (_sendAssets({ t: 'extract', p }) as { path: string }).path;
 }
 
-export const assets = { read, readSync, readBase64, readBase64Sync, extract, extractSync };
+export async function extractDir(path: string, dest?: string): Promise<string> {
+  const p: Record<string, unknown> = { path };
+  if (dest) p.dest = dest;
+  const r = await _sendAssetsAsync({ t: 'extractDir', p }) as { path: string };
+  return r.path;
+}
+export function extractDirSync(path: string, dest?: string): string {
+  const p: Record<string, unknown> = { path };
+  if (dest) p.dest = dest;
+  return (_sendAssets({ t: 'extractDir', p }) as { path: string }).path;
+}
+
+export const assets = { read, readSync, readBase64, readBase64Sync, extract, extractSync, extractDir, extractDirSync };

package/src/chunk.ts

@@ -66,12 +66,14 @@ export class ChunkSnapshot {
 
 /**
  * 顶部方块快照（2D，256 元素）：每列最高非空气方块的类型索引，顺序 z 外层 → x 内层。
+ * 请求时带 withHeight 可同时获得 heightMap（每列最高方块的世界高度，同布局）。
  * 索引仅当前运行时有效，不可持久化。
  */
 export class ChunkTopSnapshot {
   constructor(
     readonly data: Uint16Array,
     readonly blocks: string[],
+    readonly height?: Uint16Array,
   ) {}
 
   getTop(x: number, z: number): string {
@@ -84,12 +86,26 @@ export class ChunkTopSnapshot {
     return this.data[z * 16 + x];
   }
 
-  static async fromRaw(raw: { data: string }): Promise<ChunkTopSnapshot> {
-    return new ChunkTopSnapshot(decodeShortArray(raw.data), await ensureBlocks());
+  /** 列最高方块的世界高度（需 withHeight 请求；未请求时返回 null）。 */
+  getTopHeight(x: number, z: number): number | null {
+    if (!this.height || x < 0 || x > 15 || z < 0 || z > 15) return null;
+    return this.height[z * 16 + x];
   }
 
-  static fromRawSync(raw: { data: string }): ChunkTopSnapshot {
-    return new ChunkTopSnapshot(decodeShortArray(raw.data), ensureBlocksSync());
+  static async fromRaw(raw: { data: string; height?: string }): Promise<ChunkTopSnapshot> {
+    return new ChunkTopSnapshot(
+      decodeShortArray(raw.data),
+      await ensureBlocks(),
+      raw.height ? decodeShortArray(raw.height) : undefined,
+    );
+  }
+
+  static fromRawSync(raw: { data: string; height?: string }): ChunkTopSnapshot {
+    return new ChunkTopSnapshot(
+      decodeShortArray(raw.data),
+      ensureBlocksSync(),
+      raw.height ? decodeShortArray(raw.height) : undefined,
+    );
   }
 }
 
@@ -112,11 +128,16 @@ export class Chunk {
     return ChunkSnapshot.fromRawSync(call<{ data: string; minY: number; height: number }>('chunk.getSnapshot', { world: this.world, x: this.x, z: this.z }));
   }
 
-  /** 顶部方块快照（256 元素，每列最高非空气方块，z 外层 → x 内层）。 */
-  getTopSnapshot(): Promise<ChunkTopSnapshot> {
-    return post<{ data: string }>('chunk.getTopSnapshot', { world: this.world, x: this.x, z: this.z }).then(ChunkTopSnapshot.fromRaw);
+  /** 顶部方块快照（256 元素，每列最高非空气方块，z 外层 → x 内层）。
+   *  传 withHeight=true 时同时返回 heightMap（每列最高方块的世界高度）。 */
+  getTopSnapshot(withHeight?: boolean): Promise<ChunkTopSnapshot> {
+    const params: Record<string, unknown> = { world: this.world, x: this.x, z: this.z };
+    if (withHeight) params.withHeight = true;
+    return post<{ data: string; height?: string }>('chunk.getTopSnapshot', params).then(ChunkTopSnapshot.fromRaw);
   }
-  getTopSnapshotSync(): ChunkTopSnapshot {
-    return ChunkTopSnapshot.fromRawSync(call<{ data: string }>('chunk.getTopSnapshot', { world: this.world, x: this.x, z: this.z }));
+  getTopSnapshotSync(withHeight?: boolean): ChunkTopSnapshot {
+    const params: Record<string, unknown> = { world: this.world, x: this.x, z: this.z };
+    if (withHeight) params.withHeight = true;
+    return ChunkTopSnapshot.fromRawSync(call<{ data: string; height?: string }>('chunk.getTopSnapshot', params));
   }
 }

package/src/fs.ts

@@ -106,14 +106,22 @@ function _makeFs(level: FsLevel) {
     return _sendFs({ t: t('systemPaths') }) as { home: string; desktop: string; temp: string };
   }
 
+  /** 服务器根目录（Java 进程工作目录）的绝对路径。 */
+  async function getServerPath(): Promise<string> {
+    return (await _sendFsAsync({ t: t('getServerPath') }) as { path: string }).path;
+  }
+  function getServerPathSync(): string {
+    return (_sendFs({ t: t('getServerPath') }) as { path: string }).path;
+  }
+
   return {
     readFile, readFileSync, readFileBase64, readFileBase64Sync,
     writeFile, writeFileSync, writeFileBase64, writeFileBase64Sync,
     appendFile, appendFileSync,
     exists, existsSync, isDirectory, isDirectorySync,
     deleteFile, deleteFileSync, mkdir, mkdirSync, list, listSync,
-    // systemPaths 仅 outer 级提供（fs.outer.systemPaths）
-    ...(level === 'outer' ? { systemPaths, systemPathsSync } : {}),
+    // outer 专属能力（systemPaths / getServerPath）
+    ...(level === 'outer' ? { systemPaths, systemPathsSync, getServerPath, getServerPathSync } : {}),
   };
 }
 

package/src/global.d.ts

@@ -12,6 +12,33 @@ declare global {
   function _getCurrentCbStack(): { stack: string; outer: unknown } | null;
   function _attachCbStack(err: unknown): void;
 
+  // ── init.js 注入的标准环境（lib 为 ESNext，不含 DOM——自行声明）──
+  interface YeowConsole {
+    log(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+  }
+  var console: YeowConsole;
+
+  interface YeowResponse {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: { get(name: string): string | undefined };
+    text(): Promise<string>;
+    json(): Promise<any>;
+  }
+  function fetch(
+    url: string,
+    init?: { method?: string; headers?: Record<string, string>; body?: string | null }
+  ): Promise<YeowResponse>;
+
+  function setTimeout(handler: (...args: any[]) => void, timeout?: number, ...args: any[]): string;
+  function clearTimeout(id: string): void;
+  function setInterval(handler: (...args: any[]) => void, timeout?: number, ...args: any[]): string;
+  function clearInterval(id: string): void;
+
   var __plugin:
     | {
         name: string;

package/src/index.ts

@@ -44,7 +44,8 @@ export {
 } from './fs.js';
 export { assets, read as assetsRead, readSync as assetsReadSync,
     readBase64 as assetsReadBase64, readBase64Sync as assetsReadBase64Sync,
-    extract as assetsExtract, extractSync as assetsExtractSync } from './assets.js';
+    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';