@pillar-ai/sdk 0.1.18 → 0.1.19

package/dist/components/Button/EdgeTrigger.d.ts

@@ -43,11 +43,16 @@ export declare class EdgeTrigger {
      */
     private getEdgePosition;
     /**
-     * Detect the current theme from the document
+     * Detect the current theme from the document (for auto mode)
      * Checks for .dark class (next-themes) or data-theme attribute
      * Returns explicit 'light' or 'dark' to match app theme (not system preference)
      */
-    private detectTheme;
+    private detectThemeFromDOM;
+    /**
+     * Apply theme mode - respects explicit config, only auto-detects when mode is 'auto'
+     * Matches Panel behavior for consistency.
+     */
+    private applyThemeMode;
     /**
      * Initialize the edge trigger
      */

package/dist/components/PagePilot/PagePilotManager.d.ts

@@ -3,30 +3,35 @@
  * Manages the "Page being piloted by Agent" banner, rendering it outside Shadow DOM
  * so it appears above all other content on the page.
  */
+import type { ThemeMode } from '../../core/config';
 export declare class PagePilotManager {
     private container;
     private stylesInjected;
     private unsubscribe;
     private themeObserver;
     private primaryColor;
+    private themeMode;
     /**
-     * Detect the current theme from the document
+     * Detect the current theme from the document (for auto mode)
      * Checks for .dark class (next-themes) or data-theme attribute
      */
     private detectThemeFromDOM;
     /**
      * Apply theme mode to container element
+     * Respects explicit config, only auto-detects when mode is 'auto'
      */
-    private applyTheme;
+    private applyThemeMode;
     /**
      * Set up observer to watch for theme changes on documentElement
+     * Only needed for auto mode
      */
     private setupThemeObserver;
     /**
      * Initialize the page pilot manager
      * @param primaryColor - Optional primary color from theme config to override the default
+     * @param themeMode - Theme mode from config ('light', 'dark', or 'auto')
      */
-    init(primaryColor?: string): void;
+    init(primaryColor?: string, themeMode?: ThemeMode): void;
     /**
      * Update the primary color used by the banner
      */

package/dist/components/Panel/Panel.d.ts

@@ -15,9 +15,16 @@ export declare class Panel {
     private backdrop;
     private panelElement;
     private renderRoot;
+    private resizeHandle;
     private unsubscribe;
     private isManualMount;
     private themeObserver;
+    private _isResizing;
+    private _resizeStartX;
+    private _resizeStartWidth;
+    private _resizeRafId;
+    private _boundHandleResizeMove;
+    private _boundHandleResizeEnd;
     constructor(config: ResolvedConfig, api: APIClient, events: EventEmitter, rootContainer?: HTMLElement | null);
     /**
      * Detect the current theme from the document
@@ -53,6 +60,20 @@ export declare class Panel {
      * Destroy the panel
      */
     destroy(): void;
+    /** Internal safety clamp -- not user-configurable */
+    private static readonly MIN_PANEL_WIDTH;
+    /**
+     * Handle resize start from mouse or touch event on the drag handle
+     */
+    private handleResizeStart;
+    /**
+     * Handle resize move - throttled via requestAnimationFrame
+     */
+    private handleResizeMove;
+    /**
+     * Handle resize end - save final width and clean up
+     */
+    private handleResizeEnd;
     private subscribeToState;
     /**
      * Toggle backdrop visibility using inline styles.

package/dist/core/config.d.ts

@@ -2,8 +2,11 @@
  * Pillar SDK Configuration Types
  */
 import type { Platform } from '../actions/types';
+/** Which side of the screen the panel appears on. */
 export type PanelPosition = 'left' | 'right';
+/** How the panel interacts with page content: 'overlay' floats over it, 'push' shifts it aside. */
 export type PanelMode = 'overlay' | 'push';
+/** Color mode for the panel theme. 'auto' follows the system preference. */
 export type ThemeMode = 'light' | 'dark' | 'auto';
 /**
  * Sidebar tab configuration
@@ -38,6 +41,8 @@ export interface ThemeColors {
     border?: string;
     /** Border color for subtle/light borders */
     borderLight?: string;
+    /** Outline/focus ring color for interactive elements */
+    outlineColor?: string;
 }
 /**
  * Theme configuration for customizing panel appearance
@@ -59,10 +64,25 @@ export interface ThemeConfig {
     fontFamily?: string;
 }
 export interface PanelConfig {
+    /**
+     * Whether the panel is enabled.
+     * @default true
+     */
     enabled?: boolean;
+    /**
+     * Which side of the screen the panel appears on.
+     * @default 'right'
+     */
     position?: PanelPosition;
-    /** Panel mode: 'overlay' slides over content, 'push' shifts content aside */
+    /**
+     * Panel mode: 'overlay' slides over content, 'push' shifts content aside.
+     * @default 'push'
+     */
     mode?: PanelMode;
+    /**
+     * Panel width in pixels.
+     * @default 380
+     */
     width?: number;
     /**
      * Custom mount point for the panel.
@@ -100,6 +120,19 @@ export interface PanelConfig {
      * @default 500
      */
     fullWidthBreakpoint?: number;
+    /**
+     * Whether to open the panel automatically on initialization.
+     * Takes priority over localStorage persisted state.
+     * @default false
+     */
+    initialOpen?: boolean;
+    /**
+     * Whether the panel can be resized by dragging its edge.
+     * A drag handle appears on the content-facing edge of the panel when enabled.
+     * The resized width is persisted to localStorage.
+     * @default true
+     */
+    resizable?: boolean;
 }
 export interface UrlParamsConfig {
     /** Whether to check URL params for auto-opening the panel (default: true) */
@@ -225,8 +258,11 @@ export interface EdgeTriggerConfig {
      */
     resizable?: boolean;
 }
+/** Position of the mobile floating trigger button. */
 export type MobileTriggerPosition = 'bottom-right' | 'bottom-left';
+/** Preset icon for the mobile floating trigger button. */
 export type MobileTriggerIcon = 'sparkle' | 'question' | 'help' | 'chat' | 'support';
+/** Size preset for the mobile floating trigger button. */
 export type MobileTriggerSize = 'small' | 'medium' | 'large';
 export interface MobileTriggerConfig {
     /**
@@ -310,15 +346,25 @@ export interface PillarConfig {
      * @default false
      */
     debug?: boolean;
+    /** Panel layout and behavior settings. */
     panel?: PanelConfig;
+    /** Edge trigger (sidebar tab that opens the panel). */
     edgeTrigger?: EdgeTriggerConfig;
+    /** Mobile trigger (floating button on small screens). */
     mobileTrigger?: MobileTriggerConfig;
+    /** URL params for auto-opening the panel. */
     urlParams?: UrlParamsConfig;
+    /** Text selection "Ask AI" popover. */
     textSelection?: TextSelectionConfig;
+    /** DOM scanning for page context. */
     domScanning?: DOMScanningConfig;
+    /** Page-aware suggestions. */
     suggestions?: SuggestionsConfig;
+    /** Sidebar tabs configuration. */
     sidebarTabs?: SidebarTabConfig[];
+    /** API base URL. Defaults to Pillar's production API. */
     apiBaseUrl?: string;
+    /** Theme customization. */
     theme?: ThemeConfig;
     /**
      * Custom CSS to inject into the panel's Shadow DOM.
@@ -330,7 +376,9 @@ export interface PillarConfig {
      * ```
      */
     customCSS?: string;
+    /** Called when the SDK is initialized and ready. */
     onReady?: () => void;
+    /** Called when the SDK encounters an error. */
     onError?: (error: Error) => void;
 }
 export interface ResolvedPanelConfig {
@@ -348,6 +396,10 @@ export interface ResolvedPanelConfig {
     hoverBackdrop: boolean;
     /** Viewport width below which panel takes full screen width */
     fullWidthBreakpoint: number;
+    /** Whether to open the panel automatically on initialization */
+    initialOpen: boolean;
+    /** Whether the panel can be resized by dragging its edge */
+    resizable: boolean;
 }
 export interface ResolvedMobileTriggerConfig {
     enabled: boolean;

package/dist/core/events.d.ts

@@ -107,39 +107,53 @@ export interface RegisteredCard {
  */
 export type CardRenderer = (container: HTMLElement, data: Record<string, unknown>, callbacks: CardCallbacks) => (() => void) | void;
 export interface PillarEvents {
+    /** SDK is initialized and ready. */
     ready: void;
+    /** SDK encountered an error. */
     error: Error;
+    /** Panel was opened. */
     "panel:open": void;
+    /** Panel was closed. */
     "panel:close": void;
+    /** Panel navigated to a different view. */
     "panel:navigate": {
         view: string;
         params?: Record<string, string>;
     };
+    /** User viewed an article. */
     "article:view": {
         articleSlug: string;
     };
+    /** User performed a search. */
     "search:query": {
         query: string;
     };
+    /** User sent a chat message. */
     "chat:message": {
         message: string;
     };
+    /** Text selection popover was shown. */
     "textSelection:shown": {
         text: string;
     };
+    /** User clicked the text selection popover. */
     "textSelection:click": {
         text: string;
     };
+    /** Context was updated. */
     "context:change": {
         context: Context;
     };
+    /** User profile was updated. */
     "profile:change": {
         profile: UserProfile;
     };
+    /** User action was reported. */
     "action:report": {
         action: string;
         metadata?: Record<string, unknown>;
     };
+    /** User was identified. */
     "user:identified": {
         userId: string;
         profile?: {
@@ -148,45 +162,60 @@ export interface PillarEvents {
             metadata?: Record<string, unknown>;
         };
     };
+    /** User logged out. */
     "user:logout": Record<string, never>;
+    /** Query action returned a result to the agent. */
     "action:result": {
         actionName: string;
         result: unknown;
         toolCallId?: string;
     };
+    /** AI-suggested task is being executed. */
     "task:execute": TaskExecutePayload;
+    /** Task completed. */
     "task:complete": {
         id?: string;
         name: string;
         success: boolean;
         data?: Record<string, unknown>;
     };
+    /** Multi-step workflow started. */
     "workflow:start": Workflow;
+    /** Workflow step became active. */
     "workflow:step:active": {
         workflow: Workflow;
         step: WorkflowStep;
     };
+    /** Workflow step completed. */
     "workflow:step:complete": {
         workflow: Workflow;
         step: WorkflowStep;
         success: boolean;
     };
+    /** Workflow step was skipped. */
     "workflow:step:skip": {
         workflow: Workflow;
         step: WorkflowStep;
     };
+    /** Workflow completed all steps. */
     "workflow:complete": Workflow;
+    /** Workflow was cancelled. */
     "workflow:cancel": Workflow;
+    /** Theme was changed. */
     "theme:change": {
         theme: ResolvedThemeConfig;
     };
+    /** Text selection feature was toggled. */
     "textSelection:change": {
         enabled: boolean;
     };
+    /** DOM was scanned. */
     "dom:scanned": CompactScanResult;
+    /** DOM scanning feature was toggled. */
     "domScanning:change": {
         enabled: boolean;
     };
+    /** Page-aware suggestions were updated. */
     "suggestions:updated": {
         suggestions: Array<{
             id: string;
@@ -194,6 +223,7 @@ export interface PillarEvents {
         }>;
         route: string;
     };
+    /** Sidebar tab was clicked. Use to integrate external support systems. */
     "sidebar:click": {
         tabId: string;
         label: string;

package/dist/index.d.ts

@@ -20,7 +20,7 @@
  */
 export { EventEmitter, type CardCallbacks, type CardRenderer, type PillarEvents, type TaskExecutePayload, } from "./core/events";
 export { Pillar, type ChatContext, type PillarState } from "./core/Pillar";
-export { DEFAULT_SIDEBAR_TABS, type DOMScanningConfig, type EdgeTriggerConfig, type InteractionHighlightConfig, type MobileTriggerConfig, type MobileTriggerIcon, type MobileTriggerPosition, type MobileTriggerSize, type PanelConfig, type PanelMode, type PanelPosition, type PillarConfig, type ResolvedConfig, type ResolvedDOMScanningConfig, type ResolvedInteractionHighlightConfig, type ResolvedMobileTriggerConfig, type ResolvedPanelConfig, type ResolvedThemeConfig, type SidebarTabConfig, type TextSelectionConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type UrlParamsConfig, } from "./core/config";
+export { DEFAULT_SIDEBAR_TABS, type DOMScanningConfig, type EdgeTriggerConfig, type InteractionHighlightConfig, type MobileTriggerConfig, type MobileTriggerIcon, type MobileTriggerPosition, type MobileTriggerSize, type PanelConfig, type PanelMode, type PanelPosition, type PillarConfig, type ResolvedConfig, type ResolvedDOMScanningConfig, type ResolvedInteractionHighlightConfig, type ResolvedMobileTriggerConfig, type ResolvedPanelConfig, type ResolvedSuggestionsConfig, type ResolvedThemeConfig, type SidebarTabConfig, type SuggestionsConfig, type TextSelectionConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type UrlParamsConfig, } from "./core/config";
 export { type AssistantContext, type Context, type Suggestion, type UserProfile, } from "./core/context";
 export { clearRegistry, getActionCount, getActionDefinition, getActionNames, getClientInfo, getHandler, getManifest, hasAction, setClientInfo, type ActionDataSchema, type ActionDataType, type ActionDefinition, type ActionDefinitions, type ActionManifest, type ActionManifestEntry, type ActionNames, type ActionType, type ActionTypeDataMap, type ClientInfo, type CopyTextData, type ExternalLinkData, type InlineUIData, type NavigateActionData, type Platform, type SyncActionDefinition, type SyncActionDefinitions, type TriggerActionData, type TypedOnTask, type TypedPillarMethods, type TypedTaskHandler, } from "./actions";
 export { APIClient, type ArticleSummary, type ChatMessage, type ChatResponse, type ProgressEvent, } from "./api/client";