even-toolkit 0.1.0

package/dist/text-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared text utilities for G2 glasses display.
+ */
+/** Truncate text to maxLen, appending ~ if truncated */
+export declare function truncate(text: string, maxLen: number): string;
+/** Up arrow scroll indicator */
+export declare const SCROLL_UP = "\u25B2";
+/** Down arrow scroll indicator */
+export declare const SCROLL_DOWN = "\u25BC";
+/**
+ * Build a header line with title on the left and action bar on the right.
+ *
+ * @param title     Left-side text (e.g. "Step 1/4: Toast the pepper")
+ * @param actionBar Right-side action bar string from buildActionBar()
+ */
+export declare function buildHeaderLine(title: string, actionBar: string): string;
+/**
+ * Apply scroll indicators to a windowed line array.
+ * Replaces the first/last visible line with ▲/▼ if there's more content above/below.
+ *
+ * @param lines       The visible lines array (will be mutated)
+ * @param start       Start index into the full content
+ * @param totalCount  Total number of content lines
+ * @param visibleCount Number of visible lines in the window
+ * @param lineFactory Function to create a DisplayLine (e.g. `(text) => line(text, 'meta', false)`)
+ */
+export declare function applyScrollIndicators<T>(lines: T[], start: number, totalCount: number, visibleCount: number, lineFactory: (text: string) => T): void;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../text-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,gCAAgC;AAChC,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,kCAAkC;AAClC,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,GAC/B,IAAI,CAQN"}

package/dist/text-utils.js

@@ -0,0 +1,41 @@
+/**
+ * Shared text utilities for G2 glasses display.
+ */
+/** Truncate text to maxLen, appending ~ if truncated */
+export function truncate(text, maxLen) {
+    return text.length > maxLen ? text.slice(0, maxLen - 1) + '~' : text;
+}
+/** Up arrow scroll indicator */
+export const SCROLL_UP = '\u25B2'; // ▲
+/** Down arrow scroll indicator */
+export const SCROLL_DOWN = '\u25BC'; // ▼
+/**
+ * Build a header line with title on the left and action bar on the right.
+ *
+ * @param title     Left-side text (e.g. "Step 1/4: Toast the pepper")
+ * @param actionBar Right-side action bar string from buildActionBar()
+ */
+export function buildHeaderLine(title, actionBar) {
+    return `${title}  ${actionBar}`;
+}
+/**
+ * Apply scroll indicators to a windowed line array.
+ * Replaces the first/last visible line with ▲/▼ if there's more content above/below.
+ *
+ * @param lines       The visible lines array (will be mutated)
+ * @param start       Start index into the full content
+ * @param totalCount  Total number of content lines
+ * @param visibleCount Number of visible lines in the window
+ * @param lineFactory Function to create a DisplayLine (e.g. `(text) => line(text, 'meta', false)`)
+ */
+export function applyScrollIndicators(lines, start, totalCount, visibleCount, lineFactory) {
+    if (lines.length === 0)
+        return;
+    if (start > 0) {
+        lines[0] = lineFactory(SCROLL_UP);
+    }
+    if (start + visibleCount < totalCount) {
+        lines[lines.length - 1] = lineFactory(SCROLL_DOWN);
+    }
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/text-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.js","sourceRoot":"","sources":["../text-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wDAAwD;AACxD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc;IACnD,OAAO,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAE,IAAI;AAExC,kCAAkC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAE,IAAI;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,SAAiB;IAC9D,OAAO,GAAG,KAAK,KAAK,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAU,EACV,KAAa,EACb,UAAkB,EAClB,YAAoB,EACpB,WAAgC;IAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,GAAG,YAAY,GAAG,UAAU,EAAE,CAAC;QACtC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/timer-display.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Unicode timer display for G2 glasses.
+ *
+ * Confirmed working on G2:  █ (full block), ─ (box drawing horizontal)
+ * NOT working on G2:  ░ ▒ ▓ (shading), ╔═╗║ (double box drawing), ▀▄ (half blocks)
+ *
+ * Renders as 2 lines — text centered using ─ padding to match bar width:
+ *      ─────── ▶  06:44 ───────
+ *      ████████████────────────
+ */
+export interface TimerState {
+    running: boolean;
+    remaining: number;
+    total: number;
+}
+/**
+ * Render a 2-line timer display for the G2 glasses.
+ * Line 1: ─── icon  MM:SS ─── (centered with ─ filler, same visual width as bar)
+ * Line 2: ████████████──────── (progress bar)
+ *
+ * @param timer    Current timer state
+ * @param barWidth Number of characters for the progress bar (default 24)
+ */
+export declare function renderTimerLines(timer: TimerState, barWidth?: number): string[];
+/**
+ * Render a single-line compact timer (for tight spaces).
+ */
+export declare function renderTimerCompact(timer: TimerState): string;
+//# sourceMappingURL=timer-display.d.ts.map

package/dist/timer-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer-display.d.ts","sourceRoot":"","sources":["../timer-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAcD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,SAAK,GAAG,MAAM,EAAE,CA4B3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAa5D"}

package/dist/timer-display.js

@@ -0,0 +1,74 @@
+/**
+ * Unicode timer display for G2 glasses.
+ *
+ * Confirmed working on G2:  █ (full block), ─ (box drawing horizontal)
+ * NOT working on G2:  ░ ▒ ▓ (shading), ╔═╗║ (double box drawing), ▀▄ (half blocks)
+ *
+ * Renders as 2 lines — text centered using ─ padding to match bar width:
+ *      ─────── ▶  06:44 ───────
+ *      ████████████────────────
+ */
+const BLOCK_FULL = '\u2588'; // █  (filled portion)
+const LINE_THIN = '\u2500'; // ─  (remaining portion + centering filler)
+const ICON_PLAY = '\u25B6'; // ▶
+const ICON_PAUSE = '\u2588'; // █  (single block for paused)
+const ICON_DONE = 'OK';
+const ICON_IDLE = '--';
+function formatTime(seconds) {
+    const m = Math.floor(seconds / 60);
+    const s = seconds % 60;
+    return `${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`;
+}
+/** Center text above bar — spaces are ~4.5x narrower than █/─ on G2 font */
+function center(text, barWidth) {
+    const pad = Math.max(0, Math.floor((barWidth - text.length) / 2));
+    return ' '.repeat(Math.round(pad * 6.7)) + text;
+}
+/**
+ * Render a 2-line timer display for the G2 glasses.
+ * Line 1: ─── icon  MM:SS ─── (centered with ─ filler, same visual width as bar)
+ * Line 2: ████████████──────── (progress bar)
+ *
+ * @param timer    Current timer state
+ * @param barWidth Number of characters for the progress bar (default 24)
+ */
+export function renderTimerLines(timer, barWidth = 18) {
+    const { running, remaining, total } = timer;
+    if (total === 0 && remaining === 0) {
+        return [
+            center(` ${ICON_IDLE}  00:00 `, barWidth),
+            LINE_THIN.repeat(barWidth),
+        ];
+    }
+    if (remaining <= 0 && total > 0) {
+        return [
+            center(` ${ICON_DONE}  00:00 `, barWidth),
+            BLOCK_FULL.repeat(barWidth),
+        ];
+    }
+    const icon = running ? ICON_PLAY : ICON_PAUSE;
+    const time = formatTime(remaining);
+    const progress = total > 0 ? (total - remaining) / total : 0;
+    const filled = Math.round(progress * barWidth);
+    const empty = barWidth - filled;
+    const bar = BLOCK_FULL.repeat(filled) + LINE_THIN.repeat(empty);
+    return [
+        center(` ${icon}  ${time} `, barWidth),
+        bar,
+    ];
+}
+/**
+ * Render a single-line compact timer (for tight spaces).
+ */
+export function renderTimerCompact(timer) {
+    const { running, remaining, total } = timer;
+    if (total === 0 && remaining === 0) {
+        return `${ICON_IDLE} 00:00`;
+    }
+    if (remaining <= 0 && total > 0) {
+        return `${ICON_DONE} DONE`;
+    }
+    const icon = running ? ICON_PLAY : ICON_PAUSE;
+    return `${icon} ${formatTime(remaining)}`;
+}
+//# sourceMappingURL=timer-display.js.map

package/dist/timer-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer-display.js","sourceRoot":"","sources":["../timer-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAK,sBAAsB;AACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAM,4CAA4C;AAC7E,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAM,IAAI;AACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAK,+BAA+B;AAChE,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,IAAI,CAAC;AAQvB,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,OAAO,GAAG,EAAE,CAAC;IACvB,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,4EAA4E;AAC5E,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,QAAQ,GAAG,EAAE;IAC/D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAE5C,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,MAAM,CAAC,IAAI,SAAS,UAAU,EAAE,QAAQ,CAAC;YACzC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,MAAM,CAAC,IAAI,SAAS,UAAU,EAAE,QAAQ,CAAC;YACzC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhE,OAAO;QACL,MAAM,CAAC,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,QAAQ,CAAC;QACtC,GAAG;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAE5C,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,GAAG,SAAS,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,SAAS,OAAO,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9C,OAAO,GAAG,IAAI,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export type LineStyle = 'normal' | 'meta' | 'separator' | 'inverted';
+export interface DisplayLine {
+    text: string;
+    inverted: boolean;
+    style: LineStyle;
+}
+export interface DisplayData {
+    lines: DisplayLine[];
+}
+export declare function line(text: string, style?: LineStyle, inverted?: boolean): DisplayLine;
+export declare function separator(): DisplayLine;
+export interface ColumnData {
+    /** One string per column — each column is a separate text container at a fixed pixel position */
+    columns: string[];
+}
+export interface ImageTileData {
+    tiles: {
+        id: number;
+        name: string;
+        bytes: Uint8Array;
+    }[];
+    /** Text shown below images (or empty for no-bounce overlay) */
+    text?: string;
+}
+export type PageMode = 'splash' | 'text' | 'columns' | 'home' | 'chart';
+export type GlassActionType = 'HIGHLIGHT_MOVE' | 'SELECT_HIGHLIGHTED' | 'GO_BACK';
+export type GlassAction = {
+    type: 'HIGHLIGHT_MOVE';
+    direction: 'up' | 'down';
+} | {
+    type: 'SELECT_HIGHLIGHTED';
+} | {
+    type: 'GO_BACK';
+};
+export interface GlassNavState {
+    highlightedIndex: number;
+    screen: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,SAAoB,EAAE,QAAQ,UAAQ,GAAG,WAAW,CAE7F;AAED,wBAAgB,SAAS,IAAI,WAAW,CAEvC;AAID,MAAM,WAAW,UAAU;IACzB,iGAAiG;IACjG,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IACzD,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,OAAO,CAAC;AAIZ,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,SAAS,CAAC;AAElF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+// ── Display line types (legacy, still used for single-text pages) ──
+export function line(text, style = 'normal', inverted = false) {
+    return { text, inverted, style };
+}
+export function separator() {
+    return { text: '', inverted: false, style: 'separator' };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AActE,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,QAAmB,QAAQ,EAAE,QAAQ,GAAG,KAAK;IAC9E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAC3D,CAAC"}

package/dist/useFlashPhase.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared flash phase hook for blinking action button indicators.
+ * Toggles a boolean every 500ms when active.
+ *
+ * Usage:
+ *   const flashPhase = useFlashPhase(isInActiveMode);
+ */
+export declare function useFlashPhase(active: boolean): boolean;
+//# sourceMappingURL=useFlashPhase.d.ts.map

package/dist/useFlashPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlashPhase.d.ts","sourceRoot":"","sources":["../useFlashPhase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAiBtD"}

package/dist/useFlashPhase.js

@@ -0,0 +1,24 @@
+/**
+ * Shared flash phase hook for blinking action button indicators.
+ * Toggles a boolean every 500ms when active.
+ *
+ * Usage:
+ *   const flashPhase = useFlashPhase(isInActiveMode);
+ */
+import { useState, useEffect } from 'react';
+const FLASH_INTERVAL_MS = 500;
+export function useFlashPhase(active) {
+    const [phase, setPhase] = useState(false);
+    useEffect(() => {
+        if (!active) {
+            setPhase(false);
+            return;
+        }
+        const interval = setInterval(() => {
+            setPhase((prev) => !prev);
+        }, FLASH_INTERVAL_MS);
+        return () => clearInterval(interval);
+    }, [active]);
+    return phase;
+}
+//# sourceMappingURL=useFlashPhase.js.map

package/dist/useFlashPhase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFlashPhase.js","sourceRoot":"","sources":["../useFlashPhase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAEtB,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/useGlasses.d.ts

@@ -0,0 +1,18 @@
+import type { DisplayData, GlassAction, GlassNavState, ColumnData } from './types';
+import { type ColumnConfig } from './bridge';
+export interface UseGlassesConfig<S> {
+    getSnapshot: () => S;
+    /** Convert snapshot to single text display (for 'text' mode) */
+    toDisplayData: (snapshot: S, nav: GlassNavState) => DisplayData;
+    /** Convert snapshot to column data (for 'columns' mode) — optional */
+    toColumns?: (snapshot: S, nav: GlassNavState) => ColumnData;
+    onGlassAction: (action: GlassAction, nav: GlassNavState, snapshot: S) => GlassNavState;
+    deriveScreen: (path: string) => string;
+    appName: string;
+    /** Page mode per screen — return 'text' or 'columns'. Default: 'text' */
+    getPageMode?: (screen: string) => 'text' | 'columns';
+    /** Column layout config — default: 3 equal columns across 576px */
+    columns?: ColumnConfig[];
+}
+export declare function useGlasses<S>(config: UseGlassesConfig<S>): void;
+//# sourceMappingURL=useGlasses.d.ts.map

package/dist/useGlasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlasses.d.ts","sourceRoot":"","sources":["../useGlasses.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnF,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAK5D,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,gEAAgE;IAChE,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,KAAK,WAAW,CAAC;IAChE,sEAAsE;IACtE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,KAAK,UAAU,CAAC;IAC5D,aAAa,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,aAAa,CAAC;IACvF,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CA4I/D"}

package/dist/useGlasses.js

@@ -0,0 +1,143 @@
+import { useEffect, useRef, useCallback } from 'react';
+import { useLocation, useNavigate } from 'react-router';
+import { EvenHubBridge } from './bridge';
+import { mapGlassEvent } from './action-map';
+import { bindKeyboard } from './keyboard';
+import { activateKeepAlive, deactivateKeepAlive } from './keep-alive';
+export function useGlasses(config) {
+    const location = useLocation();
+    const navigate = useNavigate();
+    const hubRef = useRef(null);
+    const navRef = useRef({ highlightedIndex: 0, screen: '' });
+    const lastSnapshotRef = useRef(null);
+    const sendingRef = useRef(false);
+    const pendingRef = useRef(false);
+    const navigateRef = useRef(navigate);
+    navigateRef.current = navigate;
+    const configRef = useRef(config);
+    configRef.current = config;
+    const sendDisplay = useCallback(async () => {
+        if (sendingRef.current || !hubRef.current) {
+            // Queue a retry — the current in-flight send has stale data
+            pendingRef.current = true;
+            return;
+        }
+        sendingRef.current = true;
+        pendingRef.current = false;
+        try {
+            const hub = hubRef.current;
+            const snapshot = configRef.current.getSnapshot();
+            const nav = navRef.current;
+            const getMode = configRef.current.getPageMode ?? (() => 'text');
+            const mode = getMode(nav.screen);
+            if (mode === 'columns' && configRef.current.toColumns) {
+                const cols = configRef.current.toColumns(snapshot, nav);
+                if (hub.currentMode === 'columns') {
+                    await hub.updateColumns(cols.columns);
+                }
+                else {
+                    await hub.showColumnPage(cols.columns);
+                }
+            }
+            else {
+                const data = configRef.current.toDisplayData(snapshot, nav);
+                const text = data.lines.map(l => {
+                    if (l.style === 'separator')
+                        return '\u2500'.repeat(44);
+                    if (l.inverted)
+                        return `\u25B6 ${l.text}`;
+                    return `  ${l.text}`;
+                }).join('\n');
+                if (hub.currentMode === 'text') {
+                    await hub.updateText(text);
+                }
+                else {
+                    await hub.showTextPage(text);
+                }
+            }
+        }
+        catch {
+            // SDK unavailable — glasses panel won't update, web still works
+        }
+        finally {
+            sendingRef.current = false;
+            // If a send was queued while we were busy, flush again with fresh data
+            if (pendingRef.current) {
+                pendingRef.current = false;
+                sendDisplay();
+            }
+        }
+    }, []);
+    const flushDisplay = useCallback(() => {
+        sendDisplay();
+    }, [sendDisplay]);
+    const handleAction = useCallback((action) => {
+        const snapshot = configRef.current.getSnapshot();
+        const newNav = configRef.current.onGlassAction(action, navRef.current, snapshot);
+        navRef.current = newNav;
+        flushDisplay();
+    }, [flushDisplay]);
+    // Update screen from URL changes
+    useEffect(() => {
+        const newScreen = configRef.current.deriveScreen(location.pathname);
+        if (newScreen !== navRef.current.screen) {
+            navRef.current = { highlightedIndex: 0, screen: newScreen };
+            flushDisplay();
+        }
+    }, [location.pathname, flushDisplay]);
+    // Initialize bridge, keyboard, keep-alive, and polling
+    useEffect(() => {
+        let pollTimer = null;
+        let disposed = false;
+        const hub = new EvenHubBridge(configRef.current.columns);
+        hubRef.current = hub;
+        navRef.current = {
+            highlightedIndex: 0,
+            screen: configRef.current.deriveScreen(location.pathname),
+        };
+        async function initBridge() {
+            try {
+                await hub.init();
+                if (disposed)
+                    return;
+                // Show initial splash text
+                await hub.showTextPage(`\n\n      ${configRef.current.appName}`);
+                if (disposed)
+                    return;
+                hub.onEvent((event) => {
+                    const action = mapGlassEvent(event);
+                    if (action)
+                        handleAction(action);
+                });
+            }
+            catch {
+                // SDK not available — app continues without glasses
+            }
+            // Start polling for state changes
+            if (!disposed) {
+                flushDisplay();
+                pollTimer = setInterval(() => {
+                    const snapshot = configRef.current.getSnapshot();
+                    if (snapshot !== lastSnapshotRef.current) {
+                        lastSnapshotRef.current = snapshot;
+                        flushDisplay();
+                    }
+                }, 100);
+            }
+        }
+        initBridge();
+        const unbindKeyboard = bindKeyboard(handleAction);
+        activateKeepAlive(`${configRef.current.appName}_keep_alive`);
+        return () => {
+            disposed = true;
+            if (pollTimer)
+                clearInterval(pollTimer);
+            unbindKeyboard();
+            hub.dispose();
+            hubRef.current = null;
+            deactivateKeepAlive();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+}
+//# sourceMappingURL=useGlasses.js.map

package/dist/useGlasses.js.map

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

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "even-toolkit",
+  "version": "0.1.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",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge.d.ts",
+      "import": "./dist/bridge.js"
+    },
+    "./useGlasses": {
+      "types": "./dist/useGlasses.d.ts",
+      "import": "./dist/useGlasses.js"
+    },
+    "./useFlashPhase": {
+      "types": "./dist/useFlashPhase.d.ts",
+      "import": "./dist/useFlashPhase.js"
+    },
+    "./action-bar": {
+      "types": "./dist/action-bar.d.ts",
+      "import": "./dist/action-bar.js"
+    },
+    "./action-map": {
+      "types": "./dist/action-map.d.ts",
+      "import": "./dist/action-map.js"
+    },
+    "./gestures": {
+      "types": "./dist/gestures.d.ts",
+      "import": "./dist/gestures.js"
+    },
+    "./keyboard": {
+      "types": "./dist/keyboard.d.ts",
+      "import": "./dist/keyboard.js"
+    },
+    "./timer-display": {
+      "types": "./dist/timer-display.d.ts",
+      "import": "./dist/timer-display.js"
+    },
+    "./text-utils": {
+      "types": "./dist/text-utils.d.ts",
+      "import": "./dist/text-utils.js"
+    },
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "import": "./dist/layout.js"
+    },
+    "./canvas-renderer": {
+      "types": "./dist/canvas-renderer.d.ts",
+      "import": "./dist/canvas-renderer.js"
+    },
+    "./composer": {
+      "types": "./dist/composer.d.ts",
+      "import": "./dist/composer.js"
+    },
+    "./png-utils": {
+      "types": "./dist/png-utils.d.ts",
+      "import": "./dist/png-utils.js"
+    },
+    "./keep-alive": {
+      "types": "./dist/keep-alive.d.ts",
+      "import": "./dist/keep-alive.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-router": ">=7.0.0",
+    "@evenrealities/even_hub_sdk": ">=0.0.7",
+    "@jappyjan/even-better-sdk": ">=0.0.10"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true },
+    "react-router": { "optional": true }
+  },
+  "devDependencies": {
+    "@evenrealities/even_hub_sdk": "^0.0.7",
+    "@jappyjan/even-better-sdk": "^0.0.10",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "react-router": "^7.0.0",
+    "typescript": "~5.4.0"
+  },
+  "keywords": [
+    "even-realities",
+    "g2-glasses",
+    "smart-glasses",
+    "ar",
+    "wearable",
+    "even-hub"
+  ],
+  "author": "fabioglimb",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fabioglimb/even-glass"
+  }
+}