@pillar-ai/sdk 0.1.26 → 0.1.27

package/dist/core/Pillar.d.ts

@@ -76,16 +76,16 @@ export declare class Pillar {
     /**
      * Create or get the shared root container for all Pillar UI elements.
      * Uses isolation: isolate to create a new stacking context.
-     * Z-index varies by panel mode:
-     *   - Push mode: 1000 (above typical navbars but not extreme)
-     *   - Hover/overlay mode: 9999 (floats above host app content)
+     * Z-index varies by panel mode (configurable via zIndex option):
+     *   - Push mode: config.zIndex.push (default: 1)
+     *   - Hover/overlay mode: config.zIndex.hover (default: 9999)
      */
     private _createRootContainer;
     /**
      * Subscribe to hover mode changes and update root container z-index.
-     * Push mode uses a moderate z-index (1000) so the panel sits alongside content
-     * without dominating the stacking order. Hover/overlay mode uses a high z-index
-     * (9999) so the panel floats above the host app.
+     * Push mode uses a low z-index so the panel sits alongside content without
+     * dominating the stacking order. Hover/overlay mode uses a high z-index
+     * so the panel floats above the host app.
      */
     private _subscribeToHoverModeForRoot;
     /**

package/dist/core/config.d.ts

@@ -302,6 +302,25 @@ export interface MobileTriggerConfig {
      */
     offset?: number;
 }
+/**
+ * Z-index configuration for the SDK root container.
+ * Controls stacking order relative to host app content.
+ */
+export interface ZIndexConfig {
+    /**
+     * Z-index when panel is in push mode (shifts content aside).
+     * Use a low value so the panel sits alongside content without
+     * dominating the stacking order.
+     * @default 1
+     */
+    push?: number;
+    /**
+     * Z-index when panel is in hover/overlay mode (floats over content).
+     * Use a high value so the panel floats above host app content.
+     * @default 9999
+     */
+    hover?: number;
+}
 export interface PillarConfig {
     /**
      * Your product key from the Pillar app.
@@ -370,6 +389,11 @@ export interface PillarConfig {
      * ```
      */
     customCSS?: string;
+    /**
+     * Z-index configuration for the SDK root container.
+     * Controls stacking order relative to host app content.
+     */
+    zIndex?: ZIndexConfig;
     /** Called when the SDK is initialized and ready. */
     onReady?: () => void;
     /** Called when the SDK encounters an error. */
@@ -457,6 +481,7 @@ export interface ResolvedConfig {
     sidebarTabs: SidebarTabConfig[];
     theme: ResolvedThemeConfig;
     customCSS?: string;
+    zIndex: Required<ZIndexConfig>;
     onReady?: () => void;
     onError?: (error: Error) => void;
 }

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, type ToolInfo } 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 ResolvedSuggestionsConfig, type ResolvedThemeConfig, type SidebarTabConfig, type SuggestionsConfig, 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, type ZIndexConfig, } from "./core/config";
 export { type AssistantContext, type Context, type Suggestion, type UserProfile, } from "./core/context";
 export { clearRegistry, getToolCount, getToolDefinition, getToolNames, getClientInfo, getHandler, getManifest, hasTool, setClientInfo, type ToolDataSchema, type ToolDataSchemaProperty, type ToolDataType, type ToolDefinition, type ToolDefinitions, type ToolManifest, type ToolManifestEntry, type ToolNames, type ToolType, type ToolTypeDataMap, type ToolExecuteResult, type ToolSchema, type ClientInfo, type CopyTextData, type ExternalLinkData, type InlineUIData, type NavigateToolData, type TriggerToolData, type QueryToolData, type Platform, type SyncToolDefinition, type SyncToolDefinitions, type TypedOnTask, type TypedPillarMethods, type TypedTaskHandler, getActionCount, getActionDefinition, getActionNames, hasAction, type ActionDataSchema, type ActionDataSchemaProperty, type ActionDataType, type ActionDefinition, type ActionDefinitions, type ActionManifest, type ActionManifestEntry, type ActionNames, type ActionType, type ActionTypeDataMap, type ActionResult, type ActionSchema, type NavigateActionData, type TriggerActionData, type QueryActionData, type SyncActionDefinition, type SyncActionDefinitions, } from "./tools";
 export { APIClient, type ArticleSummary, type ChatMessage, type ChatResponse, type ProgressEvent, } from "./api/client";