guideai-app 0.5.4-2 → 0.5.4-3

package/dist/utils/transcriptFloatGeometry.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Float transcript card geometry. Single source of truth in viewport pixels, bottom-left
+ * anchored: `{ left, bottom, width, coreH }` where `left`/`bottom` are insets of the card's
+ * bounding box from the viewport left/bottom edges, `width` is the card width, and `coreH`
+ * is the resizable content height (messages + input) exposed as `--guideai-transcript-core-h`.
+ *
+ * Bottom anchoring is deliberate: when the workflow drawer expands it adds chrome height above
+ * the core, so the card grows upward and the lower content (toolbar/messages/input) stays put.
+ *
+ * All math is pure (no DOM). Direct DOM writes during a gesture live in the hook.
+ */
+export declare const FLOAT_STRIP_DRAG_THRESHOLD_PX = 6;
+export declare const FLOAT_STRIP_TAP_MAX_PX = 10;
+/** Docked panel: any handle movement past this (small) threshold switches to float mode. */
+export declare const DOCK_UNDOCK_DRAG_THRESHOLD_PX = 6;
+export declare const FLOAT_WIDTH_MIN = 240;
+export declare const FLOAT_WIDTH_MAX = 560;
+export declare const FLOAT_CORE_H_MIN = 180;
+export declare const FLOAT_CORE_H_MAX = 560;
+export declare const FLOAT_VIEWPORT_MARGIN = 4;
+export type FloatGeometry = {
+    /** Card bounding-box inset from the viewport left edge (px). */
+    left: number;
+    /** Card bounding-box inset from the viewport bottom edge (px). */
+    bottom: number;
+    /** Card width (px). */
+    width: number;
+    /** Resizable content height (messages + input), px. */
+    coreH: number;
+};
+export type FloatResizeCorner = 'br' | 'bl' | 'tr' | 'tl';
+export type ViewportSize = {
+    vw: number;
+    vh: number;
+};
+/** Integer px avoids subpixel blur on Retina while dragging or clamping. */
+export declare function snapGeometry(g: FloatGeometry): FloatGeometry;
+/** Max width/coreH allowed given the current viewport (size caps come from the viewport, not just constants). */
+export declare function viewportMaxSize(view: ViewportSize, margin?: number): {
+    maxWidth: number;
+    maxCoreH: number;
+};
+/** Clamp width/coreH to [MIN, viewport-derived MAX]. Pure; does not touch position. */
+export declare function clampSize(width: number, coreH: number, view: ViewportSize): {
+    width: number;
+    coreH: number;
+};
+/**
+ * Clamp the card fully into the viewport given its on-screen height. `cardHeight` is the full
+ * rendered card height (chrome + drawer band + coreH); it can differ from `coreH` so the caller
+ * passes the measured height. If the card is taller/wider than the viewport, it is pinned to the
+ * top/left margin (bottom/right may overflow — acceptable, matches "snap into view").
+ */
+export declare function clampGeometryToViewport(g: FloatGeometry, cardHeight: number, cardWidth: number, view: ViewportSize, margin?: number): FloatGeometry;
+/**
+ * Should the card dock on release? Docks when more than ~50% of the card's width is past the
+ * right viewport edge. Uses the card's current bounding box.
+ */
+export declare function shouldDockOnRelease(rect: {
+    left: number;
+    width: number;
+}, view: ViewportSize): boolean;
+/**
+ * Opposite-corner-anchored resize. Works in a top-left coordinate frame for clean math, then
+ * converts back to the bottom-left anchored geometry. `chromeH` is the non-core card height
+ * (toolbar + handle + drawer band) so the full card height = chromeH + coreH.
+ *
+ * Start state captures the card rect (top-left) and sizes at pointer-down.
+ */
+export declare function resizeFromCorner(corner: FloatResizeCorner, start: {
+    x0: number;
+    top0: number;
+    w0: number;
+    coreH0: number;
+    chromeH: number;
+    px0: number;
+    py0: number;
+}, clientX: number, clientY: number, view: ViewportSize): FloatGeometry;

package/dist/utils/transcriptSubtitleUiPref.d.ts

@@ -0,0 +1,5 @@
+/** Fade captions after this many ms without a new user/assistant message. */
+export declare const SUBTITLE_IDLE_FADE_MS = 2000;
+export declare function getSubtitleDarkHighlight(): boolean;
+export declare function setSubtitleDarkHighlight(enabled: boolean): void;
+export declare function subscribeSubtitleUiPrefs(onStoreChange: () => void): () => void;

package/dist/utils/webrtcConnection.d.ts

@@ -48,6 +48,11 @@ export interface WebRTCConnectionConfig {
     };
     /** Optional existing audio element to reuse (avoids duplicate elements on reconnect) */
     existingAudioElement?: HTMLAudioElement | null;
+    /** When true, POST learn initialize (no tools / workflows). */
+    learnMode?: boolean;
+    learnPhase?: 'capture' | 'clarify';
+    /** Clarify re-init: keep the capture conversation id on the server. */
+    learnConversationId?: string;
 }
 /**
  * Manages WebRTC connection via unified initialize endpoint.

package/dist/utils/widgetBearerStorage.d.ts

@@ -1,8 +1,8 @@
 /**
  * Single localStorage record for the widget JWT used as `Authorization: Bearer`.
  */
-/** camelCase — aligns with other `guideAI_*` keys (see AUTHENTICATION.md). */
-export declare const WIDGET_BEARER_TOKEN_STORAGE_KEY = "guideai_widgetBearerToken";
+import { WIDGET_BEARER_TOKEN_STORAGE_KEY } from './guideaiMirroredStorageKeys';
+export { WIDGET_BEARER_TOKEN_STORAGE_KEY };
 export interface StoredWidgetBearerRecord {
     token: string;
     expiresAtMs: number;

package/dist/utils/workspaceCatalog.d.ts

@@ -8,6 +8,14 @@ export interface WorkspaceCatalogPayload {
     options: StubWorkspaceOption[];
     workflowsById: Record<string, StubWorkflowItem[]>;
 }
+export type WorkspaceCatalogFetchResult = {
+    status: 'ok';
+    payload: WorkspaceCatalogPayload;
+} | {
+    status: 'fatal';
+} | {
+    status: 'unavailable';
+};
 export interface FetchWorkspaceCatalogParams {
     environment: GuideAIEnvironment | undefined;
     authKeyTrim: string;
@@ -17,8 +25,11 @@ export interface FetchWorkspaceCatalogParams {
     /** When set (portal / pre-issued widget JWT), skip authKey exchange and use this Bearer. */
     authorizationBearer?: string;
 }
+export declare function shouldFatalEmptyWorkspaceCatalog(input: {
+    workspacesFilter?: string[];
+    workspaceTrim: string;
+}): boolean;
 /**
  * Loads workspace options + per-workflow steps for org-key or access-key widgets.
- * Returns null when credentials are missing, HTTP fails, or the list is empty.
  */
-export declare function fetchWorkspaceCatalog(params: FetchWorkspaceCatalogParams): Promise<WorkspaceCatalogPayload | null>;
+export declare function fetchWorkspaceCatalog(params: FetchWorkspaceCatalogParams): Promise<WorkspaceCatalogFetchResult>;

package/dist/utils/workspaceCatalogFatal.d.ts

@@ -0,0 +1,4 @@
+export declare function formatWorkspaceCatalogFatalMessage(input: {
+    workspacesFilter?: string[];
+    workspaceDefault?: string;
+}): string;

package/dist/visualContext/defaultProvider.d.ts

@@ -1,15 +1,9 @@
 /**
- * Default screenshot provider using html2canvas
- * Automatically detects and uses html2canvas if available
+ * Default screenshot provider using html2canvas-pro (supports modern CSS color functions).
  */
 import type { ScreenshotProvider } from './types';
 /**
- * Creates a default screenshot provider using html2canvas
- * Returns null if html2canvas is not available
+ * Creates a default screenshot provider using html2canvas-pro.
  */
-export declare const createDefaultScreenshotProvider: () => ScreenshotProvider | null;
-/**
- * Get the default screenshot provider
- * Returns null if unavailable (graceful degradation)
- */
-export declare const getDefaultScreenshotProvider: () => ScreenshotProvider | null;
+export declare const createDefaultScreenshotProvider: () => ScreenshotProvider;
+export declare const getDefaultScreenshotProvider: () => ScreenshotProvider;

package/dist/visualContext/visualContextCaptureLock.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cooperative pause for Visual Context auto-captures.
+ *
+ * `html2canvas` rasterizes the whole page and blocks the main thread for tens to hundreds of
+ * milliseconds. When that lands mid-interaction (e.g. dragging or resizing the transcript card)
+ * it stutters the gesture. The transcript drag/resize hook acquires this lock for the duration of
+ * a pointer gesture so the scheduler defers its heartbeat / urgent captures until the gesture ends.
+ *
+ * Ref-counted so overlapping acquirers are safe; operator-initiated captures (`forceCapture`,
+ * `requestCapture`) intentionally bypass this and still run.
+ */
+/** Acquire the lock (auto-captures paused while count > 0). Pair every call with `releaseVisualContextCaptureLock`. */
+export declare function acquireVisualContextCaptureLock(): void;
+/** Release a previously acquired lock. */
+export declare function releaseVisualContextCaptureLock(): void;
+/** True while at least one gesture holds the lock; scheduled auto-captures should skip. */
+export declare function isVisualContextCaptureLocked(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guideai-app",
-  "version": "0.5.4-2",
+  "version": "0.5.4-3",
   "description": "AI-powered guide component for React applications",
   "main": "dist/GuideAI.js",
   "types": "dist/index.d.ts",
@@ -37,7 +37,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "html2canvas": "^1.4.1",
+    "html2canvas-pro": "^2.0.4",
     "lucide-react": "^0.469.0"
   },
   "peerDependencies": {