even-toolkit 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 1.5.0
+
+Released: 2026-03-31
+
+No breaking changes.
+
+### Added
+
+- new glasses helpers `glass-format` and `glass-chat-display`
+- new web `MultiSelect` component export
+- README refresh to reflect the current published surface area
+
+### Changed
+
+- action bar hover/active triangle semantics now match the latest glasses UX
+- glasses gesture handling is more reliable for settings editing and immediate scroll changes
+- Deepgram STT shutdown noise is suppressed during intentional close
+- dialog background scroll locking is stronger on web/touch devices
+- swipe-to-delete rows now support loading feedback through the shared list item
+- SVG navigate icon now inherits current color correctly for dark buttons
+
+### Notes
+
+- This release is backward compatible with existing 1.4.x imports.
+- Consumers can upgrade without code changes unless they were depending on old visual bugs.

package/README.md

@@ -28,9 +28,9 @@ npx create-even-app my-app
 import { Button, Card, NavBar, ListItem, Toggle, AppShell } from 'even-toolkit/web';
 ```
 
-**Primitives:** Button, Card, Badge, Input, Textarea, Select, Checkbox, RadioGroup, Slider, InputGroup, Skeleton, Progress, StatusDot, Pill, Toggle, SegmentedControl, Table, Kbd, Divider
+**Primitives:** Button, Card, Badge, Input, Textarea, Select, MultiSelect, Checkbox, RadioGroup, Slider, InputGroup, Skeleton, Progress, StatusDot, Pill, Toggle, SegmentedControl, Table, Kbd, Divider
 
-**Layout:** AppShell, Page, NavBar, NavHeader, ScreenHeader, SectionHeader, SettingsGroup, CategoryFilter, ListItem (swipe-to-delete), SearchBar, Tag, TagCarousel, TagCard, SliderIndicator, PageIndicator, StepIndicator, Timeline, StatGrid, StatusProgress
+**Layout:** AppShell, Page, NavBar, NavHeader, SideDrawer, DrawerShell, DrawerTrigger, ScreenHeader, SectionHeader, SettingsGroup, CategoryFilter, ListItem (swipe-to-delete), SearchBar, Tag, TagCarousel, TagCard, SliderIndicator, PageIndicator, StepIndicator, Timeline, StatGrid, StatusProgress
 
 **Feedback:** TimerRing, Dialog, ConfirmDialog, Toast, EmptyState, Loading, BottomSheet, CTAGroup, ScrollPicker, DatePicker, TimePicker, SelectionPicker
 
@@ -206,14 +206,16 @@ import { line, separator, glassHeader } from 'even-toolkit/types';
 import { buildActionBar, buildStaticActionBar } from 'even-toolkit/action-bar';
 import { truncate, applyScrollIndicators } from 'even-toolkit/text-utils';
 import { renderTimerLines } from 'even-toolkit/timer-display';
+import { formatGlassHeader, formatGlassListRow } from 'even-toolkit/glass-format';
+import { renderChatBlocks, renderChatReadMode } from 'even-toolkit/glass-chat-display';
 import { createSplash, TILE_PRESETS } from 'even-toolkit/splash';
 ```
 
 **Display:** 576x288px, 10 text lines, text/columns/chart/home page modes, image tiles (max 288x144)
 
-**Input:** action-map (tap/double-tap/scroll events), gestures (debounce), keyboard bindings
+**Input:** action-map (tap/double-tap/scroll events), gestures (debounce + post-tap scroll suppression), keyboard bindings
 
-**Utilities:** splash screens, PNG encoding, text cleaning, pagination, keep-alive
+**Utilities:** splash screens, PNG encoding, text cleaning, pagination, keep-alive, chat block formatters, reusable glass text formatting helpers
 
 ---
 
@@ -316,7 +318,53 @@ Light theme following Even Realities 2025 guidelines:
 | Normal Subtitle | 13px | 400 | -0.13px |
 | Normal Detail | 11px | 400 | -0.11px |
 
-## Quick Start
+## Navigation Patterns
+
+### DrawerShell (recommended)
+
+Side drawer navigation with automatic hamburger/back-button detection, header context for nested screens, and `bottomItems` for pinned items like Settings.
+
+```tsx
+import { DrawerShell, useDrawerHeader } from 'even-toolkit/web';
+import type { SideDrawerItem } from 'even-toolkit/web';
+
+// In your shell/layout:
+const MENU_ITEMS: SideDrawerItem[] = [
+  { id: '/', label: 'Home', section: 'App' },
+];
+const BOTTOM_ITEMS: SideDrawerItem[] = [
+  { id: '/settings', label: 'Settings', section: 'App' },
+];
+
+function Shell() {
+  return (
+    <DrawerShell
+      items={MENU_ITEMS}
+      bottomItems={BOTTOM_ITEMS}
+      title="MyApp"
+      getPageTitle={(p) => p === '/' ? 'MyApp' : 'Page'}
+      deriveActiveId={(p) => p}
+    />
+  );
+}
+
+// In nested screens — customize the header:
+function DetailScreen() {
+  useDrawerHeader({
+    title: 'Detail',
+    backTo: '/',                        // shows back button instead of hamburger
+    right: <Button size="sm">Save</Button>,
+    below: <Progress value={50} />,     // below header (progress bars)
+    footer: <StepIndicator ... />,      // fixed bottom area
+    hidden: true,                       // hide header entirely
+  });
+  return <div>...</div>;
+}
+```
+
+### NavBar + AppShell (tab bar)
+
+Horizontal tab bar for simpler apps.
 
 ```tsx
 import { AppShell, NavBar, ScreenHeader, Button, Card } from 'even-toolkit/web';

package/dist/glasses/action-bar.d.ts

@@ -4,8 +4,8 @@
  * Renders a row of named buttons with triangle indicators:
  *   ▶Timer◀  ▷Scroll◁  Steps
  *
- * - Active button (mode entered): filled triangles ▶Name◀
- * - Selected button (hovering in button-select mode): empty triangles ▷Name◁
+ * - Selected button (current highlight): empty triangles ▷Name◁
+ * - Active button (entered mode, not highlighted): filled triangles ▶Name◀
  * - Inactive button: plain  Name
  */
 /**
@@ -18,7 +18,7 @@
  */
 export declare function buildActionBar(buttons: string[], selectedIndex: number, activeLabel: string | null, _flashPhase?: boolean): string;
 /**
- * Build a static action bar (empty triangles on selected).
+ * Build a static action bar (filled triangles on selected).
  * Useful for screens like recipe detail or completion where there's no mode switching.
  */
 export declare function buildStaticActionBar(buttons: string[], selectedIndex: number): string;

package/dist/glasses/action-bar.js

@@ -4,8 +4,8 @@
  * Renders a row of named buttons with triangle indicators:
  *   ▶Timer◀  ▷Scroll◁  Steps
  *
- * - Active button (mode entered): filled triangles ▶Name◀
- * - Selected button (hovering in button-select mode): empty triangles ▷Name◁
+ * - Selected button (current highlight): empty triangles ▷Name◁
+ * - Active button (entered mode, not highlighted): filled triangles ▶Name◀
  * - Inactive button: plain  Name
  */
 /**
@@ -20,24 +20,24 @@ export function buildActionBar(buttons, selectedIndex, activeLabel, _flashPhase)
     const activeIdx = activeLabel ? buttons.indexOf(activeLabel) : -1;
     return buttons.map((name, i) => {
         if (activeIdx === i) {
-            // Active mode: filled triangles
+            // Active/confirmed button: filled triangles
             return `\u25B6${name}\u25C0`;
         }
-        if (activeIdx < 0 && i === selectedIndex) {
-            // Hovering in button-select mode: empty triangles
+        if (i === selectedIndex) {
+            // Scroll highlight on a non-active button: empty triangles
             return `\u25B7${name}\u25C1`;
         }
         return ` ${name} `;
     }).join(' ');
 }
 /**
- * Build a static action bar (empty triangles on selected).
+ * Build a static action bar (filled triangles on selected).
  * Useful for screens like recipe detail or completion where there's no mode switching.
  */
 export function buildStaticActionBar(buttons, selectedIndex) {
     return buttons.map((name, i) => {
         if (i === selectedIndex) {
-            return `\u25B7${name}\u25C1`;
+            return `\u25B6${name}\u25C0`;
         }
         return ` ${name} `;
     }).join(' ');

package/dist/glasses/action-bar.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-bar.js","sourceRoot":"","sources":["../../glasses/action-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAiB,EACjB,aAAqB,EACrB,WAA0B,EAC1B,WAAqB;IAErB,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,gCAAgC;YAChC,OAAO,SAAS,IAAI,QAAQ,CAAC;QAC/B,CAAC;QACD,IAAI,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YACzC,kDAAkD;YAClD,OAAO,SAAS,IAAI,QAAQ,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAiB,EACjB,aAAqB;IAErB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YACxB,OAAO,SAAS,IAAI,QAAQ,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"action-bar.js","sourceRoot":"","sources":["../../glasses/action-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAiB,EACjB,aAAqB,EACrB,WAA0B,EAC1B,WAAqB;IAErB,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,4CAA4C;YAC5C,OAAO,SAAS,IAAI,QAAQ,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YACxB,2DAA2D;YAC3D,OAAO,SAAS,IAAI,QAAQ,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAiB,EACjB,aAAqB;IAErB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YACxB,OAAO,SAAS,IAAI,QAAQ,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/glasses/action-map.js

@@ -1,5 +1,5 @@
 import { OsEventTypeList } from '@evenrealities/even_hub_sdk';
-import { tryConsumeTap, isScrollSuppressed, isScrollDebounced } from './gestures';
+import { tryConsumeTap, shouldIgnoreScroll } from './gestures';
 export function mapGlassEvent(event) {
     if (!event)
         return null;
@@ -25,11 +25,11 @@ function mapEvent(event) {
                 return null;
             return { type: 'GO_BACK' };
         case OsEventTypeList.SCROLL_TOP_EVENT:
-            if (isScrollDebounced('prev') || isScrollSuppressed())
+            if (shouldIgnoreScroll('prev'))
                 return null;
             return { type: 'HIGHLIGHT_MOVE', direction: 'up' };
         case OsEventTypeList.SCROLL_BOTTOM_EVENT:
-            if (isScrollDebounced('next') || isScrollSuppressed())
+            if (shouldIgnoreScroll('next'))
                 return null;
             return { type: 'HIGHLIGHT_MOVE', direction: 'down' };
         default:

package/dist/glasses/action-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-map.js","sourceRoot":"","sources":["../../glasses/action-map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC;QAChE,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAA8D;IAC9E,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,eAAe,CAAC,WAAW;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACxC,KAAK,eAAe,CAAC,kBAAkB;YACrC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,eAAe,CAAC,gBAAgB;YACnC,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,kBAAkB,EAAE;gBAAE,OAAO,IAAI,CAAC;YACnE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACrD,KAAK,eAAe,CAAC,mBAAmB;YACtC,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,kBAAkB,EAAE;gBAAE,OAAO,IAAI,CAAC;YACnE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACvD;YACE,uDAAuD;YACvD,wEAAwE;YACxE,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,sBAAsB,IAAI,IAAI,IAAK,EAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjF,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACvC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;YACxC,CAAC;YACD,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"action-map.js","sourceRoot":"","sources":["../../glasses/action-map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC;QAChE,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAA8D;IAC9E,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,eAAe,CAAC,WAAW;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACxC,KAAK,eAAe,CAAC,kBAAkB;YACrC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,eAAe,CAAC,gBAAgB;YACnC,IAAI,kBAAkB,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACrD,KAAK,eAAe,CAAC,mBAAmB;YACtC,IAAI,kBAAkB,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACvD;YACE,uDAAuD;YACvD,wEAAwE;YACxE,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,sBAAsB,IAAI,IAAI,IAAK,EAAa,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjF,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACvC,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;YACxC,CAAC;YACD,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/glasses/gestures.d.ts

@@ -3,4 +3,8 @@ export declare function isScrollSuppressed(): boolean;
 /** Call after every text container update to suppress spurious G2 scroll events */
 export declare function notifyTextUpdate(): void;
 export declare function isScrollDebounced(direction: 'prev' | 'next'): boolean;
+/** Shared scroll gate so a single bypass applies to the full event. */
+export declare function shouldIgnoreScroll(direction: 'prev' | 'next'): boolean;
+/** Allow the next scroll event through immediately after a tap-driven mode change. */
+export declare function armImmediateScroll(): void;
 //# sourceMappingURL=gestures.d.ts.map

package/dist/glasses/gestures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gestures.d.ts","sourceRoot":"","sources":["../../glasses/gestures.ts"],"names":[],"mappings":"AAaA,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAiB7D;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAMD,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAcrE"}
+{"version":3,"file":"gestures.d.ts","sourceRoot":"","sources":["../../glasses/gestures.ts"],"names":[],"mappings":"AAqBA,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAiB7D;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAM5C;AAMD,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAoBrE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAsBtE;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}

package/dist/glasses/gestures.js

@@ -8,6 +8,14 @@ const DIRECTION_CHANGE_DEBOUNCE_MS = 50;
 const SCROLL_SUPPRESS_AFTER_TEXT_MS = 80;
 let lastTapTime = 0;
 let lastTapKind = null;
+let bypassNextScrollChecks = false;
+function consumeExternalScrollBypass() {
+    const g = globalThis;
+    if (!g.__evenAllowImmediateScrollOnce)
+        return false;
+    g.__evenAllowImmediateScrollOnce = false;
+    return true;
+}
 export function tryConsumeTap(kind) {
     const now = Date.now();
     const elapsed = now - lastTapTime;
@@ -23,6 +31,10 @@ export function tryConsumeTap(kind) {
     return true;
 }
 export function isScrollSuppressed() {
+    if (bypassNextScrollChecks || consumeExternalScrollBypass()) {
+        bypassNextScrollChecks = false;
+        return false;
+    }
     return Date.now() - lastTapTime < SCROLL_SUPPRESS_AFTER_TAP_MS;
 }
 let lastScrollTime = 0;
@@ -34,6 +46,11 @@ export function notifyTextUpdate() {
 }
 export function isScrollDebounced(direction) {
     const now = Date.now();
+    if (bypassNextScrollChecks || consumeExternalScrollBypass()) {
+        lastScrollTime = now;
+        lastScrollDir = direction;
+        return false;
+    }
     // Suppress scrolls briefly after a text update (G2 re-layout fires spurious events)
     if (now - textUpdateTime < SCROLL_SUPPRESS_AFTER_TEXT_MS)
         return true;
@@ -44,4 +61,31 @@ export function isScrollDebounced(direction) {
     lastScrollDir = direction;
     return false;
 }
+/** Shared scroll gate so a single bypass applies to the full event. */
+export function shouldIgnoreScroll(direction) {
+    const now = Date.now();
+    const bypassed = bypassNextScrollChecks || consumeExternalScrollBypass();
+    if (bypassed) {
+        bypassNextScrollChecks = false;
+        lastScrollTime = now;
+        lastScrollDir = direction;
+        return false;
+    }
+    if (now - lastTapTime < SCROLL_SUPPRESS_AFTER_TAP_MS)
+        return true;
+    if (now - textUpdateTime < SCROLL_SUPPRESS_AFTER_TEXT_MS)
+        return true;
+    const threshold = direction === lastScrollDir ? SAME_DIRECTION_DEBOUNCE_MS : DIRECTION_CHANGE_DEBOUNCE_MS;
+    if (now - lastScrollTime < threshold)
+        return true;
+    lastScrollTime = now;
+    lastScrollDir = direction;
+    return false;
+}
+/** Allow the next scroll event through immediately after a tap-driven mode change. */
+export function armImmediateScroll() {
+    bypassNextScrollChecks = true;
+    lastScrollTime = 0;
+    lastScrollDir = null;
+}
 //# sourceMappingURL=gestures.js.map

package/dist/glasses/gestures.js.map

@@ -1 +1 @@
-{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../glasses/gestures.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAC7C,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC,uEAAuE;AACvE,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AACxC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEzC,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,WAAW,GAA4B,IAAI,CAAC;AAEhD,MAAM,UAAU,aAAa,CAAC,IAAsB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,GAAG,WAAW,CAAC;IAClC,MAAM,WAAW,GACf,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,yBAAyB,CAAC;IAEnF,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,GAAG,eAAe,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW,GAAG,GAAG,CAAC;IAClB,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,4BAA4B,CAAC;AACjE,CAAC;AAED,IAAI,cAAc,GAAG,CAAC,CAAC;AACvB,IAAI,aAAa,GAA2B,IAAI,CAAC;AACjD,IAAI,cAAc,GAAG,CAAC,CAAC;AAEvB,mFAAmF;AACnF,MAAM,UAAU,gBAAgB;IAC9B,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA0B;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,oFAAoF;IACpF,IAAI,GAAG,GAAG,cAAc,GAAG,6BAA6B;QAAE,OAAO,IAAI,CAAC;IAEtE,MAAM,SAAS,GACb,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,4BAA4B,CAAC;IAE1F,IAAI,GAAG,GAAG,cAAc,GAAG,SAAS;QAAE,OAAO,IAAI,CAAC;IAElD,cAAc,GAAG,GAAG,CAAC;IACrB,aAAa,GAAG,SAAS,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../glasses/gestures.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAC7C,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC,uEAAuE;AACvE,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AACxC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEzC,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,WAAW,GAA4B,IAAI,CAAC;AAChD,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC,SAAS,2BAA2B;IAClC,MAAM,CAAC,GAAG,UAA8E,CAAC;IACzF,IAAI,CAAC,CAAC,CAAC,8BAA8B;QAAE,OAAO,KAAK,CAAC;IACpD,CAAC,CAAC,8BAA8B,GAAG,KAAK,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAsB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,GAAG,WAAW,CAAC;IAClC,MAAM,WAAW,GACf,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,yBAAyB,CAAC;IAEnF,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,GAAG,eAAe,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW,GAAG,GAAG,CAAC;IAClB,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,sBAAsB,IAAI,2BAA2B,EAAE,EAAE,CAAC;QAC5D,sBAAsB,GAAG,KAAK,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,4BAA4B,CAAC;AACjE,CAAC;AAED,IAAI,cAAc,GAAG,CAAC,CAAC;AACvB,IAAI,aAAa,GAA2B,IAAI,CAAC;AACjD,IAAI,cAAc,GAAG,CAAC,CAAC;AAEvB,mFAAmF;AACnF,MAAM,UAAU,gBAAgB;IAC9B,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA0B;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,IAAI,sBAAsB,IAAI,2BAA2B,EAAE,EAAE,CAAC;QAC5D,cAAc,GAAG,GAAG,CAAC;QACrB,aAAa,GAAG,SAAS,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oFAAoF;IACpF,IAAI,GAAG,GAAG,cAAc,GAAG,6BAA6B;QAAE,OAAO,IAAI,CAAC;IAEtE,MAAM,SAAS,GACb,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,4BAA4B,CAAC;IAE1F,IAAI,GAAG,GAAG,cAAc,GAAG,SAAS;QAAE,OAAO,IAAI,CAAC;IAElD,cAAc,GAAG,GAAG,CAAC;IACrB,aAAa,GAAG,SAAS,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,SAA0B;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,2BAA2B,EAAE,CAAC;IAEzE,IAAI,QAAQ,EAAE,CAAC;QACb,sBAAsB,GAAG,KAAK,CAAC;QAC/B,cAAc,GAAG,GAAG,CAAC;QACrB,aAAa,GAAG,SAAS,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,GAAG,GAAG,WAAW,GAAG,4BAA4B;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,GAAG,GAAG,cAAc,GAAG,6BAA6B;QAAE,OAAO,IAAI,CAAC;IAEtE,MAAM,SAAS,GACb,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,4BAA4B,CAAC;IAE1F,IAAI,GAAG,GAAG,cAAc,GAAG,SAAS;QAAE,OAAO,IAAI,CAAC;IAElD,cAAc,GAAG,GAAG,CAAC;IACrB,aAAa,GAAG,SAAS,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,sBAAsB,GAAG,IAAI,CAAC;IAC9B,cAAc,GAAG,CAAC,CAAC;IACnB,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/glasses/glass-chat-display.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Chat/terminal output display builder for G2 glasses.
+ * Optimized for reading streaming AI output on a 10-line text display.
+ *
+ * Line type prefixes:
+ *   > user prompt
+ *   >> tool call
+ *   + collapsed thinking
+ *   - expanded thinking header
+ *   ! error
+ *   (no prefix) assistant text
+ */
+import type { DisplayData } from './types';
+export interface ChatLine {
+    type: 'prompt' | 'text' | 'tool' | 'thinking-collapsed' | 'thinking-expanded' | 'thinking-body' | 'error' | 'system';
+    text: string;
+}
+/**
+ * Format a single ChatLine into one or more display strings,
+ * word-wrapping at maxChars.
+ */
+export declare function formatChatLine(chatLine: ChatLine, maxChars?: number): string[];
+export interface ChatDisplayOptions {
+    /** Header title, e.g. "CLAUDE · opus · running" */
+    title: string;
+    /** Action bar string from buildStaticActionBar() */
+    actionBar: string;
+    /** Ordered chat lines to display */
+    chatLines: ChatLine[];
+    /** Scroll offset from bottom. 0 = show latest. Positive = scrolled up. */
+    scrollOffset: number;
+    /** Number of visible content lines. Default: 7 (10 total - 3 header) */
+    contentSlots?: number;
+    /** Max chars per line. Default: 44 */
+    maxChars?: number;
+}
+/**
+ * Build a complete chat display for G2 glasses.
+ * Auto-scrolls to bottom (latest content) unless scrollOffset > 0.
+ * Returns DisplayData with header + scrollable content.
+ */
+export declare function buildChatDisplay(opts: ChatDisplayOptions): DisplayData;
+//# sourceMappingURL=glass-chat-display.d.ts.map

package/dist/glasses/glass-chat-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-chat-display.d.ts","sourceRoot":"","sources":["../../glasses/glass-chat-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AAIxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAK,GAAG,MAAM,EAAE,CA6D1E;AAED,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CA0CtE"}

package/dist/glasses/glass-chat-display.js

@@ -0,0 +1,102 @@
+/**
+ * Chat/terminal output display builder for G2 glasses.
+ * Optimized for reading streaming AI output on a 10-line text display.
+ *
+ * Line type prefixes:
+ *   > user prompt
+ *   >> tool call
+ *   + collapsed thinking
+ *   - expanded thinking header
+ *   ! error
+ *   (no prefix) assistant text
+ */
+import { line, glassHeader } from './types';
+import { applyScrollIndicators } from './text-utils';
+/**
+ * Format a single ChatLine into one or more display strings,
+ * word-wrapping at maxChars.
+ */
+export function formatChatLine(chatLine, maxChars = 44) {
+    const { type, text } = chatLine;
+    let prefix;
+    switch (type) {
+        case 'prompt':
+            prefix = '> ';
+            break;
+        case 'tool':
+            prefix = '>> ';
+            break;
+        case 'thinking-collapsed':
+            prefix = '+ ';
+            break;
+        case 'thinking-expanded':
+            prefix = '- ';
+            break;
+        case 'thinking-body':
+            prefix = '  ';
+            break;
+        case 'error':
+            prefix = '! ';
+            break;
+        case 'system':
+            prefix = '= ';
+            break;
+        case 'text':
+        default:
+            prefix = '';
+            break;
+    }
+    const available = maxChars - prefix.length;
+    if (text.length <= available) {
+        return [`${prefix}${text}`];
+    }
+    // Word-wrap: try to break at word boundaries
+    const lines = [];
+    let remaining = text;
+    let isFirst = true;
+    while (remaining.length > 0) {
+        const pfx = isFirst ? prefix : ' '.repeat(prefix.length);
+        const avail = maxChars - pfx.length;
+        if (remaining.length <= avail) {
+            lines.push(`${pfx}${remaining}`);
+            break;
+        }
+        // Find last space within available width
+        let breakAt = remaining.lastIndexOf(' ', avail);
+        if (breakAt <= 0)
+            breakAt = avail; // no space found, hard break
+        lines.push(`${pfx}${remaining.slice(0, breakAt)}`);
+        remaining = remaining.slice(breakAt).trimStart();
+        isFirst = false;
+    }
+    return lines;
+}
+/**
+ * Build a complete chat display for G2 glasses.
+ * Auto-scrolls to bottom (latest content) unless scrollOffset > 0.
+ * Returns DisplayData with header + scrollable content.
+ */
+export function buildChatDisplay(opts) {
+    const { title, actionBar, chatLines, scrollOffset, contentSlots = 7, maxChars = 44, } = opts;
+    const lines = [...glassHeader(title, actionBar)];
+    // Format all chat lines into display strings
+    const allLines = [];
+    for (const cl of chatLines) {
+        allLines.push(...formatChatLine(cl, maxChars));
+    }
+    if (allLines.length === 0) {
+        lines.push(line('  Waiting for output...', 'meta'));
+        return { lines };
+    }
+    // Scroll from bottom: offset 0 = show last contentSlots lines
+    const totalLines = allLines.length;
+    const maxFromBottom = Math.max(0, totalLines - contentSlots);
+    const clampedOffset = Math.min(scrollOffset, maxFromBottom);
+    const start = Math.max(0, totalLines - contentSlots - clampedOffset);
+    const visible = allLines.slice(start, start + contentSlots);
+    const contentDisplayLines = visible.map((t) => line(t, 'normal'));
+    applyScrollIndicators(contentDisplayLines, start, totalLines, contentSlots, (t) => line(t, 'meta'));
+    lines.push(...contentDisplayLines);
+    return { lines };
+}
+//# sourceMappingURL=glass-chat-display.js.map

package/dist/glasses/glass-chat-display.js.map

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

package/dist/glasses/glass-format.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Glass display formatting constants and helpers.
+ * Safe Unicode characters confirmed working on G2 LVGL display.
+ * Inspired by tesla-even-g2 formatting patterns.
+ */
+/** Middle dot · field separator */
+export declare const SEP = "\u00B7";
+/** Single right-pointing angle › drill-in indicator */
+export declare const DRILL = "\u203A";
+/** Single left-pointing angle ‹ back prefix */
+export declare const BACK_CHAR = "\u2039";
+/** En-dash – result separator */
+export declare const DASH = "\u2013";
+/** Heavy horizontal ═ filled progress bar segment */
+export declare const BAR_FILL = "\u2501";
+/** Light horizontal ─ empty progress bar segment */
+export declare const BAR_EMPTY = "\u2500";
+/**
+ * Join non-empty values with · separator.
+ * Falsy values are filtered out.
+ *
+ * @example fieldJoin('CLAUDE', 'opus', 'running') → "CLAUDE · opus · running"
+ * @example fieldJoin('HOSTS', false, '2 total') → "HOSTS · 2 total"
+ */
+export declare function fieldJoin(...parts: (string | undefined | null | false)[]): string;
+/**
+ * Render an ASCII progress bar.
+ * Uses ═ for filled and ─ for empty.
+ *
+ * @example progressBar(67) → "═══════───"
+ * @example progressBar(30, 20) → "══════──────────────"
+ */
+export declare function progressBar(percent: number, width?: number): string;
+/**
+ * Format a key · value pair, truncating value if needed.
+ *
+ * @example kvLine('Language', 'EN') → "Language · EN"
+ */
+export declare function kvLine(label: string, value: string, maxWidth?: number): string;
+/**
+ * Append › drill-in indicator to a label.
+ *
+ * @example drillLabel('Sessions') → "Sessions ›"
+ */
+export declare function drillLabel(text: string): string;
+/**
+ * Build a "‹ Back" label for menu items.
+ */
+export declare function backLabel(): string;
+//# sourceMappingURL=glass-format.d.ts.map

package/dist/glasses/glass-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-format.d.ts","sourceRoot":"","sources":["../../glasses/glass-format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mCAAmC;AACnC,eAAO,MAAM,GAAG,WAAW,CAAC;AAE5B,uDAAuD;AACvD,eAAO,MAAM,KAAK,WAAW,CAAC;AAE9B,+CAA+C;AAC/C,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,iCAAiC;AACjC,eAAO,MAAM,IAAI,WAAW,CAAC;AAE7B,qDAAqD;AACrD,eAAO,MAAM,QAAQ,WAAW,CAAC;AAEjC,oDAAoD;AACpD,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,EAAE,GAAG,MAAM,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAI/D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/glasses/glass-format.js

@@ -0,0 +1,65 @@
+/**
+ * Glass display formatting constants and helpers.
+ * Safe Unicode characters confirmed working on G2 LVGL display.
+ * Inspired by tesla-even-g2 formatting patterns.
+ */
+/** Middle dot · field separator */
+export const SEP = '\u00B7';
+/** Single right-pointing angle › drill-in indicator */
+export const DRILL = '\u203A';
+/** Single left-pointing angle ‹ back prefix */
+export const BACK_CHAR = '\u2039';
+/** En-dash – result separator */
+export const DASH = '\u2013';
+/** Heavy horizontal ═ filled progress bar segment */
+export const BAR_FILL = '\u2501';
+/** Light horizontal ─ empty progress bar segment */
+export const BAR_EMPTY = '\u2500';
+/**
+ * Join non-empty values with · separator.
+ * Falsy values are filtered out.
+ *
+ * @example fieldJoin('CLAUDE', 'opus', 'running') → "CLAUDE · opus · running"
+ * @example fieldJoin('HOSTS', false, '2 total') → "HOSTS · 2 total"
+ */
+export function fieldJoin(...parts) {
+    return parts.filter(Boolean).join(` ${SEP} `);
+}
+/**
+ * Render an ASCII progress bar.
+ * Uses ═ for filled and ─ for empty.
+ *
+ * @example progressBar(67) → "═══════───"
+ * @example progressBar(30, 20) → "══════──────────────"
+ */
+export function progressBar(percent, width = 10) {
+    const clamped = Math.max(0, Math.min(100, percent));
+    const filled = Math.round((clamped / 100) * width);
+    return BAR_FILL.repeat(filled) + BAR_EMPTY.repeat(width - filled);
+}
+/**
+ * Format a key · value pair, truncating value if needed.
+ *
+ * @example kvLine('Language', 'EN') → "Language · EN"
+ */
+export function kvLine(label, value, maxWidth = 44) {
+    const sep = ` ${SEP} `;
+    const available = maxWidth - label.length - sep.length;
+    const val = value.length > available ? value.slice(0, available - 1) + '~' : value;
+    return `${label}${sep}${val}`;
+}
+/**
+ * Append › drill-in indicator to a label.
+ *
+ * @example drillLabel('Sessions') → "Sessions ›"
+ */
+export function drillLabel(text) {
+    return `${text} ${DRILL}`;
+}
+/**
+ * Build a "‹ Back" label for menu items.
+ */
+export function backLabel() {
+    return `${BACK_CHAR} Back`;
+}
+//# sourceMappingURL=glass-format.js.map

package/dist/glasses/glass-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-format.js","sourceRoot":"","sources":["../../glasses/glass-format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC;AAE5B,uDAAuD;AACvD,MAAM,CAAC,MAAM,KAAK,GAAG,QAAQ,CAAC;AAE9B,+CAA+C;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAC;AAE7B,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEjC,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAG,KAA4C;IACvE,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAK,GAAG,EAAE;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,KAAa,EAAE,QAAQ,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IACvB,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IACvD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACnF,OAAO,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,GAAG,SAAS,OAAO,CAAC;AAC7B,CAAC"}

package/dist/glasses/index.d.ts

@@ -10,4 +10,6 @@ export * from './glass-display-builders';
 export * from './glass-mode';
 export * from './glass-router';
 export * from './glass-screen-router';
+export * from './glass-format';
+export * from './glass-chat-display';
 //# sourceMappingURL=index.d.ts.map

package/dist/glasses/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../glasses/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../glasses/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/glasses/index.js

@@ -12,4 +12,6 @@ export * from './glass-display-builders';
 export * from './glass-mode';
 export * from './glass-router';
 export * from './glass-screen-router';
+export * from './glass-format';
+export * from './glass-chat-display';
 //# sourceMappingURL=index.js.map

package/dist/glasses/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../glasses/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,4FAA4F;AAE5F,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../glasses/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,4FAA4F;AAE5F,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/glasses/useGlasses.js

@@ -41,7 +41,7 @@ export function useGlasses(config) {
             const data = configRef.current.toDisplayData(snapshot, nav);
             const text = data.lines.map(l => {
                 if (l.style === 'separator')
-                    return '\u2500'.repeat(28) + '\n';
+                    return '\u2500'.repeat(28);
                 if (l.inverted)
                     return `\u25B6 ${l.text}`;
                 return `  ${l.text}`;