@schandlergarcia/sf-web-components 1.0.3 → 1.0.4

package/dist/components/library/cards/ActionList.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Row of action buttons — typically used at the bottom of a dashboard section.
+ *
+ * @param {{ label: string, [key]: any }[] | string[]} actions
+ * @param {string}     title
+ * @param {Function}   onAction  Called with the action object/string when clicked
+ */
+export default function ActionList({ actions, title, onAction, className, }: {
+    label: string;
+    [key]: any;
+}[] | string[]): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/ActivityCard.d.ts

@@ -0,0 +1,5 @@
+export default function ActivityCard({ title, actions, className }: {
+    title?: string | undefined;
+    actions?: never[] | undefined;
+    className?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/library/cards/BaseCard.d.ts

@@ -0,0 +1,24 @@
+export default function BaseCard({ header, body, footer, children, variant, size, padding, shadow, radius, border, isHoverable, isPressable, isLoading, isDisabled, isSelected, className, headerClassName, bodyClassName, footerClassName, onPress, onHover, ...rest }: {
+    [x: string]: any;
+    header: any;
+    body: any;
+    footer: any;
+    children: any;
+    variant?: string | undefined;
+    size?: string | undefined;
+    padding?: string | undefined;
+    shadow?: boolean | undefined;
+    radius?: string | undefined;
+    border?: boolean | undefined;
+    isHoverable?: boolean | undefined;
+    isPressable?: boolean | undefined;
+    isLoading?: boolean | undefined;
+    isDisabled?: boolean | undefined;
+    isSelected?: boolean | undefined;
+    className?: string | undefined;
+    headerClassName?: string | undefined;
+    bodyClassName?: string | undefined;
+    footerClassName?: string | undefined;
+    onPress: any;
+    onHover: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/CalloutCard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Highlighted callout box for important inline messages.
+ *
+ * @param {string}  title
+ * @param {string|ReactNode} message
+ * @param {"neutral"|"success"|"warning"|"danger"|"info"} tone
+ * @param {ReactNode} icon   Optional leading icon
+ */
+export default function CalloutCard({ title, message, tone, icon, className, }: string): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/ChartCard.d.ts

@@ -0,0 +1,17 @@
+export default function ChartCard({ chart, chartType, title, subtitle, filters, timeRange, actions, legend, height, showGrid, showAxes, data, loading, error, ...cardProps }: {
+    [x: string]: any;
+    chart: any;
+    chartType: any;
+    title: any;
+    subtitle: any;
+    filters: any;
+    timeRange: any;
+    actions: any;
+    legend: any;
+    height?: number | undefined;
+    showGrid: any;
+    showAxes: any;
+    data: any;
+    loading?: boolean | undefined;
+    error: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/FeedPanel.d.ts

@@ -0,0 +1,11 @@
+export default function FeedPanel({ title, subtitle, actions, children, width, className, headerClassName, bodyClassName, ...rest }: {
+    [x: string]: any;
+    title: any;
+    subtitle: any;
+    actions: any;
+    children: any;
+    width: any;
+    className?: string | undefined;
+    headerClassName?: string | undefined;
+    bodyClassName?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/ListCard.d.ts

@@ -0,0 +1,20 @@
+export default function ListCard({ items, title, subtitle, showAvatars, showStatus, showActions, showTimestamp, dense, divided, actions, itemActions, onItemClick, loading, error, emptyMessage, emptyIcon, maxBodyHeight, ...cardProps }: {
+    [x: string]: any;
+    items?: never[] | undefined;
+    title: any;
+    subtitle: any;
+    showAvatars?: boolean | undefined;
+    showStatus?: boolean | undefined;
+    showActions?: boolean | undefined;
+    showTimestamp?: boolean | undefined;
+    dense?: boolean | undefined;
+    divided?: boolean | undefined;
+    actions: any;
+    itemActions: any;
+    onItemClick: any;
+    loading?: boolean | undefined;
+    error: any;
+    emptyMessage?: string | undefined;
+    emptyIcon: any;
+    maxBodyHeight: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/MetricCard.d.ts

@@ -0,0 +1,17 @@
+export default function MetricCard({ title, value, subtitle, change, changeType, icon, color, trend, trendIcon, layout, footer, actions, loading, error, ...cardProps }: {
+    [x: string]: any;
+    title: any;
+    value: any;
+    subtitle: any;
+    change: any;
+    changeType?: string | undefined;
+    icon: any;
+    color?: string | undefined;
+    trend: any;
+    trendIcon: any;
+    layout?: string | undefined;
+    footer: any;
+    actions: any;
+    loading?: boolean | undefined;
+    error: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/MetricsStrip.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Horizontal strip of KPI metrics — compact alternative to a row of MetricCards.
+ *
+ * @param {{ label: string, value: string|number, trend?: string|number }[]} metrics
+ * @param {string}  title
+ * @param {boolean} collapsible   Allow collapsing into a single-line summary
+ * @param {boolean} collapsed     Initial collapsed state
+ */
+export default function MetricsStrip({ metrics, title, collapsible, collapsed: initialCollapsed, className, }: {
+    label: string;
+    value: string | number;
+    trend?: string | number;
+}[]): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/SectionCard.d.ts

@@ -0,0 +1,12 @@
+export default function SectionCard({ title, description, label, variant, showDivider, alignment, size, isDark, className, ...cardProps }: {
+    [x: string]: any;
+    title: any;
+    description: any;
+    label: any;
+    variant?: string | undefined;
+    showDivider?: boolean | undefined;
+    alignment?: string | undefined;
+    size?: string | undefined;
+    isDark?: boolean | undefined;
+    className?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/SemanticMetricCard.d.ts

@@ -0,0 +1,20 @@
+export default function SemanticMetricCard({ semanticId, metricId, title, subtitle, value, unit, format, trend, change, changeLabel, description, seriesName, availableFilters, showFilters, compact, className, loading, ...rest }: {
+    [x: string]: any;
+    semanticId: any;
+    metricId: any;
+    title: any;
+    subtitle: any;
+    value: any;
+    unit: any;
+    format: any;
+    trend: any;
+    change: any;
+    changeLabel: any;
+    description: any;
+    seriesName: any;
+    availableFilters: any;
+    showFilters: any;
+    compact: any;
+    className: any;
+    loading?: boolean | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/SemanticMetricCardWithLoading.d.ts

@@ -0,0 +1,7 @@
+export default function SemanticMetricCardWithLoading({ simulateInitialLoad, minInitialDelayMs, maxInitialDelayMs, loading: loadingProp, ...props }: {
+    [x: string]: any;
+    simulateInitialLoad?: boolean | undefined;
+    minInitialDelayMs?: number | undefined;
+    maxInitialDelayMs?: number | undefined;
+    loading: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/SemanticTableCard.d.ts

@@ -0,0 +1,18 @@
+export default function SemanticTableCard({ semanticId, dataOverride, columnsOverride, title, subtitle, searchable, sortable, paginated, pageSize, compact, striped, isDark, simulateInitialLoad, minInitialDelayMs, maxInitialDelayMs, ...rest }: {
+    [x: string]: any;
+    semanticId: any;
+    dataOverride: any;
+    columnsOverride: any;
+    title: any;
+    subtitle: any;
+    searchable?: boolean | undefined;
+    sortable?: boolean | undefined;
+    paginated?: boolean | undefined;
+    pageSize?: number | undefined;
+    compact: any;
+    striped: any;
+    isDark: any;
+    simulateInitialLoad: any;
+    minInitialDelayMs: any;
+    maxInitialDelayMs: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/SemanticTableCardWithLoading.d.ts

@@ -0,0 +1,7 @@
+export default function SemanticTableCardWithLoading({ simulateInitialLoad, minInitialDelayMs, maxInitialDelayMs, loading: loadingProp, ...props }: {
+    [x: string]: any;
+    simulateInitialLoad?: boolean | undefined;
+    minInitialDelayMs?: number | undefined;
+    maxInitialDelayMs?: number | undefined;
+    loading: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/StatusCard.d.ts

@@ -0,0 +1,15 @@
+export default function StatusCard({ title, subtitle, status, items, layout, showProgress, showTimestamp, actions, loading, error, emptyMessage, maxBodyHeight, ...cardProps }: {
+    [x: string]: any;
+    title: any;
+    subtitle: any;
+    status?: string | undefined;
+    items?: never[] | undefined;
+    layout?: string | undefined;
+    showProgress?: boolean | undefined;
+    showTimestamp?: boolean | undefined;
+    actions: any;
+    loading?: boolean | undefined;
+    error: any;
+    emptyMessage?: string | undefined;
+    maxBodyHeight: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/TableCard.d.ts

@@ -0,0 +1,23 @@
+export default function TableCard({ data, columns, title, subtitle, searchable, sortable, paginated, selectable, pageSize, actions, rowActions, onRowSelect, onSort, onSearch, loading, error, emptyMessage, simulateInitialLoad, minInitialDelayMs, maxInitialDelayMs, ...cardProps }: {
+    [x: string]: any;
+    data?: never[] | undefined;
+    columns?: never[] | undefined;
+    title: any;
+    subtitle: any;
+    searchable?: boolean | undefined;
+    sortable?: boolean | undefined;
+    paginated?: boolean | undefined;
+    selectable?: boolean | undefined;
+    pageSize?: number | undefined;
+    actions: any;
+    rowActions: any;
+    onRowSelect: any;
+    onSort: any;
+    onSearch: any;
+    loading?: boolean | undefined;
+    error: any;
+    emptyMessage?: string | undefined;
+    simulateInitialLoad?: boolean | undefined;
+    minInitialDelayMs?: number | undefined;
+    maxInitialDelayMs?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/cards/WidgetCard.d.ts

@@ -0,0 +1,11 @@
+export default function WidgetCard({ header, sections, footer, divided, collapsible, defaultExpanded, loading, emptyMessage, ...cardProps }: {
+    [x: string]: any;
+    header: any;
+    sections?: never[] | undefined;
+    footer: any;
+    divided?: boolean | undefined;
+    collapsible?: boolean | undefined;
+    defaultExpanded?: boolean | undefined;
+    loading?: boolean | undefined;
+    emptyMessage?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/charts/D3Chart.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Minimal D3 chart host:
+ * - Owns the <svg> element
+ * - Computes responsive dimensions from container size
+ * - Calls renderChart(svgEl, data, dims, options)
+ */
+export default function D3Chart({ data, renderChart, options, width, height, responsive, aspectRatio, className, style, containerStyle, svgStyle, loading, error, ariaLabel }: {
+    data: any;
+    renderChart: any;
+    options?: {} | undefined;
+    width: any;
+    height?: number | undefined;
+    responsive?: boolean | undefined;
+    aspectRatio: any;
+    className?: string | undefined;
+    style: any;
+    containerStyle: any;
+    svgStyle: any;
+    loading?: boolean | undefined;
+    error: any;
+    ariaLabel?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/charts/D3ChartTemplates.d.ts

@@ -0,0 +1,4 @@
+export namespace D3ChartTemplates {
+    function lineChart(svg: any, data: any, dims: any, opts?: {}): void;
+    function groupedBarChart(svg: any, data: any, dims: any, opts?: {}): void;
+}

package/dist/components/library/charts/GeoMap.d.ts

@@ -0,0 +1,18 @@
+export default function GeoMap({ width, height, projection: projType, theme, markers, arcs, overlays, selectedId, onArcClick, onMarkerClick, zoomable, minZoom, maxZoom, initialBounds, className, children, }: {
+    width?: number | undefined;
+    height?: number | undefined;
+    projection?: string | undefined;
+    theme?: string | undefined;
+    markers?: never[] | undefined;
+    arcs?: never[] | undefined;
+    overlays?: never[] | undefined;
+    selectedId?: null | undefined;
+    onArcClick: any;
+    onMarkerClick: any;
+    zoomable?: boolean | undefined;
+    minZoom?: number | undefined;
+    maxZoom?: number | undefined;
+    initialBounds?: null | undefined;
+    className?: string | undefined;
+    children: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatBar.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Command-palette style AI chat bar.
+ *
+ * Collapsed: a slim, clickable input strip with sparkle icon and ⌘K hint.
+ * Expanded: a centered floating overlay (portal) with backdrop, full chat,
+ * suggestions, and message history. No layout shift.
+ *
+ * Activate: click the bar, press ⌘K / Ctrl+K, or click a suggestion chip.
+ * Dismiss: Escape or click the backdrop.
+ */
+export default function ChatBar({ onSend, suggestions, placeholder, title, initialMessages, className, panelHeight, renderAvatar, onOpenInTab, }: {
+    onSend: any;
+    suggestions?: never[] | undefined;
+    placeholder?: string | undefined;
+    title?: string | undefined;
+    initialMessages?: never[] | undefined;
+    className?: string | undefined;
+    panelHeight: any;
+    renderAvatar: any;
+    onOpenInTab: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatInput.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Chat input with auto-resize textarea, Send button, and keyboard shortcuts.
+ * Enter sends, Shift+Enter inserts newline.
+ *
+ * @param {Function} onSend — (content: string) => void
+ * @param {boolean}  disabled — disable input while agent is processing
+ * @param {boolean}  isLoading — show stop button instead of send
+ * @param {Function} onStop — optional: called when stop is clicked
+ * @param {string}   placeholder
+ * @param {number}   maxRows — max visible rows before scroll (default 6)
+ */
+export default function ChatInput({ onSend, disabled, isLoading, onStop, placeholder, maxRows, }: Function): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatMessage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Renders a single chat message.
+ *
+ * @param {Object} message — { id, role, content, components?, toolCalls?, isError?, isStreaming?, timestamp? }
+ * @param {React.ReactNode} avatar — custom avatar override
+ */
+export default function ChatMessage({ message, avatar }: Object): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatMessageList.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scrollable message area with auto-scroll to latest message.
+ *
+ * @param {Array}     messages — array of message objects
+ * @param {boolean}   isLoading — show typing indicator
+ * @param {boolean}   isStreaming — agent is streaming (show different indicator text)
+ * @param {string[]}  suggestions — follow-up suggestions shown after last assistant message
+ * @param {Function}  onSuggestion — (text) => void
+ * @param {Function}  renderAvatar — (message) => ReactNode, optional per-message avatar
+ */
+export default function ChatMessageList({ messages, isLoading, isStreaming, suggestions, onSuggestion, renderAvatar, }: any[]): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatPanel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * All-in-one chat panel. Composes ChatMessageList, ChatInput, ChatWelcome,
+ * and useChatState into a single drop-in component.
+ *
+ * @param {string}   title — panel header title
+ * @param {Function} onSend — async (userMessage, history, helpers) => assistantMessage?
+ * @param {Array}    initialMessages — seed messages
+ * @param {string}   welcomeTitle — welcome screen heading
+ * @param {string}   welcomeSubtitle — welcome screen description
+ * @param {string[]} suggestions — starter and follow-up prompts
+ * @param {string}   placeholder — input placeholder
+ * @param {string}   className — additional classes on the root container
+ * @param {Function} renderAvatar — (message) => ReactNode
+ * @param {boolean}  showHeader — show the title bar (default true)
+ */
+export default function ChatPanel({ title, onSend, initialMessages, welcomeTitle, welcomeSubtitle, suggestions, placeholder, className, renderAvatar, showHeader, }: string): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatSuggestions.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Quick-action prompt buttons. Place above the input or after an assistant message.
+ *
+ * @param {string[]} suggestions — prompt strings
+ * @param {Function} onSelect — (suggestion) => void
+ */
+export default function ChatSuggestions({ suggestions, onSelect }: string[]): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/library/chat/ChatToolCall.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Displays an agent tool call / function execution step.
+ *
+ * @param {Object} toolCall — { id?, name, args?, status: "running"|"complete"|"error", result? }
+ */
+export default function ChatToolCall({ toolCall }: Object): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatTypingIndicator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Animated typing indicator shown while the agent is processing.
+ */
+export default function ChatTypingIndicator({ label }: {
+    label?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatWelcome.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Empty-state welcome screen shown before the first message.
+ *
+ * @param {string} title — welcome heading
+ * @param {string} subtitle — description text
+ * @param {string[]} suggestions — starter prompt suggestions
+ * @param {Function} onSuggestion — (text) => void
+ * @param {React.ReactNode} icon — custom icon override
+ */
+export default function ChatWelcome({ title, subtitle, suggestions, onSuggestion, icon, }: string): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/index.d.ts

@@ -0,0 +1,10 @@
+export { default as ChatPanel } from "./ChatPanel";
+export { default as ChatBar } from "./ChatBar";
+export { default as ChatMessageList } from "./ChatMessageList";
+export { default as ChatMessage } from "./ChatMessage";
+export { default as ChatInput } from "./ChatInput";
+export { default as ChatTypingIndicator } from "./ChatTypingIndicator";
+export { default as ChatSuggestions } from "./ChatSuggestions";
+export { default as ChatToolCall } from "./ChatToolCall";
+export { default as ChatWelcome } from "./ChatWelcome";
+export { default as useChatState } from "./useChatState";

package/dist/components/library/chat/useChatState.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Core state management hook for AI chat.
+ *
+ * @param {Object} options
+ * @param {Array}  options.initialMessages — seed the conversation
+ * @param {Function} options.onSend — async (userMessage, allMessages) => assistantMessage | void
+ *   Return a message object to add it, or use appendChunk / addMessage for streaming.
+ *
+ * @returns {Object}
+ *
+ * @example
+ * const chat = useChatState({
+ *   onSend: async (msg, history) => {
+ *     const res = await fetch("/api/chat", { method: "POST", body: JSON.stringify({ messages: history }) });
+ *     const data = await res.json();
+ *     return { role: "assistant", content: data.reply, components: data.components };
+ *   },
+ * });
+ */
+export default function useChatState({ initialMessages, onSend }?: {
+    initialMessages: any[];
+    onSend: Function;
+}): Object;

package/dist/components/library/data/DataModeProvider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Read the current data mode from any component.
+ *
+ * @returns {{ mode: "sample"|"live", isSample: boolean, isLive: boolean, toggle: () => void, setMode: (mode) => void }}
+ */
+export function useDataMode(): {
+    mode: "sample" | "live";
+    isSample: boolean;
+    isLive: boolean;
+    toggle: () => void;
+    setMode: (mode: any) => void;
+};
+/**
+ * Provides global data-mode state (sample vs live) to the component tree.
+ * Persists to localStorage so the choice survives page reloads.
+ *
+ * Wrap once in _app.js alongside AppThemeProvider.
+ */
+export default function DataModeProvider({ initialMode, children }: {
+    initialMode?: string | undefined;
+    children: any;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/data/DataModeToggle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pill toggle for switching between sample and live data modes.
+ * Place in the AppShell header next to the theme toggle.
+ */
+export default function DataModeToggle({ className }: {
+    className?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/data/chartDataProvider.d.ts

@@ -0,0 +1,3 @@
+export function listSemanticIds(): string[];
+export function getSemanticDataset(semanticId: any): any;
+export function getSemanticMetric(semanticId: any, metricId: any): any;

package/dist/components/library/data/filterUtils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pure data utilities for filtering, sorting, and searching.
+ * Stateless — combine with usePageFilters hook for state management.
+ */
+/**
+ * Text search across multiple keys.
+ * @param {Array} data
+ * @param {string} query — search string
+ * @param {string[]} keys — object keys to search within
+ * @returns {Array} filtered data
+ */
+export function filterBySearch(data: any[], query: string, keys?: string[]): any[];
+/**
+ * Filter rows where key matches a specific value.
+ * Pass "all" or "" to skip filtering.
+ * @param {Array} data
+ * @param {string} key — object key to match
+ * @param {*} value — value to match (exact, case-insensitive for strings)
+ * @returns {Array}
+ */
+export function filterByValue(data: any[], key: string, value: any): any[];
+/**
+ * Filter rows where a boolean condition is met.
+ * When toggle is off, returns all data (no filtering).
+ * @param {Array} data
+ * @param {string} key — object key to check
+ * @param {boolean} isActive — whether the toggle is on
+ * @param {*} matchValue — value that key should equal when active (default: truthy check)
+ * @returns {Array}
+ */
+export function filterByToggle(data: any[], key: string, isActive: boolean, matchValue: any): any[];
+/**
+ * Filter rows where a date field falls within a range.
+ * @param {Array} data
+ * @param {string} key — object key containing date (ISO string or Date)
+ * @param {{ start?: Date|string, end?: Date|string }} range
+ * @returns {Array}
+ */
+export function filterByDateRange(data: any[], key: string, range: {
+    start?: Date | string;
+    end?: Date | string;
+}): any[];
+/**
+ * Sort data by a key.
+ * @param {Array} data
+ * @param {string} key — object key to sort by
+ * @param {"asc"|"desc"} direction
+ * @returns {Array} new sorted array
+ */
+export function sortByKey(data: any[], key: string, direction?: "asc" | "desc"): any[];
+/**
+ * Apply a set of filter definitions to data.
+ * Each filter in `filters` has { id, type, key/keys } and `values` holds the current state.
+ *
+ * @param {Array} data
+ * @param {Array} filters — filter definitions [{ id, type, key?, keys? }]
+ * @param {Object} values — current filter values keyed by filter id
+ * @returns {Array} filtered data
+ */
+export function applyFilters(data: any[], filters?: any[], values?: Object): any[];

package/dist/components/library/data/useDataSource.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Select between sample and live data based on the global data mode.
+ *
+ * Values can be plain data or functions (lazy-evaluated only when active).
+ *
+ * @param {{ sample: any | () => any, live: any | () => any }} sources
+ * @returns {any} the resolved value for the active mode
+ *
+ * @example
+ * // Static data
+ * const incidents = useDataSource({
+ *   sample: sampleIncidents,
+ *   live: fetchedIncidents,
+ * });
+ *
+ * @example
+ * // Lazy — factory only runs when that mode is active
+ * const metrics = useDataSource({
+ *   sample: () => generateSampleMetrics(),
+ *   live: () => computeFromAPI(apiData),
+ * });
+ */
+export default function useDataSource({ sample, live }: {
+    sample: any | (() => any);
+    live: any | (() => any);
+}): any;

package/dist/components/library/data/usePageFilters.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hook for managing page-level filter and sort state.
+ *
+ * @param {Object} options
+ * @param {Array}  options.data — raw data array
+ * @param {Array}  options.filters — filter definitions [{ id, type, key?, keys?, defaultValue? }]
+ * @param {Object} options.defaultSort — { key, direction } or null
+ * @returns {Object} { values, setFilter, resetFilters, sort, setSort, filteredData, sortedData, activeFilterCount }
+ *
+ * @example
+ * const { values, setFilter, resetFilters, sortedData } = usePageFilters({
+ *   data: incidents,
+ *   filters: [
+ *     { id: "search", type: "search", keys: ["title", "description"] },
+ *     { id: "severity", type: "select", key: "severity", defaultValue: "all" },
+ *     { id: "active", type: "toggle", key: "resolved", matchValue: false },
+ *   ],
+ *   defaultSort: { key: "timestamp", direction: "desc" },
+ * });
+ */
+export default function usePageFilters({ data, filters, defaultSort }?: {
+    data: any[];
+    filters: any[];
+    defaultSort: Object;
+}): Object;

package/dist/components/library/filters/FilterBar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Renders a row of filter controls from a definitions array.
+ * Pairs with usePageFilters hook for state management.
+ *
+ * @param {Array}    filters — filter definitions [{ id, type, ... }]
+ * @param {Object}   values  — current filter values keyed by filter id
+ * @param {Function} onChange — (filterId, value) => void
+ * @param {Function} onReset  — () => void
+ * @param {number}   activeCount — number of active filters (for badge)
+ * @param {string}   layout — "inline" (default) or "stacked"
+ */
+export default function FilterBar({ filters, values, onChange, onReset, activeCount, layout, }: any[]): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/library/filters/SearchFilter.d.ts

@@ -0,0 +1,6 @@
+export default function SearchFilter({ value, onChange, placeholder, className, }: {
+    value?: string | undefined;
+    onChange: any;
+    placeholder?: string | undefined;
+    className?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;