ice-web-components 1.2.0 → 1.3.0

package/dist/types/components/ICELabel.d.ts

@@ -8,6 +8,14 @@ export declare class ICELabel extends ICEWidget {
     constructor(props?: any);
     setText(text: string): this;
     getText(): string;
+    /**
+     * 改文字颜色（动态强调 / 置灰用，比如 BIOS 自检行的灰→黄→绿、菜单选中态）。
+     *
+     * 必须走内层 `ICEText`：文字是它画的，构造期 `style` 已经下沉到那一层，
+     * 之后再 `setState({ style })` 只会改到外壳容器，屏幕上的字纹丝不动。
+     * 只覆盖 `fillStyle`，字号 / 字体 / 对齐这些原样保留。
+     */
+    setTextColor(color: string): this;
     /**
      * 让标签自身占据文字的实测尺寸。
      *

package/dist/types/index.d.ts

@@ -112,3 +112,4 @@ export * from './model/ICEChip8Model';
 export * from './model/ICE2048Model';
 export * from './model/ICEHistoryModel';
 export * from './model/ICEPixelModel';
+export * from './model/ICEBiosModel';

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

@@ -0,0 +1,124 @@
+/**
+ * 掌机 BIOS 的纯逻辑（不碰 canvas、不碰 DOM）。
+ *
+ * 掌机开机先跑一段「自检 → 菜单」的引导，然后才把控制权交给卡带：
+ * 自检**按时序推进**（页面每帧调 `tick(dt)`），菜单是**光标 + 确认**的老式控制台交互。
+ * 页面只负责把 `getSteps()` / `getMenuEntries()` 画成文字，并执行 `confirm()` 返回的动作 ——
+ * 状态机与渲染分开，所以「自检要跑多久、菜单怎么绕、设置存到哪」都能在 node 里单测。
+ *
+ * 约定：
+ * - 自检项由 `steps` 注入（默认 5 项：CPU / RAM / VRAM / SOUND / CART），每项有自己的耗时；
+ * - 相位机：`post`（自检中）→ `menu`（启动菜单）或 `boot`（直接启动，快速启动开着时）；
+ *   `settings`（设置页）从菜单进、`back()` 回菜单；
+ * - 菜单光标上下**循环**（到头绕回去，老式 BIOS 都这样），进设置前记下位置、回来还停在那儿；
+ * - 设置（快速启动 / 默认卡带）落到注入的存储里；坏数据、写盘失败一律降级，绝不抛。
+ */
+export declare type ICEBiosPhase = 'post' | 'menu' | 'settings' | 'boot';
+export interface ICEBiosStep {
+    /** 稳定 key（页面拿它做节点 id / 维护增量更新） */
+    key: string;
+    label: string;
+    detail: string;
+    /** 这一项「检测」要花多久（毫秒） */
+    duration: number;
+}
+export interface ICEBiosStepState extends ICEBiosStep {
+    state: 'pending' | 'running' | 'ok';
+    /** 当前项的进度 0..1；非当前项是 0 或 1 */
+    progress: number;
+}
+export interface ICEBiosCartridge {
+    key: string;
+    label: string;
+}
+export interface ICEBiosMenuEntry {
+    key: string;
+    label: string;
+    type: 'cartridge' | 'settings' | 'boot';
+}
+export interface ICEBiosSettings {
+    /** 开着就跳过菜单直接启动默认卡带（开机自检还是要跑） */
+    quickBoot: boolean;
+    defaultCartridge: string;
+}
+export declare type ICEBiosAction = {
+    type: 'boot';
+    cartridge: string;
+} | {
+    type: 'settings';
+} | {
+    type: 'menu';
+} | {
+    type: 'none';
+};
+export interface ICEBiosStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export interface ICEBiosOptions {
+    cartridges: ICEBiosCartridge[];
+    /** 自检项，默认 `ICE_BIOS_DEFAULT_STEPS` */
+    steps?: ICEBiosStep[];
+    /** 初始设置（优先级低于存储里的值） */
+    settings?: Partial<ICEBiosSettings>;
+    /** 存储实现；传 null 表示只放内存；不传则用 globalThis.localStorage（没有就退化成内存） */
+    storage?: ICEBiosStorage | null;
+    /** 存储键前缀，默认 `ice-arcade-bios-` */
+    prefix?: string;
+}
+export declare type ICEBiosListener = (model: ICEBiosModel) => void;
+/** 默认自检项：每一项都是一句「老式 BIOS 会印在屏幕上的话」。 */
+export declare const ICE_BIOS_DEFAULT_STEPS: ICEBiosStep[];
+export declare class ICEBiosModel {
+    private steps;
+    private cartridges;
+    private storage;
+    private storageKey;
+    private listeners;
+    private phase;
+    private elapsed;
+    private cursor;
+    private cursorBeforeSettings;
+    private settings;
+    constructor(options: ICEBiosOptions);
+    getPhase(): ICEBiosPhase;
+    getCartridges(): ICEBiosCartridge[];
+    getPostElapsed(): number;
+    /** 自检总时长（毫秒）。 */
+    getPostDuration(): number;
+    /** 自检进度 0..1（按时间算，页面拿它画进度条）。 */
+    getPostProgress(): number;
+    /** 自检项与它们此刻的状态（当前项 running、前面的 ok）。 */
+    getSteps(): ICEBiosStepState[];
+    /** 菜单项：卡带列表 + 设置 + 退出并启动。 */
+    getMenuEntries(): ICEBiosMenuEntry[];
+    getCursor(): number;
+    getSelectedEntry(): ICEBiosMenuEntry | null;
+    getSettings(): ICEBiosSettings;
+    isQuickBoot(): boolean;
+    getDefaultCartridge(): string;
+    /** 推进自检（页面每帧调用），返回是否发生了变化。 */
+    tick(delta: number): boolean;
+    moveCursor(delta: number): void;
+    setCursor(index: number): void;
+    /** 确认当前项：只返回动作，执行动作是页面的事（好测）。 */
+    confirm(): ICEBiosAction;
+    /** 返回上一层（设置 → 菜单）。 */
+    back(): void;
+    /** 从游戏里回到 BIOS 菜单（掌机的「复位」）。 */
+    openMenu(): void;
+    /** 重新跑一遍自检（再开一次机）。 */
+    restart(): void;
+    toggleQuickBoot(): boolean;
+    setDefaultCartridge(key: string): void;
+    addChangeListener(listener: ICEBiosListener): () => void;
+    private __alignCursorToDefault;
+    /** 卡带 key 必须真的存在，否则回退到第一个卡带。 */
+    private __normalizeCartridge;
+    private __load;
+    private __readStorage;
+    private __save;
+    private __defaultStorage;
+    private notify;
+}
+export default ICEBiosModel;

package/package.json

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