@pillar-ai/sdk 0.1.24 → 0.1.26

package/dist/api/ag-ui-client.d.ts

@@ -0,0 +1,102 @@
+/**
+ * AG-UI Protocol Client for Pillar SDK
+ *
+ * Implements the AG-UI specification for streaming agent interactions.
+ * Uses the @ag-ui/client HttpAgent for transport.
+ *
+ * Copyright (C) 2025 Pillar Team
+ */
+import type { ResolvedConfig } from '../core/config';
+export interface AGUIStreamCallbacks {
+    /** Called when run starts */
+    onRunStarted?: (runId: string) => void;
+    /** Called when run completes successfully */
+    onRunFinished?: () => void;
+    /** Called on error */
+    onError?: (error: Error) => void;
+    /** Called when a step starts */
+    onStepStarted?: (stepName: string) => void;
+    /** Called when a step finishes */
+    onStepFinished?: (stepName: string) => void;
+    /** Called for text message streaming */
+    onTextContent?: (messageId: string, delta: string) => void;
+    /** Called when text message completes */
+    onTextComplete?: (messageId: string, fullContent: string) => void;
+    /** Called when tool call starts (for UI display) */
+    onToolCallStart?: (toolCallId: string, toolName: string) => void;
+    /** Called with tool call arguments */
+    onToolCallArgs?: (toolCallId: string, argsJson: string) => void;
+    /** Called when tool call completes */
+    onToolCallEnd?: (toolCallId: string) => void;
+    /** Called when tool result is available */
+    onToolCallResult?: (toolCallId: string, result: string) => void;
+    /** Called for state delta events (sources, actions, plan) */
+    onStateDelta?: (delta: unknown[]) => void;
+    /** Called for state snapshots */
+    onStateSnapshot?: (state: unknown) => void;
+}
+export interface ClientTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    /** Handler function - called when agent requests this tool */
+    handler?: (args: Record<string, unknown>) => Promise<unknown>;
+}
+export declare class AGUIClient {
+    private config;
+    private agent;
+    private currentRunId;
+    private currentThreadId;
+    private messageAccumulators;
+    private toolArgAccumulators;
+    private toolCallNames;
+    private registeredTools;
+    constructor(config: ResolvedConfig);
+    /**
+     * Get or create a persistent thread ID for this session.
+     */
+    private getOrCreateThreadId;
+    private getBrowserLanguage;
+    /**
+     * Register a client-side tool that can be called by the agent.
+     */
+    registerTool(tool: ClientTool): void;
+    /**
+     * Unregister a client-side tool.
+     */
+    unregisterTool(toolName: string): void;
+    /**
+     * Send a message and stream the agent's response.
+     */
+    chat(message: string, callbacks: AGUIStreamCallbacks, options?: {
+        history?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+        userContext?: Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Execute a client-side tool if registered.
+     */
+    private maybeExecuteClientTool;
+    /**
+     * Send tool execution result back to the server.
+     */
+    sendToolResult(toolCallId: string, result: unknown, error?: string): Promise<void>;
+    /**
+     * Start a new conversation thread.
+     */
+    newThread(): string;
+    /**
+     * Get current thread ID.
+     */
+    get threadId(): string;
+    /**
+     * Get current run ID.
+     */
+    get runId(): string | null;
+}

package/dist/api/ag-ui-handler.d.ts

@@ -0,0 +1,89 @@
+/**
+ * AG-UI Event Handler
+ *
+ * Processes AG-UI protocol events and maintains UI state.
+ * Replaces the complex JSON-RPC parsing in mcp-client.ts.
+ */
+import type { AGUIEvent } from '@ag-ui/core';
+/** A streaming text message being accumulated */
+export interface StreamingMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    complete: boolean;
+    /** Which step this message belongs to (for thinking vs response) */
+    stepName?: string;
+}
+/** A tool call being tracked */
+export interface ToolCallState {
+    id: string;
+    name: string;
+    args: string;
+    result?: unknown;
+    complete: boolean;
+    /** True if this tool executes on the client (query action) */
+    isClientSide?: boolean;
+}
+/** State delta data (sources, actions, plan, etc.) */
+export interface StateDeltaData {
+    type: string;
+    data: unknown;
+    timestamp: number;
+}
+/** Complete AG-UI state */
+export interface AGUIState {
+    /** Current run ID */
+    runId: string | null;
+    /** Thread ID (replaces conversation_id) */
+    threadId: string | null;
+    /** Current step name (e.g., "reasoning", "tool_execution") */
+    currentStep: string | null;
+    /** Streaming messages keyed by message ID */
+    messages: Map<string, StreamingMessage>;
+    /** Tool calls keyed by tool call ID */
+    toolCalls: Map<string, ToolCallState>;
+    /** State deltas received (sources, actions, plans) */
+    stateDeltas: StateDeltaData[];
+    /** Whether the run is complete */
+    isComplete: boolean;
+    /** Error if run failed */
+    error: Error | null;
+}
+export interface AGUIHandlerCallbacks {
+    /** Called whenever state changes */
+    onStateChange: (state: AGUIState) => void;
+    /** Called when an error occurs */
+    onError: (error: Error) => void;
+    /** Called when run completes successfully */
+    onComplete: () => void;
+    /** Called when a client-side tool needs execution */
+    onClientToolCall?: (toolCall: ToolCallState) => Promise<unknown>;
+}
+/**
+ * Create an AG-UI event handler.
+ *
+ * Returns an object with a handleEvent method that processes
+ * AG-UI events and updates internal state.
+ */
+export declare function createAGUIHandler(callbacks: AGUIHandlerCallbacks): {
+    handleEvent: (event: AGUIEvent) => Promise<void>;
+    reset: () => void;
+    getState: () => AGUIState;
+};
+/**
+ * Register a tool as client-side.
+ * Called when the SDK registers an action with returns: true.
+ */
+export declare function registerClientSideTool(toolName: string): void;
+/**
+ * Unregister a client-side tool.
+ */
+export declare function unregisterClientSideTool(toolName: string): void;
+/**
+ * Check if a tool executes on the client side.
+ */
+export declare function isClientSideTool(toolName: string): boolean;
+/**
+ * Get all registered client-side tools.
+ */
+export declare function getClientSideTools(): string[];

package/dist/api/client.d.ts

@@ -232,6 +232,20 @@ export declare class APIClient {
         conversation_id?: string;
         [key: string]: unknown;
     }): Promise<void>;
+    /**
+     * Track WebMCP tool execution.
+     * Called when a browser agent invokes a WebMCP-registered tool.
+     * Fire-and-forget - errors are logged but don't throw.
+     *
+     * @param toolName - The name of the tool that was executed
+     * @param status - 'success' or 'failure'
+     * @param details - Optional execution details
+     */
+    trackWebMCPExecution(toolName: string, status: "success" | "failure", details?: {
+        duration_ms?: number;
+        error?: string;
+        input?: Record<string, unknown>;
+    }): Promise<void>;
     /**
      * Get contextual help suggestions based on product context.
      * Returns relevant articles, videos, and actions.

package/dist/button/FloatingButton.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Floating Help Button
+ * A floating action button that opens the help panel
+ */
+import type { ResolvedConfig, FloatingButtonPosition } from '../core/config';
+export declare class FloatingButton {
+    private config;
+    private onClick;
+    private element;
+    private stylesInjected;
+    private _isOpen;
+    constructor(config: ResolvedConfig, onClick: () => void);
+    /**
+     * Initialize the floating button
+     */
+    init(): void;
+    /**
+     * Set the open state (to show/hide when panel opens)
+     */
+    setOpen(isOpen: boolean): void;
+    /**
+     * Show the button
+     */
+    show(): void;
+    /**
+     * Hide the button
+     */
+    hide(): void;
+    /**
+     * Update button position
+     */
+    setPosition(position: FloatingButtonPosition): void;
+    /**
+     * Update button label
+     */
+    setLabel(label: string): void;
+    /**
+     * Destroy the button
+     */
+    destroy(): void;
+    private createElement;
+    private updateIcon;
+    private handleClick;
+}

package/dist/cli/sync.js

@@ -27,14 +27,19 @@ function printUsage() {
   console.log(`
 Pillar Tool Sync CLI
 
-Scans for usePillarTool/defineTool calls and syncs to the Pillar backend.
-Also supports legacy usePillarAction/defineAction calls.
+Scans for tool definitions and syncs to the Pillar backend.
+
+Supported patterns:
+  - React/Vue: usePillarTool()
+  - Angular: injectPillarTool()
+  - Vanilla JS: pillar.defineTool()
+  - Legacy: usePillarAction(), defineAction(), injectPillarAction()
 
 Usage:
   npx pillar-sync --scan <dir> [--local]
 
 Arguments:
-  --scan <dir>       Directory to scan for usePillarTool/defineTool calls
+  --scan <dir>       Directory to scan for tool definitions
   --local            Use localhost:8003 as the API URL (for local development)
   --force            Force sync even if manifest hash matches an existing deployment
   --help             Show this help message
@@ -230,7 +235,14 @@ async function scanTools(scanDir) {
   }
   const files = globFiles(absoluteDir, [".ts", ".tsx", ".js", ".jsx", ".mjs"]);
   console.log(`[pillar-sync] Scanning ${files.length} files in ${scanDir}`);
-  const PATTERNS = ["defineTool", "usePillarTool", "defineAction", "usePillarAction"];
+  const PATTERNS = [
+    "defineTool",
+    "usePillarTool",
+    "injectPillarTool",
+    "defineAction",
+    "usePillarAction",
+    "injectPillarAction"
+  ];
   const candidateFiles = files.filter((file) => {
     const content = fs.readFileSync(file, "utf-8");
     return PATTERNS.some((p) => content.includes(p));
@@ -313,7 +325,27 @@ async function scanTools(scanDir) {
     );
     visit2(sourceFile);
   }
-  return tools;
+  const toolsByName = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    const existing = toolsByName.get(tool.name);
+    if (existing) {
+      existing.push(tool);
+    } else {
+      toolsByName.set(tool.name, [tool]);
+    }
+  }
+  const deduplicatedTools = [];
+  for (const [name, instances] of toolsByName) {
+    if (instances.length > 1) {
+      const locations = instances.map((t) => `${t.sourceFile}:${t.line}`).join(", ");
+      console.warn(
+        `[pillar-sync] \u26A0 Duplicate tool "${name}" found in ${instances.length} locations: ${locations}`
+      );
+      console.warn(`[pillar-sync]   Using first definition from ${instances[0].sourceFile}:${instances[0].line}`);
+    }
+    deduplicatedTools.push(instances[0]);
+  }
+  return deduplicatedTools;
 }
 function findAgentGuidance(scanDir) {
   const absoluteDir = path.resolve(process.cwd(), scanDir);

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

@@ -36,6 +36,7 @@ export declare class EdgeTrigger {
     /**
      * Handle tab click - sets active tab and opens panel
      * For non-assistant tabs, emits event for customer's code to handle (e.g., Intercom, Zendesk)
+     * Tools tab (debug only) opens the panel with tool debugger
      */
     private handleTabClick;
     /**

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

@@ -0,0 +1,46 @@
+/**
+ * Floating Help Button Component
+ * A floating action button that opens the help panel
+ */
+import type { ResolvedConfig, FloatingButtonPosition } from '../../core/config';
+/**
+ * FloatingButton class that manages the button lifecycle
+ * Uses Preact for rendering but maintains imperative control
+ */
+export declare class FloatingButton {
+    private config;
+    private onClick;
+    private container;
+    private stylesInjected;
+    private _isHidden;
+    constructor(config: ResolvedConfig, onClick: () => void);
+    /**
+     * Initialize the floating button
+     */
+    init(): void;
+    /**
+     * Set the open state (to update icon when panel opens)
+     */
+    setOpen(_isOpen: boolean): void;
+    /**
+     * Show the button
+     */
+    show(): void;
+    /**
+     * Hide the button
+     */
+    hide(): void;
+    /**
+     * Update button position
+     */
+    setPosition(position: FloatingButtonPosition): void;
+    /**
+     * Update button label
+     */
+    setLabel(label: string): void;
+    /**
+     * Destroy the button
+     */
+    destroy(): void;
+    private render;
+}

package/dist/components/DevTools/DOMScannerPreview.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DOM Scanner Preview Component
+ * Displays a tree visualization of the scanned DOM AST
+ * Used in dev mode to preview what will be sent to the LLM
+ */
+import { h } from 'preact';
+import type { ScanResult } from '../../types/dom-scanner';
+interface DOMScannerPreviewProps {
+    /** The scan result to display */
+    result: ScanResult;
+    /** Called when user confirms and wants to send the message */
+    onConfirm: () => void;
+    /** Called when user cancels */
+    onCancel: () => void;
+}
+/**
+ * DOM Scanner Preview Panel
+ * Shows a modal with the scanned DOM tree and statistics
+ */
+export declare function DOMScannerPreview({ result, onConfirm, onCancel }: DOMScannerPreviewProps): h.JSX.Element;
+export default DOMScannerPreview;

package/dist/components/Progress/AGUIProgress.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AG-UI Progress Component
+ *
+ * Displays real-time progress based on AG-UI state signals.
+ * Renders step indicators, thinking content, and tool call status.
+ *
+ * This component replaces the old markdown-based ProgressRow for live
+ * streaming. ProgressRow is still used for rendering stored history.
+ */
+import { VNode } from 'preact';
+/**
+ * Render AG-UI progress state.
+ * Shows current step, streaming thinking messages, and active tool calls.
+ */
+export declare function AGUIProgress(): VNode | null;

package/dist/components/ToolDebugPanel/ToolDebugPanel.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool Debug Panel Component
+ *
+ * Shows registered tools and allows testing execution.
+ * Only rendered when debug: true is passed to Pillar.init()
+ *
+ * Features:
+ * - Searchable list of all registered tools
+ * - Tool details with input schema
+ * - JSON editor for testing tool execution
+ * - Execute button with result display
+ */
+interface ToolDebugPanelProps {
+    /** Called when user wants to close the panel */
+    onClose?: () => void;
+}
+/**
+ * Tool Debug Panel Component
+ */
+export declare function ToolDebugPanel({ onClose }: ToolDebugPanelProps): import("preact").JSX.Element;
+export default ToolDebugPanel;

package/dist/components/ToolDebugPanel/index.d.ts

@@ -0,0 +1 @@
+export { ToolDebugPanel, default } from "./ToolDebugPanel";

package/dist/components/Tooltips/Tooltip.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Tooltip Component
+ * Individual tooltip rendered to document body
+ */
+import type { TooltipData } from '../../api/client';
+import type { TooltipTrigger, TooltipPosition } from '../../core/config';
+export interface TooltipOptions {
+    trigger: TooltipTrigger;
+    position: TooltipPosition;
+    onLearnMore?: (articleSlug: string) => void;
+    onShow?: () => void;
+    onHide?: () => void;
+}
+/**
+ * Tooltip class that manages a single tooltip instance
+ * Uses Preact for rendering but maintains imperative control
+ */
+export declare class Tooltip {
+    private id;
+    private data;
+    private anchor;
+    private options;
+    private container;
+    private iconElement;
+    private isVisible;
+    private hideTimeout;
+    constructor(data: TooltipData, anchor: HTMLElement, options: TooltipOptions);
+    init(): void;
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    destroy(): void;
+    private renderTooltip;
+    private createIcon;
+    private bindEvents;
+    private unbindEvents;
+    private handleMouseEnter;
+    private handleMouseLeave;
+    private handleTooltipMouseEnter;
+    private handleTooltipMouseLeave;
+    private handleClick;
+    private handleDocumentClick;
+    private handleFocus;
+    private handleBlur;
+    private handleKeyDown;
+}

package/dist/components/Tooltips/TooltipManager.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tooltip Manager
+ * Scans DOM for tooltip elements and manages their lifecycle
+ */
+import type { EventEmitter } from '../../core/events';
+import type { ResolvedConfig } from '../../core/config';
+import type { APIClient } from '../../api/client';
+export declare class TooltipManager {
+    private config;
+    private api;
+    private events;
+    private tooltips;
+    private tooltipData;
+    private observer;
+    private stylesInjected;
+    constructor(config: ResolvedConfig, api: APIClient, events: EventEmitter);
+    /**
+     * Initialize the tooltip manager
+     */
+    init(): Promise<void>;
+    /**
+     * Scan DOM for tooltip elements and initialize them
+     */
+    scan(): Promise<void>;
+    /**
+     * Show a specific tooltip
+     */
+    show(tooltipId: string): void;
+    /**
+     * Hide a specific tooltip
+     */
+    hide(tooltipId: string): void;
+    /**
+     * Destroy the tooltip manager
+     */
+    destroy(): void;
+    private createTooltip;
+    private setupObserver;
+    private handleRemovedElement;
+    private getElementKey;
+}

package/dist/components/Tooltips/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tooltips Index
+ */
+export { Tooltip } from './Tooltip';
+export { TooltipManager } from './TooltipManager';
+export { TOOLTIP_STYLES } from './styles';

package/dist/components/Tooltips/styles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tooltip CSS Styles
+ * Injected into the document head
+ */
+export declare const TOOLTIP_STYLES = "\n/* Pillar Tooltip Styles */\n.pillar-tooltip {\n  position: absolute;\n  z-index: 99999;\n  max-width: 320px;\n  padding: 12px 16px;\n  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;\n  font-size: 14px;\n  line-height: 1.5;\n  color: #1a1a1a;\n  background: #ffffff;\n  border-radius: 8px;\n  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15), 0 0 0 1px rgba(0, 0, 0, 0.05);\n  pointer-events: auto;\n  opacity: 0;\n  transform: scale(0.95);\n  transition: opacity 0.15s ease, transform 0.15s ease;\n}\n\n.pillar-tooltip.pillar-tooltip--visible {\n  opacity: 1;\n  transform: scale(1);\n}\n\n.pillar-tooltip__content {\n  margin: 0;\n}\n\n.pillar-tooltip__content p {\n  margin: 0 0 8px;\n}\n\n.pillar-tooltip__content p:last-child {\n  margin-bottom: 0;\n}\n\n.pillar-tooltip__content a {\n  color: #2563eb;\n  text-decoration: none;\n}\n\n.pillar-tooltip__content a:hover {\n  text-decoration: underline;\n}\n\n.pillar-tooltip__learn-more {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  margin-top: 12px;\n  padding: 6px 12px;\n  font-size: 13px;\n  font-weight: 500;\n  color: #2563eb;\n  background: #eff6ff;\n  border: none;\n  border-radius: 6px;\n  cursor: pointer;\n  transition: background 0.15s ease;\n}\n\n.pillar-tooltip__learn-more:hover {\n  background: #dbeafe;\n}\n\n.pillar-tooltip__learn-more svg {\n  width: 14px;\n  height: 14px;\n}\n\n/* Arrow */\n.pillar-tooltip__arrow {\n  position: absolute;\n  width: 12px;\n  height: 12px;\n  background: #ffffff;\n  transform: rotate(45deg);\n  box-shadow: -1px -1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n.pillar-tooltip--top .pillar-tooltip__arrow {\n  bottom: -6px;\n  box-shadow: 1px 1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n.pillar-tooltip--bottom .pillar-tooltip__arrow {\n  top: -6px;\n}\n\n.pillar-tooltip--left .pillar-tooltip__arrow {\n  right: -6px;\n  box-shadow: 1px -1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n.pillar-tooltip--right .pillar-tooltip__arrow {\n  left: -6px;\n  box-shadow: -1px 1px 0 0 rgba(0, 0, 0, 0.05);\n}\n\n/* Tooltip Icon (for icon trigger) */\n.pillar-tooltip-icon {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 16px;\n  height: 16px;\n  margin-left: 4px;\n  vertical-align: middle;\n  color: #6b7280;\n  cursor: help;\n  transition: color 0.15s ease;\n}\n\n.pillar-tooltip-icon:hover {\n  color: #2563eb;\n}\n\n.pillar-tooltip-icon svg {\n  width: 100%;\n  height: 100%;\n}\n\n/* Close button */\n.pillar-tooltip__close {\n  position: absolute;\n  top: 8px;\n  right: 8px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 20px;\n  padding: 0;\n  color: #9ca3af;\n  background: none;\n  border: none;\n  border-radius: 4px;\n  cursor: pointer;\n  transition: color 0.15s ease, background 0.15s ease;\n}\n\n.pillar-tooltip__close:hover {\n  color: #1a1a1a;\n  background: #f3f4f6;\n}\n\n.pillar-tooltip__close svg {\n  width: 12px;\n  height: 12px;\n}\n";

package/dist/components/Views/ArticleChatView.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Article Chat View Component
+ * Combined view with full article content at top and chat messages below
+ */
+interface ArticleChatViewProps {
+    slug: string;
+}
+export declare function ArticleChatView({ slug }: ArticleChatViewProps): import("preact").JSX.Element;
+export {};

package/dist/components/Views/ArticleView.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Article View Component
+ * Displays article content using TipTap for rendering
+ */
+import { h } from 'preact';
+interface ArticleViewProps {
+    slug: string;
+}
+export declare function ArticleView({ slug }: ArticleViewProps): h.JSX.Element;
+export {};

package/dist/components/Views/CategoryView.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Category View Component
+ * Displays articles within a category
+ */
+import { h } from 'preact';
+import type { CategoryData } from '../../api/client';
+interface CategoryViewProps {
+    category: CategoryData;
+}
+export declare function CategoryView({ category }: CategoryViewProps): h.JSX.Element;
+export {};

package/dist/components/Views/DeveloperView.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Developer View Component
+ * Dev mode view for testing action handlers
+ */
+import { h } from 'preact';
+export declare function DeveloperView(): h.JSX.Element;

package/dist/components/Views/SearchView.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Search View Component
+ * Displays search input and results
+ */
+import { h } from 'preact';
+interface SearchViewProps {
+    initialQuery?: string;
+}
+export declare function SearchView({ initialQuery }: SearchViewProps): h.JSX.Element;
+export {};

package/dist/components/shared/ArticleCard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Article Card Component
+ * Displays an article list item
+ */
+import { h } from 'preact';
+import type { ArticleSummary } from '../../api/client';
+interface ArticleCardProps {
+    article: ArticleSummary;
+    onClick: () => void;
+}
+export declare function ArticleCard({ article, onClick }: ArticleCardProps): h.JSX.Element;
+interface ArticleListProps {
+    articles: ArticleSummary[];
+    onArticleClick: (article: ArticleSummary) => void;
+}
+export declare function ArticleList({ articles, onArticleClick }: ArticleListProps): h.JSX.Element;
+export {};

package/dist/components/shared/CategoryCard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Category Card Component
+ * Displays a category list item
+ */
+import { h } from 'preact';
+import type { CategoryData } from '../../api/client';
+interface CategoryCardProps {
+    category: CategoryData;
+    onClick: () => void;
+}
+export declare function CategoryCard({ category, onClick }: CategoryCardProps): h.JSX.Element;
+interface CategoryListProps {
+    categories: CategoryData[];
+    onCategoryClick: (category: CategoryData) => void;
+}
+export declare function CategoryList({ categories, onCategoryClick }: CategoryListProps): h.JSX.Element;
+export {};

package/dist/content/extensions/AccordionNode.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Accordion Node Extension for TipTap (vanilla - HTML rendering only)
+ * Used to render collapsible accordion blocks in article content
+ */
+import { Node } from '@tiptap/core';
+/**
+ * TipTap Accordion Node Extension (vanilla, no React)
+ * Renders accordion blocks using HTML details/summary elements
+ */
+export declare const AccordionNode: Node<any, any>;

package/dist/content/extensions/CalloutNode.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Callout Node Extension for TipTap (vanilla - HTML rendering only)
+ * Used to render callout blocks in article content
+ */
+import { Node } from '@tiptap/core';
+export type CalloutType = 'info' | 'warning' | 'tip' | 'error' | 'success';
+/**
+ * TipTap Callout Node Extension (vanilla, no React)
+ * Renders callout blocks with type-specific styling classes
+ */
+export declare const CalloutNode: Node<any, any>;

package/dist/content/extensions/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * TipTap Extensions for SDK content rendering
+ */
+export { CalloutNode, type CalloutType } from './CalloutNode';
+export { AccordionNode } from './AccordionNode';