ice-web-components 1.0.0 → 1.1.0

package/dist/types/index.d.ts

@@ -108,4 +108,5 @@ export * from './model/ICEMinesweeperModel';
 export * from './model/ICETetrisModel';
 export * from './model/ICESnakeModel';
 export * from './model/ICEHighScoreModel';
+export * from './model/ICEChip8Model';
 export * from './model/ICE2048Model';

package/dist/types/model/ICEChip8Model.d.ts

@@ -0,0 +1,86 @@
+/**
+ * CHIP-8 虚拟机（纯逻辑，不碰 canvas）。
+ *
+ * 掌机的第四块卡带用它：前三个模型是"某款游戏的规则"，这是一个**真的微处理器模拟器**——
+ * 4KB 内存、16 个 8 位寄存器、16 位地址寄存器 I、64×32 单色显存、两个 60Hz 定时器、16 键键盘。
+ * 画面交给 `ICETileMap`（2048 格仍然只有 1 个节点）画，音效走掌机那套 WebAudio。
+ *
+ * 支持指令（跑 demo / 小 ROM 足够）：00E0 / 00EE / 1NNN / 2NNN / 3XNN / 4XNN / 5XY0 / 9XY0 /
+ * 6XNN / 7XNN / 8XY0-8XYE / 9XY0 / ANNN / BNNN / CXNN / DXYN / EX9E / EXA1 / FX07 / FX0A /
+ * FX15 / FX18 / FX1E / FX29 / FX33 / FX55 / FX65。
+ */
+export declare const ICE_CHIP8_KEYS: readonly ["1", "2", "3", "C", "4", "5", "6", "D", "7", "8", "9", "E", "A", "0", "B", "F"];
+/**
+ * 自带的 demo ROM（自写，不依赖任何外部 ROM，避开版权）。
+ *
+ * 它做的事：清屏 → 在 (V0,V1) 画一个 8×8 笑脸 → 按 (V2,V3) 走一步 → 撞到边就把速度取反 → 跳回清屏重画。
+ * 也就是**在屏幕里来回弹**的笑脸：既不会裂到对边，也把条件跳过（4XNN）、补码减法（7XNN / 6XNN 的 0xFE）
+ * 和自建循环这几条最常用的指令演了一遍。
+ * 地址：程序 0x200 起（20 条指令 = 40 字节），精灵数据在 0x228（8 字节）。
+ */
+export declare const ICE_CHIP8_DEMO_ROM: number[];
+export declare const ICE_CHIP8_WIDTH = 64;
+export declare const ICE_CHIP8_HEIGHT = 32;
+/** 状态变化通知（掌机外壳拿它驱动重绘，和另外三个游戏模型是同一套契约）。 */
+export declare type ICEChip8Listener = (model: ICEChip8Model) => void;
+export declare class ICEChip8Model {
+    private memory;
+    private v;
+    private i;
+    private pc;
+    private sp;
+    private stack;
+    private display;
+    private keys;
+    private delay;
+    private sound;
+    private cycles;
+    private random;
+    private paused;
+    /** 本条指令改了显存 → 执行完统一通知一次（别在 600 条/秒的频率上惊动渲染） */
+    private displayDirty;
+    private listeners;
+    /** FX0A 正在等按键时记住键位寄存器 */
+    private waitingForKey;
+    constructor(options?: {
+        random?: () => number;
+    });
+    getPC(): number;
+    getI(): number;
+    getV(index: number): number;
+    getDisplay(): Uint8Array;
+    getPixel(row: number, col: number): number;
+    getDelayTimer(): number;
+    getSoundTimer(): number;
+    getCycles(): number;
+    isWaitingForKey(): boolean;
+    memoryRead(address: number): number;
+    isKeyDown(index: number): boolean;
+    /** 暂停中（调试/切走标签页）：`step()` 与 `tickTimers()` 都不推进。 */
+    isPaused(): boolean;
+    /** VM 没有"输赢"，但掌机外壳按统一契约询问，这里老实回答"没结束"。 */
+    isGameOver(): boolean;
+    pause(): void;
+    resume(): void;
+    /**
+     * 订阅状态变化：显存画了新东西、按键变了、定时器走了、机器复位了都会通知。
+     * 返回取消订阅的函数（和其它模型一致）。
+     */
+    addChangeListener(listener: ICEChip8Listener): () => void;
+    loadProgram(bytes: ArrayLike<number>, address?: number): void;
+    memoryWrite(address: number, value: number): void;
+    setKey(index: number, down: boolean): void;
+    /** 清掉所有按键（切卡带/失焦时用）。 */
+    clearKeys(): void;
+    setVForTest(index: number, value: number): void;
+    reset(): void;
+    /** 60Hz：递减延时/声音定时器。 */
+    tickTimers(): void;
+    /** 执行一条指令（FX0A 等按键时 PC 不动，直接返回）。 */
+    step(): void;
+    private notify;
+    private __alu;
+    /** DXYN：按位异或画精灵；撞到亮点就把 VF 置 1。 */
+    private __draw;
+    private __misc;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ice-web-components",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Swing-style Canvas UI components built on ice-render.",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",