yeow-api 0.2.106 → 0.2.108

package/package.json

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

package/src/block.ts

@@ -2,32 +2,82 @@ import { call, post } from './task.js';
 import type { TaskOptions } from './task.js';
 import { Location } from './location.js';
 import type { ItemStack } from './item.js';
+import { Material } from './material.js';
 
+/** 方块状态（Minecraft 原版键值对枚举，值统一为字符串）。 */
+export interface BlockState {
+  [key: string]: string;
+}
+
+/**
+ * Block —— 方块数据描述符 + 可选的世界位置（location）。
+ * 对应 Minecraft 原版的方块概念：类型 + 方块状态（键值对枚举，如
+ * `facing`、`waterlogged`、`level` 等，值统一为字符串）。
+ *
+ * **静态数据语义**：`type` / `state` / `location` 均为**获取时刻的快照**，
+ * 之后世界变化不会自动更新；需要最新状态请重新调用 `world.getBlock`。
+ *
+ * 两种来源：
+ * - `Block.of(type, state?)` —— 纯数据描述符，无 location（用于放置/比较）
+ * - `world.getBlock(x, y, z)` —— 世界中的方块，带 location（yaw/pitch 忽略，为 0）
+ */
 export class Block {
   constructor(
-    public readonly world: string,
-    public readonly x: number,
-    public readonly y: number,
-    public readonly z: number,
     public readonly type: string,
+    public readonly state?: BlockState,
+    /** 世界位置（由 world.getBlock 返回时存在；yaw/pitch 恒为 0）。 */
+    public readonly location?: Location,
   ) {}
 
-  get location(): Location {
-    return new Location(this.x, this.y, this.z, undefined, undefined, this.world);
+  static of(type: string, state?: BlockState): Block {
+    return new Block(type, state);
+  }
+
+  /** 派生一个带状态的新描述符（原对象不变）。 */
+  withState(state: BlockState): Block {
+    return new Block(this.type, { ...(this.state ?? {}), ...state }, this.location);
+  }
+
+  /** 是否与给定类型/状态相同（忽略空状态差异）。 */
+  matches(type: string, state?: BlockState): boolean {
+    if (this.type !== type) return false;
+    if (!state || Object.keys(state).length === 0) return true;
+    const s = this.state ?? {};
+    for (const [k, v] of Object.entries(state)) {
+      if (s[k] !== v) return false;
+    }
+    return true;
   }
-  isSolid(options?: TaskOptions): Promise<boolean> { return post<boolean>('block.isSolid', { world: this.world, x: this.x, y: this.y, z: this.z }, options); }
-  isSolidSync(options?: TaskOptions): boolean { return call<boolean>('block.isSolid', { world: this.world, x: this.x, y: this.y, z: this.z }, options); }
-  isLiquid(options?: TaskOptions): Promise<boolean> { return post<boolean>('block.isLiquid', { world: this.world, x: this.x, y: this.y, z: this.z }, options); }
-  isLiquidSync(options?: TaskOptions): boolean { return call<boolean>('block.isLiquid', { world: this.world, x: this.x, y: this.y, z: this.z }, options); }
-  isEmpty(options?: TaskOptions): Promise<boolean> { return post<boolean>('block.isEmpty', { world: this.world, x: this.x, y: this.y, z: this.z }, options); }
-  isEmptySync(options?: TaskOptions): boolean { return call<boolean>('block.isEmpty', { world: this.world, x: this.x, y: this.y, z: this.z }, options); }
+
+  // ── 材料级静态判断（基于类型，委托 Material；不依赖位置/状态）──
+
+  isSolid(options?: TaskOptions): Promise<boolean> { return Material.isSolid(this.type, options); }
+  isSolidSync(options?: TaskOptions): boolean { return Material.isSolidSync(this.type, options); }
+  isLiquid(options?: TaskOptions): Promise<boolean> { return Material.isLiquid(this.type, options); }
+  isLiquidSync(options?: TaskOptions): boolean { return Material.isLiquidSync(this.type, options); }
+  isAir(options?: TaskOptions): Promise<boolean> { return Material.isAir(this.type, options); }
+  isAirSync(options?: TaskOptions): boolean { return Material.isAirSync(this.type, options); }
+
+  // ── 世界操作（需要 location）──
+
+  private get pos(): { world: string; x: number; y: number; z: number } | null {
+    const l = this.location;
+    if (!l || l.world === undefined) return null;
+    return { world: l.world, x: l.x, y: l.y, z: l.z };
+  }
+
+  /** 按该方块的位置自然破坏并掉落物品（需要 location）。 */
   breakNaturally(tool?: ItemStack, options?: TaskOptions): Promise<boolean> {
-    const p: Record<string, unknown> = { world: this.world, x: this.x, y: this.y, z: this.z };
+    const pos = this.pos;
+    if (!pos) return Promise.reject(new Error('block has no location (create with world.getBlock)'));
+    const p: Record<string, unknown> = { ...pos };
     if (tool) p.item = tool;
     return post<boolean>('block.breakNaturally', p, options);
   }
   breakNaturallySync(tool?: ItemStack, options?: TaskOptions): boolean {
-    const p: Record<string, unknown> = { world: this.world, x: this.x, y: this.y, z: this.z };
+    const pos = this.pos;
+    if (!pos) throw new Error('block has no location (create with world.getBlock)');
+    const p: Record<string, unknown> = { ...pos };
     if (tool) p.item = tool;
     return call<boolean>('block.breakNaturally', p, options);
   }

package/src/core.ts

@@ -0,0 +1,92 @@
+/// <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 type { BlockState } 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 { Material, 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/material.ts

@@ -1,4 +1,4 @@
-import { post } from './task.js';
+import { call, post } from './task.js';
 import type { TaskOptions } from './task.js';
 
 export interface MaterialInfo {
@@ -34,3 +34,33 @@ export async function getItems(options?: TaskOptions): Promise<string[]> {
   Object.freeze(_items);
   return _items;
 }
+
+/**
+ * Material —— 材料级静态判断对象（不依赖坐标/状态）。
+ * 基于方块类型（material）判断其固有属性：固体/液体/空气。
+ */
+export const Material = {
+  /** 是否为固体方块（基于类型，状态不影响）。 */
+  isSolid(type: string, options?: TaskOptions): Promise<boolean> {
+    return post<boolean>('material.isSolid', { type }, options);
+  },
+  isSolidSync(type: string, options?: TaskOptions): boolean {
+    return call<boolean>('material.isSolid', { type }, options);
+  },
+
+  /** 是否为液体（水 / 熔岩）。 */
+  isLiquid(type: string, options?: TaskOptions): Promise<boolean> {
+    return post<boolean>('material.isLiquid', { type }, options);
+  },
+  isLiquidSync(type: string, options?: TaskOptions): boolean {
+    return call<boolean>('material.isLiquid', { type }, options);
+  },
+
+  /** 是否为空气（空方块）。 */
+  isAir(type: string, options?: TaskOptions): Promise<boolean> {
+    return post<boolean>('material.isAir', { type }, options);
+  },
+  isAirSync(type: string, options?: TaskOptions): boolean {
+    return call<boolean>('material.isAir', { type }, options);
+  },
+};

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); }

package/src/world.ts

@@ -2,6 +2,7 @@ import { call, post } from './task.js';
 import type { TaskOptions } from './task.js';
 import { Location, LocationData } from './location.js';
 import { Block } from './block.js';
+import type { BlockState } from './block.js';
 import { Chunk, ChunkData } from './chunk.js';
 
 interface WorldData {
@@ -100,18 +101,32 @@ export class World {
     return call<string>('world.getBiome', { world: this.name, x, y, z }, options);
   }
   getBlock(x: number, y: number, z: number, options?: TaskOptions): Promise<Block | null> {
-    return post<{ x: number; y: number; z: number; type: string }>('world.getBlock', { world: this.name, x, y, z }, options)
-      .then((r) => (r ? new Block(this.name, r.x, r.y, r.z, r.type) : null));
+    return post<{ world: string; x: number; y: number; z: number; type: string; state: BlockState }>('world.getBlock', { world: this.name, x, y, z }, options)
+      .then((r) => (r ? new Block(r.type, r.state, new Location(r.x, r.y, r.z, 0, 0, r.world)) : null));
   }
   getBlockSync(x: number, y: number, z: number, options?: TaskOptions): Block | null {
-    const r = call<{ x: number; y: number; z: number; type: string }>('world.getBlock', { world: this.name, x, y, z }, options);
-    return r ? new Block(this.name, r.x, r.y, r.z, r.type) : null;
-  }
-  setBlock(x: number, y: number, z: number, blockType: string, options?: TaskOptions): Promise<void> {
-    return post('world.setBlock', { world: this.name, x, y, z, blockType }, options);
-  }
-  setBlockSync(x: number, y: number, z: number, blockType: string, options?: TaskOptions): void {
-    call('world.setBlock', { world: this.name, x, y, z, blockType }, options);
+    const r = call<{ world: string; x: number; y: number; z: number; type: string; state: BlockState }>('world.getBlock', { world: this.name, x, y, z }, options);
+    return r ? new Block(r.type, r.state, new Location(r.x, r.y, r.z, 0, 0, r.world)) : null;
+  }
+  setBlock(x: number, y: number, z: number, block: Block | string, options?: TaskOptions): Promise<void> {
+    const p: Record<string, unknown> = { world: this.name, x, y, z };
+    if (typeof block === 'string') {
+      p.blockType = block;
+    } else {
+      p.blockType = block.type;
+      if (block.state && Object.keys(block.state).length > 0) p.state = block.state;
+    }
+    return post('world.setBlock', p, options);
+  }
+  setBlockSync(x: number, y: number, z: number, block: Block | string, options?: TaskOptions): void {
+    const p: Record<string, unknown> = { world: this.name, x, y, z };
+    if (typeof block === 'string') {
+      p.blockType = block;
+    } else {
+      p.blockType = block.type;
+      if (block.state && Object.keys(block.state).length > 0) p.state = block.state;
+    }
+    call('world.setBlock', p, options);
   }
   getEntities(options?: TaskOptions): Promise<string[]> {
     return post<string[]>('world.getEntities', { world: this.name }, options);