@promptbook/core 0.112.0-48 → 0.112.0-49

package/esm/index.es.js

@@ -28,7 +28,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-48';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-49';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/avatars/avatarAnimationScheduler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One callback registered in the shared avatar animation scheduler.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarAnimationListener = (now: number) => void;
+/**
+ * Registers one avatar animation callback in the shared animation loop.
+ *
+ * @param avatarAnimationListener Frame callback invoked on every animation frame.
+ * @returns Cleanup function that unregisters the callback.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function retainAvatarAnimationListener(avatarAnimationListener: AvatarAnimationListener): () => void;
+export {};

package/esm/src/avatars/avatarPointerTracking.d.ts

@@ -15,3 +15,19 @@ export declare function retainAvatarPointerTracking(): () => void;
  * @private utility of the avatar rendering system
  */
 export declare function getAvatarPointerSnapshot(): AvatarPointerSnapshot | null;
+/**
+ * Returns the current pointer snapshot version.
+ *
+ * @returns Monotonic pointer snapshot version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarPointerSnapshotVersion(): number;
+/**
+ * Returns the current viewport-layout version used to invalidate cached avatar bounds.
+ *
+ * @returns Monotonic viewport-layout version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarViewportLayoutVersion(): number;

package/esm/src/avatars/avatarVisibilityTracking.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One callback observing the viewport visibility of an avatar canvas.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarVisibilityListener = (isVisible: boolean) => void;
+/**
+ * Observes one avatar element and notifies the caller when it enters or leaves the viewport.
+ *
+ * @param element Observed avatar element.
+ * @param avatarVisibilityListener Listener notified with the current visibility state.
+ * @returns Cleanup function that stops observing the element.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function observeAvatarVisibility(element: Element, avatarVisibilityListener: AvatarVisibilityListener): () => void;
+export {};

package/esm/src/avatars/renderAvatarVisual.d.ts

@@ -1,9 +1,37 @@
 import type { RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId } from './types/AvatarVisualDefinition';
+/**
+ * Stable render data derived once from the avatar definition, surface, and visual id.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export type ResolvedAvatarRenderDefinition = {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly avatarVisual: AvatarVisualDefinition;
+    readonly surface: AvatarSurfaceStyle;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+};
+/**
+ * Resolves the stable avatar render inputs reused across multiple frames.
+ *
+ * @param options Avatar identity and visual selection.
+ * @returns Stable render data ready to be used by `renderAvatarVisual`.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export declare function resolveAvatarRenderDefinition(options: {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly visualId: AvatarVisualId;
+    readonly surface?: AvatarSurfaceStyle;
+}): ResolvedAvatarRenderDefinition;
 /**
  * Renders one deterministic avatar frame into the provided canvas.
  *
  * @param options Rendering options.
+ * @param resolvedAvatarRenderDefinition Optional stable render data reused between frames.
  *
  * @private shared helper for canvas avatar rendering
  */
-export declare function renderAvatarVisual(options: RenderAvatarVisualOptions): void;
+export declare function renderAvatarVisual(options: RenderAvatarVisualOptions, resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition): void;

package/esm/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -4,10 +4,10 @@ import { Color } from '../../../_packages/color.index';
 import { SpeechRecognition } from '../../../types/SpeechRecognition';
 import type { string_href } from '../../../types/typeAliases';
 import { string_color } from '../../../types/typeAliases';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -749,9 +749,9 @@ export type ChatProps = {
      */
     readonly visualMode?: ChatVisualMode;
     /**
-     * Visual style of the chat component
+     * Layout of the chat component
      */
-    readonly visual: 'STANDALONE' | 'FULL_PAGE';
+    readonly layout: 'STANDALONE' | 'FULL_PAGE';
     /**
      * Optional array of effect configurations for chat animations
      * When provided, enables visual effects (confetti, hearts, etc.) based on emojis in messages

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-47`).
+ * It follows semantic versioning (e.g., `0.112.0-48`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.112.0-48",
+    "version": "0.112.0-49",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -27,7 +27,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-48';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-49';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/avatars/avatarAnimationScheduler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One callback registered in the shared avatar animation scheduler.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarAnimationListener = (now: number) => void;
+/**
+ * Registers one avatar animation callback in the shared animation loop.
+ *
+ * @param avatarAnimationListener Frame callback invoked on every animation frame.
+ * @returns Cleanup function that unregisters the callback.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function retainAvatarAnimationListener(avatarAnimationListener: AvatarAnimationListener): () => void;
+export {};

package/umd/src/avatars/avatarPointerTracking.d.ts

@@ -15,3 +15,19 @@ export declare function retainAvatarPointerTracking(): () => void;
  * @private utility of the avatar rendering system
  */
 export declare function getAvatarPointerSnapshot(): AvatarPointerSnapshot | null;
+/**
+ * Returns the current pointer snapshot version.
+ *
+ * @returns Monotonic pointer snapshot version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarPointerSnapshotVersion(): number;
+/**
+ * Returns the current viewport-layout version used to invalidate cached avatar bounds.
+ *
+ * @returns Monotonic viewport-layout version.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function getAvatarViewportLayoutVersion(): number;

package/umd/src/avatars/avatarVisibilityTracking.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One callback observing the viewport visibility of an avatar canvas.
+ *
+ * @private utility of the avatar rendering system
+ */
+type AvatarVisibilityListener = (isVisible: boolean) => void;
+/**
+ * Observes one avatar element and notifies the caller when it enters or leaves the viewport.
+ *
+ * @param element Observed avatar element.
+ * @param avatarVisibilityListener Listener notified with the current visibility state.
+ * @returns Cleanup function that stops observing the element.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function observeAvatarVisibility(element: Element, avatarVisibilityListener: AvatarVisibilityListener): () => void;
+export {};

package/umd/src/avatars/renderAvatarVisual.d.ts

@@ -1,9 +1,37 @@
 import type { RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarPalette, AvatarSurfaceStyle, AvatarVisualDefinition, AvatarVisualId } from './types/AvatarVisualDefinition';
+/**
+ * Stable render data derived once from the avatar definition, surface, and visual id.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export type ResolvedAvatarRenderDefinition = {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly avatarVisual: AvatarVisualDefinition;
+    readonly surface: AvatarSurfaceStyle;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+};
+/**
+ * Resolves the stable avatar render inputs reused across multiple frames.
+ *
+ * @param options Avatar identity and visual selection.
+ * @returns Stable render data ready to be used by `renderAvatarVisual`.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export declare function resolveAvatarRenderDefinition(options: {
+    readonly avatarDefinition: AvatarDefinition;
+    readonly visualId: AvatarVisualId;
+    readonly surface?: AvatarSurfaceStyle;
+}): ResolvedAvatarRenderDefinition;
 /**
  * Renders one deterministic avatar frame into the provided canvas.
  *
  * @param options Rendering options.
+ * @param resolvedAvatarRenderDefinition Optional stable render data reused between frames.
  *
  * @private shared helper for canvas avatar rendering
  */
-export declare function renderAvatarVisual(options: RenderAvatarVisualOptions): void;
+export declare function renderAvatarVisual(options: RenderAvatarVisualOptions, resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition): void;

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -4,10 +4,10 @@ import { Color } from '../../../_packages/color.index';
 import { SpeechRecognition } from '../../../types/SpeechRecognition';
 import type { string_href } from '../../../types/typeAliases';
 import { string_color } from '../../../types/typeAliases';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { AgentChipData } from '../AgentChip/AgentChip';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -749,9 +749,9 @@ export type ChatProps = {
      */
     readonly visualMode?: ChatVisualMode;
     /**
-     * Visual style of the chat component
+     * Layout of the chat component
      */
-    readonly visual: 'STANDALONE' | 'FULL_PAGE';
+    readonly layout: 'STANDALONE' | 'FULL_PAGE';
     /**
      * Optional array of effect configurations for chat animations
      * When provided, enables visual effects (confetti, hearts, etc.) based on emojis in messages

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-47`).
+ * It follows semantic versioning (e.g., `0.112.0-48`).
  *
  * @generated
  */