@mcp-elements/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mayur Rawte
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,535 @@
+declare function cn(...inputs: (string | undefined | null | false)[]): string;
+
+declare function getFocusableElements(container: HTMLElement): HTMLElement[];
+declare function trapFocus(container: HTMLElement, event: KeyboardEvent): void;
+declare function createClickOutsideHandler(element: HTMLElement, callback: () => void): () => void;
+declare function lockScroll(): () => void;
+
+declare const Keys: {
+    readonly Enter: "Enter";
+    readonly Space: " ";
+    readonly Escape: "Escape";
+    readonly ArrowUp: "ArrowUp";
+    readonly ArrowDown: "ArrowDown";
+    readonly ArrowLeft: "ArrowLeft";
+    readonly ArrowRight: "ArrowRight";
+    readonly Home: "Home";
+    readonly End: "End";
+    readonly Tab: "Tab";
+};
+type KeyboardDirection = 'horizontal' | 'vertical' | 'both';
+declare function getNextIndex(current: number, total: number, direction: 'next' | 'prev', loop?: boolean): number;
+declare function handleArrowNavigation(event: KeyboardEvent, currentIndex: number, totalItems: number, orientation: KeyboardDirection, onIndexChange: (index: number) => void, loop?: boolean): void;
+
+interface DialogConfig {
+    modal?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function createDialog(config?: DialogConfig): {
+    id: string;
+    getTriggerProps: (isOpen: boolean) => {
+        'aria-haspopup': "dialog";
+        'aria-expanded': boolean;
+        onClick: () => void | undefined;
+    };
+    getContentProps: (isOpen: boolean) => {
+        role: "dialog";
+        'aria-modal': boolean;
+        'aria-labelledby': string;
+        'aria-describedby': string;
+        hidden: boolean | undefined;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+    getOverlayProps: () => {
+        'aria-hidden': true;
+        onClick: () => void | undefined;
+    };
+    getCloseProps: () => {
+        'aria-label': string;
+        onClick: () => void | undefined;
+    };
+};
+
+interface TabsConfig {
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+}
+interface TabItem {
+    value: string;
+    disabled?: boolean;
+}
+declare function createTabs(items: TabItem[], config?: TabsConfig): {
+    getListProps: () => {
+        role: "tablist";
+    };
+    getTriggerProps: (value: string, activeValue: string) => {
+        role: "tab";
+        'aria-selected': boolean;
+        'aria-controls': string;
+        id: string;
+        tabIndex: number;
+        disabled: boolean;
+        onClick: () => void;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+    getPanelProps: (value: string, activeValue: string) => {
+        role: "tabpanel";
+        id: string;
+        'aria-labelledby': string;
+        hidden: true | undefined;
+        tabIndex: number;
+    };
+};
+
+interface AccordionConfig {
+    type?: 'single' | 'multiple';
+    collapsible?: boolean;
+    onValueChange?: (value: string[]) => void;
+}
+interface AccordionItemConfig {
+    value: string;
+    disabled?: boolean;
+}
+declare function createAccordion(items: AccordionItemConfig[], config?: AccordionConfig): {
+    getItemProps: (value: string) => {
+        'data-value': string;
+    };
+    getTriggerProps: (value: string, expandedValues: string[]) => {
+        'aria-expanded': boolean;
+        'aria-controls': string;
+        id: string;
+        disabled: boolean;
+        onClick: () => void;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+    getContentProps: (value: string, expandedValues: string[]) => {
+        role: "region";
+        id: string;
+        'aria-labelledby': string;
+        hidden: boolean | undefined;
+    };
+};
+
+interface SelectConfig {
+    onValueChange?: (value: string) => void;
+    onOpenChange?: (open: boolean) => void;
+}
+interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+declare function createSelect(options: SelectOption[], config?: SelectConfig): {
+    getTriggerProps: (isOpen: boolean, selectedValue: string | null, highlightedIndex?: number) => {
+        role: "combobox";
+        'aria-expanded': boolean;
+        'aria-haspopup': "listbox";
+        'aria-label': string;
+        'aria-activedescendant': string | undefined;
+        onClick: () => void | undefined;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+    getListProps: () => {
+        role: "listbox";
+    };
+    getOptionProps: (option: SelectOption, isHighlighted: boolean, selectedValue: string | null, _highlightedIndex: number) => {
+        role: "option";
+        'aria-selected': boolean;
+        'aria-disabled': true | undefined;
+        'data-highlighted': true | undefined;
+        id: string;
+        onClick: () => void;
+    };
+    getContentProps: (isOpen: boolean) => {
+        hidden: boolean | undefined;
+    };
+    handleKeyDown: (e: KeyboardEvent, isOpen: boolean, highlightedIndex: number, onHighlightChange: (index: number) => void) => void;
+};
+
+interface TooltipConfig {
+    delay?: number;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function createTooltip(config?: TooltipConfig): {
+    getTriggerProps: () => {
+        'aria-describedby': string;
+        onMouseEnter: () => void;
+        onMouseLeave: () => void;
+        onFocus: () => void;
+        onBlur: () => void;
+    };
+    getContentProps: (isOpen: boolean) => {
+        id: string;
+        role: "tooltip";
+        hidden: boolean | undefined;
+    };
+    destroy: () => void;
+};
+
+interface PopoverConfig {
+    onOpenChange?: (open: boolean) => void;
+}
+declare function createPopover(config?: PopoverConfig): {
+    getTriggerProps: (isOpen: boolean) => {
+        'aria-haspopup': true;
+        'aria-expanded': boolean;
+        onClick: () => void | undefined;
+    };
+    getContentProps: (isOpen: boolean) => {
+        role: "dialog";
+        hidden: true | undefined;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+};
+
+interface ToastConfig {
+    duration?: number;
+}
+interface Toast {
+    id: string;
+    title?: string;
+    description?: string;
+    variant?: 'default' | 'destructive' | 'success';
+    duration?: number;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+interface ToastState {
+    toasts: Toast[];
+}
+declare function createToastManager(config?: ToastConfig): {
+    addToast: (toast: Omit<Toast, "id">) => string;
+    removeToast: (id: string) => void;
+    subscribe: (listener: (state: ToastState) => void) => () => void;
+    getState: () => ToastState;
+};
+declare const toast: {
+    default: (title: string, description?: string) => string;
+    success: (title: string, description?: string) => string;
+    destructive: (title: string, description?: string) => string;
+    custom: (t: Omit<Toast, "id">) => string;
+    dismiss: (id: string) => void;
+    subscribe: (listener: (state: ToastState) => void) => () => void;
+    getState: () => ToastState;
+};
+
+interface DrawerConfig {
+    side?: 'left' | 'right' | 'top' | 'bottom';
+    onOpenChange?: (open: boolean) => void;
+}
+declare function createDrawer(config?: DrawerConfig): {
+    getOverlayProps: () => {
+        'aria-hidden': true;
+        onClick: () => void | undefined;
+    };
+    getContentProps: (isOpen: boolean) => {
+        role: "dialog";
+        'aria-modal': boolean;
+        hidden: boolean | undefined;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+    getCloseProps: () => {
+        'aria-label': string;
+        onClick: () => void | undefined;
+    };
+    side: "left" | "right" | "top" | "bottom";
+};
+
+interface DropdownMenuConfig {
+    onOpenChange?: (open: boolean) => void;
+}
+interface DropdownMenuItem {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    type?: 'item' | 'separator' | 'label';
+    shortcut?: string;
+    onSelect?: () => void;
+}
+declare function createDropdownMenu(items: DropdownMenuItem[], config?: DropdownMenuConfig): {
+    getTriggerProps: (isOpen: boolean) => {
+        'aria-haspopup': "menu";
+        'aria-expanded': boolean;
+        onClick: () => void | undefined;
+    };
+    getContentProps: (isOpen: boolean) => {
+        role: "menu";
+        hidden: true | undefined;
+    };
+    getItemProps: (item: DropdownMenuItem, isHighlighted: boolean) => {
+        role: "menuitem";
+        'aria-disabled': true | undefined;
+        'data-highlighted': true | undefined;
+        tabIndex: number;
+        onClick: () => void;
+    };
+    handleKeyDown: (e: KeyboardEvent, isOpen: boolean, highlightedIndex: number, onHighlightChange: (index: number) => void) => void;
+};
+
+interface SwitchConfig {
+    onCheckedChange?: (checked: boolean) => void;
+}
+declare function createSwitch(config?: SwitchConfig): {
+    getSwitchProps: (checked: boolean, disabled?: boolean) => {
+        role: "switch";
+        'aria-checked': boolean;
+        'aria-disabled': true | undefined;
+        tabIndex: number;
+        onClick: () => void;
+        onKeyDown: (e: KeyboardEvent) => void;
+    };
+};
+
+interface BaseMetadata {
+    name: string;
+    title?: string;
+}
+interface Icons {
+    icons?: Array<{
+        src: string;
+        mimeType?: string;
+        sizes?: string[];
+        theme?: 'light' | 'dark';
+    }>;
+}
+interface Implementation extends BaseMetadata, Icons {
+    version: string;
+    description?: string;
+    websiteUrl?: string;
+}
+interface ServerCapabilities {
+    experimental?: Record<string, object>;
+    logging?: object;
+    completions?: object;
+    prompts?: {
+        listChanged?: boolean;
+    };
+    resources?: {
+        subscribe?: boolean;
+        listChanged?: boolean;
+    };
+    tools?: {
+        listChanged?: boolean;
+    };
+    tasks?: {
+        list?: object;
+        cancel?: object;
+        requests?: {
+            tools?: {
+                call?: object;
+            };
+        };
+    };
+}
+interface JsonSchema {
+    $schema?: string;
+    type: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'null';
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+    description?: string;
+    title?: string;
+    format?: string;
+    enum?: unknown[];
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    items?: JsonSchema;
+}
+interface Tool extends BaseMetadata, Icons {
+    description?: string;
+    inputSchema: JsonSchema & {
+        type: 'object';
+    };
+    outputSchema?: JsonSchema & {
+        type: 'object';
+    };
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+}
+interface Resource extends BaseMetadata, Icons {
+    uri: string;
+    mimeType?: string;
+    description?: string;
+    size?: number;
+}
+interface Prompt extends BaseMetadata, Icons {
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource';
+    resource: Resource & {
+        text?: string;
+        blob?: string;
+    };
+};
+interface CallToolResult {
+    content: ContentBlock[];
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+}
+interface UiResource {
+    uri: string;
+    mimeType: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+type ToolCallStatus = 'idle' | 'pending' | 'running' | 'done' | 'error' | 'cancelled';
+interface ScopeDescriptor {
+    raw: string;
+    resource: string;
+    permissions: string[];
+    description?: string;
+}
+
+declare function parseScope(raw: string): ScopeDescriptor;
+declare function parseScopes(scopeString: string): ScopeDescriptor[];
+
+interface ToolStateSnapshot {
+    status: ToolCallStatus;
+    tool?: string;
+    args?: Record<string, unknown>;
+    result?: CallToolResult;
+    error?: Error;
+    startedAt?: number;
+    endedAt?: number;
+}
+interface ToolStateApi extends Readonly<ToolStateSnapshot> {
+    start(input: {
+        tool: string;
+        args: Record<string, unknown>;
+    }): void;
+    markRunning(): void;
+    markDone(result: CallToolResult): void;
+    markError(error: Error): void;
+    cancel(): void;
+    reset(): void;
+    subscribe(fn: (snapshot: ToolStateSnapshot) => void): () => void;
+}
+declare function createToolState(): ToolStateApi;
+
+type FieldKind = 'text' | 'textarea' | 'email' | 'url' | 'date' | 'number' | 'switch' | 'select' | 'multiselect' | 'unknown';
+interface FieldDescriptor {
+    key: string;
+    kind: FieldKind;
+    label: string;
+    help?: string;
+    required: boolean;
+    defaultValue?: unknown;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+declare function schemaToFields(schema: JsonSchema): FieldDescriptor[];
+
+interface PkcePair {
+    codeVerifier: string;
+    codeChallenge: string;
+    codeChallengeMethod: 'S256';
+}
+declare function generatePkcePair(): Promise<PkcePair>;
+interface AuthUrlInput {
+    authorizationEndpoint: string;
+    clientId: string;
+    redirectUri: string;
+    scope: string;
+    codeChallenge: string;
+    state: string;
+    resource?: string;
+}
+declare function buildAuthUrl(input: AuthUrlInput): string;
+interface TokenExchangeInput {
+    clientId: string;
+    code: string;
+    redirectUri: string;
+    codeVerifier: string;
+}
+declare function buildTokenExchangeBody(input: TokenExchangeInput): string;
+interface TokenRefreshInput {
+    clientId: string;
+    refreshToken: string;
+    scope?: string;
+}
+declare function buildTokenRefreshBody(input: TokenRefreshInput): string;
+type OAuthStatus = 'idle' | 'authorizing' | 'authorized' | 'denied' | 'error';
+interface OAuthTokens {
+    accessToken: string;
+    tokenType: string;
+    expiresIn?: number;
+    refreshToken?: string;
+    scope?: string;
+}
+interface OAuthFlowSnapshot {
+    status: OAuthStatus;
+    verifier?: string;
+    state?: string;
+    tokens?: OAuthTokens;
+    error?: {
+        code: string;
+        message?: string;
+        originalError?: Error;
+    };
+}
+interface OAuthFlowApi extends Readonly<OAuthFlowSnapshot> {
+    start(input: {
+        verifier: string;
+        state: string;
+    }): void;
+    markAuthorized(tokens: OAuthTokens): void;
+    markDenied(code: string, message?: string): void;
+    markError(error: Error): void;
+    reset(): void;
+    subscribe(fn: (s: OAuthFlowSnapshot) => void): () => void;
+}
+declare function createOAuthFlow(): OAuthFlowApi;
+
+interface AppMessageEnvelope {
+    id: string;
+    type: string;
+    payload?: unknown;
+}
+declare function encodeEnvelope(env: AppMessageEnvelope): AppMessageEnvelope;
+declare function decodeEnvelope(raw: unknown): AppMessageEnvelope | null;
+interface AppBridgeConfig {
+    postMessage: (env: AppMessageEnvelope) => void;
+}
+interface AppBridge {
+    send(env: AppMessageEnvelope): void;
+    receive(raw: unknown): void;
+    onMessage(fn: (env: AppMessageEnvelope) => void): () => void;
+}
+declare function createAppBridge(config: AppBridgeConfig): AppBridge;
+
+export { type AccordionConfig, type AccordionItemConfig, type AppBridge, type AppBridgeConfig, type AppMessageEnvelope, type AuthUrlInput, type BaseMetadata, type CallToolResult, type ContentBlock, type DialogConfig, type DrawerConfig, type DropdownMenuConfig, type DropdownMenuItem, type FieldDescriptor, type FieldKind, type Icons, type Implementation, type JsonSchema, type KeyboardDirection, Keys, type OAuthFlowApi, type OAuthFlowSnapshot, type OAuthStatus, type OAuthTokens, type PkcePair, type PopoverConfig, type Prompt, type Resource, type ScopeDescriptor, type SelectConfig, type SelectOption, type ServerCapabilities, type SwitchConfig, type TabItem, type TabsConfig, type Toast, type ToastConfig, type ToastState, type TokenExchangeInput, type TokenRefreshInput, type Tool, type ToolCallStatus, type ToolStateApi, type ToolStateSnapshot, type TooltipConfig, type UiResource, buildAuthUrl, buildTokenExchangeBody, buildTokenRefreshBody, cn, createAccordion, createAppBridge, createClickOutsideHandler, createDialog, createDrawer, createDropdownMenu, createOAuthFlow, createPopover, createSelect, createSwitch, createTabs, createToastManager, createToolState, createTooltip, decodeEnvelope, encodeEnvelope, generatePkcePair, getFocusableElements, getNextIndex, handleArrowNavigation, lockScroll, parseScope, parseScopes, schemaToFields, toast, trapFocus };