even-toolkit 0.1.0 → 0.2.0

package/dist/splash.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Splash screen system for G2 glasses apps.
+ *
+ * Renders a canvas-based splash image to G2 image tiles with configurable
+ * timing, tile layout, and a render callback for app-specific graphics.
+ *
+ * Usage:
+ *   const splash = createSplash({
+ *     render: (ctx, w, h) => {
+ *       ctx.fillStyle = '#000';
+ *       ctx.fillRect(0, 0, w, h);
+ *       ctx.fillStyle = '#e0e0e0';
+ *       ctx.font = 'bold 16px monospace';
+ *       ctx.textAlign = 'center';
+ *       ctx.fillText('MyApp', w/2, h/2);
+ *     },
+ *     tiles: 1,
+ *     minTimeMs: 2000,
+ *   });
+ *
+ *   // In your bootstrap:
+ *   await splash.show(bridge);
+ *   // ... init your app ...
+ *   await splash.waitMinTime();
+ *   // Now safe to switch to app UI
+ */
+export interface SplashConfig {
+    /**
+     * Render callback — draw your splash on the provided canvas context.
+     * The canvas is pre-filled with black.
+     *
+     * @param ctx  Canvas 2D context
+     * @param w    Canvas width in pixels
+     * @param h    Canvas height in pixels
+     */
+    render: (ctx: CanvasRenderingContext2D, w: number, h: number) => void;
+    /**
+     * Number of image tiles to use (1-3).
+     * - 1: single 200x100 tile (left-aligned)
+     * - 2: 400x100 across 2 tiles
+     * - 3: 576x100 across 3 tiles (full width)
+     * Default: 1
+     */
+    tiles?: 1 | 2 | 3;
+    /**
+     * Minimum time the splash should be visible (ms).
+     * `waitMinTime()` will delay until this time has passed since `show()`.
+     * Default: 2000
+     */
+    minTimeMs?: number;
+    /**
+     * Maximum time before the splash is forcefully dismissed (ms).
+     * Set to 0 for no max. Default: 5000
+     */
+    maxTimeMs?: number;
+    /**
+     * Menu text shown below the image (in the text container).
+     * Default: empty string (hidden)
+     */
+    menuText?: string;
+}
+export interface SplashHandle {
+    /** Show the splash on the glasses. Returns when the image is sent. */
+    show: (bridge: SplashBridge) => Promise<void>;
+    /** Wait until minTimeMs has elapsed since show(). Resolves immediately if already elapsed. */
+    waitMinTime: () => Promise<void>;
+    /** Check if the splash is currently showing. */
+    isShowing: () => boolean;
+    /** Get encoded tile data (for apps that manage their own bridge). */
+    getTiles: () => {
+        id: number;
+        name: string;
+        bytes: Uint8Array;
+    }[];
+}
+/** Minimal bridge interface needed for splash (subset of EvenHubBridge). */
+export interface SplashBridge {
+    showHomePage: (menuText: string) => Promise<void>;
+    sendImage: (containerId: number, containerName: string, pngBytes: Uint8Array) => Promise<void>;
+}
+export declare function createSplash(config: SplashConfig): SplashHandle;
+//# sourceMappingURL=splash.d.ts.map

package/dist/splash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splash.d.ts","sourceRoot":"","sources":["../splash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,MAAM,WAAW,YAAY;IAC3B;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,wBAAwB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtE;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,8FAA8F;IAC9F,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,qEAAqE;IACrE,QAAQ,EAAE,MAAM;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;CACnE;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA4F/D"}

package/dist/splash.js

@@ -0,0 +1,108 @@
+/**
+ * Splash screen system for G2 glasses apps.
+ *
+ * Renders a canvas-based splash image to G2 image tiles with configurable
+ * timing, tile layout, and a render callback for app-specific graphics.
+ *
+ * Usage:
+ *   const splash = createSplash({
+ *     render: (ctx, w, h) => {
+ *       ctx.fillStyle = '#000';
+ *       ctx.fillRect(0, 0, w, h);
+ *       ctx.fillStyle = '#e0e0e0';
+ *       ctx.font = 'bold 16px monospace';
+ *       ctx.textAlign = 'center';
+ *       ctx.fillText('MyApp', w/2, h/2);
+ *     },
+ *     tiles: 1,
+ *     minTimeMs: 2000,
+ *   });
+ *
+ *   // In your bootstrap:
+ *   await splash.show(bridge);
+ *   // ... init your app ...
+ *   await splash.waitMinTime();
+ *   // Now safe to switch to app UI
+ */
+import { G2_IMAGE_MAX_W, G2_IMAGE_MAX_H, IMAGE_TILES } from './layout';
+import { encodeTilesBatch } from './png-utils';
+export function createSplash(config) {
+    const tiles = config.tiles ?? 1;
+    const minTime = config.minTimeMs ?? 2000;
+    const maxTime = config.maxTimeMs ?? 5000;
+    const menuText = config.menuText ?? '';
+    let showTime = 0;
+    let showing = false;
+    let encodedTiles = [];
+    // Render canvas and encode tiles
+    function renderAndEncode() {
+        const tileW = G2_IMAGE_MAX_W; // 200
+        const tileH = G2_IMAGE_MAX_H; // 100
+        const canvasW = tiles * tileW;
+        const canvasH = tileH;
+        const canvas = document.createElement('canvas');
+        canvas.width = canvasW;
+        canvas.height = canvasH;
+        const ctx = canvas.getContext('2d');
+        // Black background
+        ctx.fillStyle = '#000000';
+        ctx.fillRect(0, 0, canvasW, canvasH);
+        // App-specific rendering
+        config.render(ctx, canvasW, canvasH);
+        // Encode each tile
+        encodedTiles = [];
+        for (let i = 0; i < tiles; i++) {
+            const slot = IMAGE_TILES[i];
+            const crop = { sx: i * tileW, sy: 0, sw: tileW, sh: tileH };
+            const enc = encodeTilesBatch(canvas, [{ crop, name: slot.name }], tileW, tileH)[0];
+            encodedTiles.push({ id: slot.id, name: slot.name, bytes: enc.bytes });
+        }
+        // Fill remaining tiles with black
+        if (tiles < 3) {
+            const black = document.createElement('canvas');
+            black.width = tileW;
+            black.height = tileH;
+            const bctx = black.getContext('2d');
+            bctx.fillStyle = '#000000';
+            bctx.fillRect(0, 0, tileW, tileH);
+            const blackEnc = encodeTilesBatch(black, [{ crop: { sx: 0, sy: 0, sw: tileW, sh: tileH }, name: 'black' }], tileW, tileH)[0];
+            for (let i = tiles; i < 3; i++) {
+                const slot = IMAGE_TILES[i];
+                encodedTiles.push({ id: slot.id, name: slot.name, bytes: blackEnc.bytes });
+            }
+        }
+    }
+    return {
+        async show(bridge) {
+            renderAndEncode();
+            showTime = Date.now();
+            showing = true;
+            // Show the home layout (image + optional text below)
+            await bridge.showHomePage(menuText);
+            // Send all tiles
+            for (const tile of encodedTiles) {
+                await bridge.sendImage(tile.id, tile.name, tile.bytes);
+            }
+            // Auto-dismiss after maxTime
+            if (maxTime > 0) {
+                setTimeout(() => { showing = false; }, maxTime);
+            }
+        },
+        async waitMinTime() {
+            const elapsed = Date.now() - showTime;
+            if (elapsed < minTime) {
+                await new Promise((r) => setTimeout(r, minTime - elapsed));
+            }
+            showing = false;
+        },
+        isShowing() {
+            return showing;
+        },
+        getTiles() {
+            if (encodedTiles.length === 0)
+                renderAndEncode();
+            return encodedTiles;
+        },
+    };
+}
+//# sourceMappingURL=splash.js.map

package/dist/splash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splash.js","sourceRoot":"","sources":["../splash.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "even-toolkit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Shared library for building Even Realities G2 glasses apps — bridge, display, gestures, action bars, timers, and more.",
   "type": "module",
   "main": "./dist/index.js",
@@ -69,6 +69,10 @@
     "./keep-alive": {
       "types": "./dist/keep-alive.d.ts",
       "import": "./dist/keep-alive.js"
+    },
+    "./splash": {
+      "types": "./dist/splash.d.ts",
+      "import": "./dist/splash.js"
     }
   },
   "files": [