@quilltap/plugin-types 1.0.3 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2025-12-31
+
+### Added
+
+- Roleplay template plugin types:
+  - `RoleplayTemplatePlugin` main interface for roleplay template plugins
+  - `RoleplayTemplateMetadata` for template identification and display
+  - `RoleplayTemplateConfig` for individual template configuration
+  - `RoleplayTemplatePluginExport` standard export type
+- Added `ROLEPLAY_TEMPLATE` to `PluginCapability` type
+- Added `TEMPLATE` to `PluginCategory` type
+- Exported roleplay template types via `@quilltap/plugin-types/plugins`
+
+## [1.1.0] - 2025-12-31
+
+### Added
+
+- Theme plugin types for self-contained theme plugins:
+  - `ThemePlugin` main interface for theme plugins
+  - `ThemeMetadata` for theme identification and display
+  - `ThemeTokens` complete theme token structure
+  - `ColorPalette` for light and dark mode colors
+  - `Typography`, `Spacing`, `Effects` for design tokens
+  - `FontDefinition` for font loading configuration
+  - `EmbeddedFont` for self-contained font embedding
+  - `ThemePluginExport` standard export type
+- Exported theme types via `@quilltap/plugin-types/plugins`
+
 ## [1.0.3] - 2025-12-30
 
 ### Added

package/dist/{index-BJ_sGB3K.d.mts → index-DkdHzVYa.d.mts}

@@ -337,11 +337,11 @@ interface ProviderPluginExport {
 /**
  * Plugin capability types
  */
-type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'UTILITY';
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'UTILITY';
 /**
  * Plugin category
  */
-type PluginCategory = 'PROVIDER' | 'AUTH' | 'STORAGE' | 'UI' | 'UTILITY';
+type PluginCategory = 'PROVIDER' | 'AUTH' | 'STORAGE' | 'UI' | 'TEMPLATE' | 'UTILITY';
 /**
  * Plugin status
  */
@@ -493,4 +493,470 @@ interface InstalledPluginInfo extends PluginManifest {
     installPath?: string;
 }
 
-export type { AttachmentSupport as A, CheapModelConfig as C, EmbeddingModelInfo as E, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, ToolFormatType as T, ProviderConfigRequirements as a, ProviderCapabilities as b, ImageProviderConstraints as c, IconProps as d, ProviderPluginExport as e, MessageFormatSupport as f, PluginCapability as g, PluginCategory as h, PluginStatus as i, PluginAuthor as j, PluginCompatibility as k, ProviderConfig as l, PluginPermissions as m, PluginManifest as n, InstalledPluginInfo as o };
+/**
+ * Theme Plugin Interface types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/plugins/theme
+ */
+/**
+ * Color palette for a single color mode (light or dark)
+ *
+ * Colors can be specified as:
+ * - HSL values: "222.2 84% 4.9%" (without hsl() wrapper)
+ * - Full HSL: "hsl(222.2 84% 4.9%)"
+ * - Hex: "#1a1a2e"
+ * - Other valid CSS color values: rgb(), oklch(), etc.
+ */
+interface ColorPalette {
+    /** Main background color */
+    background: string;
+    /** Main text color */
+    foreground: string;
+    /** Primary brand/action color */
+    primary: string;
+    /** Text on primary color */
+    primaryForeground: string;
+    /** Secondary background color */
+    secondary: string;
+    /** Text on secondary color */
+    secondaryForeground: string;
+    /** Muted background for less prominent elements */
+    muted: string;
+    /** Muted text color */
+    mutedForeground: string;
+    /** Accent color for highlights */
+    accent: string;
+    /** Text on accent color */
+    accentForeground: string;
+    /** Error/destructive action color */
+    destructive: string;
+    /** Text on destructive color */
+    destructiveForeground: string;
+    /** Card background color */
+    card: string;
+    /** Card text color */
+    cardForeground: string;
+    /** Popover/dropdown background */
+    popover: string;
+    /** Popover text color */
+    popoverForeground: string;
+    /** Default border color */
+    border: string;
+    /** Input field border color */
+    input: string;
+    /** Focus ring color */
+    ring: string;
+    /** Success state color */
+    success?: string;
+    /** Text on success color */
+    successForeground?: string;
+    /** Warning state color */
+    warning?: string;
+    /** Text on warning color */
+    warningForeground?: string;
+    /** Info state color */
+    info?: string;
+    /** Text on info color */
+    infoForeground?: string;
+    /** User message bubble background */
+    chatUser?: string;
+    /** User message bubble text */
+    chatUserForeground?: string;
+}
+/**
+ * Typography token configuration
+ */
+interface Typography {
+    /** Sans-serif font stack (default: "Inter, system-ui, sans-serif") */
+    fontSans?: string;
+    /** Serif font stack (default: "Georgia, serif") */
+    fontSerif?: string;
+    /** Monospace font stack (default: "ui-monospace, SFMono-Regular, monospace") */
+    fontMono?: string;
+    /** Extra small text - 12px (default: "0.75rem") */
+    fontSizeXs?: string;
+    /** Small text - 14px (default: "0.875rem") */
+    fontSizeSm?: string;
+    /** Base text size - 16px (default: "1rem") */
+    fontSizeBase?: string;
+    /** Large text - 18px (default: "1.125rem") */
+    fontSizeLg?: string;
+    /** Extra large text - 20px (default: "1.25rem") */
+    fontSizeXl?: string;
+    /** 2XL text - 24px (default: "1.5rem") */
+    fontSize2xl?: string;
+    /** 3XL text - 30px (default: "1.875rem") */
+    fontSize3xl?: string;
+    /** 4XL text - 36px (default: "2.25rem") */
+    fontSize4xl?: string;
+    /** Tight line height (default: "1.25") */
+    lineHeightTight?: string;
+    /** Normal line height (default: "1.5") */
+    lineHeightNormal?: string;
+    /** Relaxed line height (default: "1.75") */
+    lineHeightRelaxed?: string;
+    /** Normal font weight (default: "400") */
+    fontWeightNormal?: string;
+    /** Medium font weight (default: "500") */
+    fontWeightMedium?: string;
+    /** Semibold font weight (default: "600") */
+    fontWeightSemibold?: string;
+    /** Bold font weight (default: "700") */
+    fontWeightBold?: string;
+    /** Tight letter spacing (default: "-0.025em") */
+    letterSpacingTight?: string;
+    /** Normal letter spacing (default: "0") */
+    letterSpacingNormal?: string;
+    /** Wide letter spacing (default: "0.025em") */
+    letterSpacingWide?: string;
+}
+/**
+ * Spacing and layout token configuration
+ */
+interface Spacing {
+    /** Small border radius (default: "calc(0.5rem - 4px)") */
+    radiusSm?: string;
+    /** Medium border radius (default: "calc(0.5rem - 2px)") */
+    radiusMd?: string;
+    /** Large border radius (default: "0.5rem") */
+    radiusLg?: string;
+    /** Extra large border radius (default: "0.75rem") */
+    radiusXl?: string;
+    /** Full/pill border radius (default: "9999px") */
+    radiusFull?: string;
+    /** 4px spacing (default: "0.25rem") */
+    spacing1?: string;
+    /** 8px spacing (default: "0.5rem") */
+    spacing2?: string;
+    /** 12px spacing (default: "0.75rem") */
+    spacing3?: string;
+    /** 16px spacing (default: "1rem") */
+    spacing4?: string;
+    /** 20px spacing (default: "1.25rem") */
+    spacing5?: string;
+    /** 24px spacing (default: "1.5rem") */
+    spacing6?: string;
+    /** 32px spacing (default: "2rem") */
+    spacing8?: string;
+    /** 40px spacing (default: "2.5rem") */
+    spacing10?: string;
+    /** 48px spacing (default: "3rem") */
+    spacing12?: string;
+    /** 64px spacing (default: "4rem") */
+    spacing16?: string;
+}
+/**
+ * Visual effects token configuration
+ */
+interface Effects {
+    /** Small shadow (default: "0 1px 2px 0 rgb(0 0 0 / 0.05)") */
+    shadowSm?: string;
+    /** Medium shadow (default: "0 4px 6px -1px rgb(0 0 0 / 0.1)") */
+    shadowMd?: string;
+    /** Large shadow (default: "0 10px 15px -3px rgb(0 0 0 / 0.1)") */
+    shadowLg?: string;
+    /** Extra large shadow (default: "0 20px 25px -5px rgb(0 0 0 / 0.1)") */
+    shadowXl?: string;
+    /** Fast transition duration (default: "150ms") */
+    transitionFast?: string;
+    /** Normal transition duration (default: "200ms") */
+    transitionNormal?: string;
+    /** Slow transition duration (default: "300ms") */
+    transitionSlow?: string;
+    /** Default easing function (default: "cubic-bezier(0.4, 0, 0.2, 1)") */
+    transitionEasing?: string;
+    /** Focus ring width (default: "2px") */
+    focusRingWidth?: string;
+    /** Focus ring offset (default: "2px") */
+    focusRingOffset?: string;
+}
+/**
+ * Complete theme tokens structure
+ *
+ * Contains all customizable values for a theme:
+ * - colors: Required light and dark mode color palettes
+ * - typography: Optional font customization
+ * - spacing: Optional spacing/radius customization
+ * - effects: Optional shadows/transitions customization
+ */
+interface ThemeTokens {
+    /** Light and dark mode color palettes (required) */
+    colors: {
+        /** Light mode color palette */
+        light: ColorPalette;
+        /** Dark mode color palette */
+        dark: ColorPalette;
+    };
+    /** Typography customization (optional) */
+    typography?: Typography;
+    /** Spacing and radius customization (optional) */
+    spacing?: Spacing;
+    /** Shadow and transition customization (optional) */
+    effects?: Effects;
+}
+/**
+ * Custom font definition for themes that include custom fonts
+ */
+interface FontDefinition {
+    /** Font family name */
+    family: string;
+    /** Font source URL or relative path */
+    src: string;
+    /** Font weight (e.g., "400", "700", "400 700") */
+    weight?: string;
+    /** Font style (e.g., "normal", "italic") */
+    style?: string;
+    /** Font display strategy */
+    display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+}
+/**
+ * Loaded font with binary data (for self-contained themes)
+ */
+interface EmbeddedFont {
+    /** Font family name */
+    family: string;
+    /** Font weight */
+    weight: string;
+    /** Font style */
+    style?: string;
+    /** Base64-encoded font data or data URL */
+    data: string;
+    /** MIME type of the font */
+    mimeType?: string;
+}
+/**
+ * Theme plugin metadata for UI display and identification
+ */
+interface ThemeMetadata {
+    /** Unique theme identifier (lowercase, hyphens allowed) */
+    themeId: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Theme description */
+    description?: string;
+    /** Theme author */
+    author?: string | {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /** Whether this theme provides dark mode support */
+    supportsDarkMode: boolean;
+    /** Theme tags for categorization */
+    tags?: string[];
+    /** Base64-encoded preview image or path */
+    previewImage?: string;
+}
+/**
+ * Main Theme Plugin Interface
+ *
+ * Plugins implementing this interface can be dynamically loaded
+ * by Quilltap to provide custom theming.
+ *
+ * Self-contained themes export all data directly in the plugin object,
+ * with no file system dependencies after module load.
+ *
+ * @example
+ * ```typescript
+ * import type { ThemePlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: ThemePlugin = {
+ *   metadata: {
+ *     themeId: 'my-theme',
+ *     displayName: 'My Custom Theme',
+ *     description: 'A beautiful custom theme',
+ *     supportsDarkMode: true,
+ *     tags: ['dark', 'minimal'],
+ *   },
+ *   tokens: {
+ *     colors: {
+ *       light: {
+ *         background: 'hsl(0 0% 100%)',
+ *         foreground: 'hsl(222.2 84% 4.9%)',
+ *         // ... all required colors
+ *       },
+ *       dark: {
+ *         background: 'hsl(222.2 84% 4.9%)',
+ *         foreground: 'hsl(210 40% 98%)',
+ *         // ... all required colors
+ *       },
+ *     },
+ *     typography: {
+ *       fontSans: '"Custom Font", system-ui, sans-serif',
+ *     },
+ *   },
+ *   cssOverrides: `
+ *     .qt-button-primary {
+ *       border-radius: 9999px;
+ *     }
+ *   `,
+ *   fonts: [
+ *     { family: 'Custom Font', weight: '400', data: 'base64...' },
+ *   ],
+ * };
+ * ```
+ */
+interface ThemePlugin {
+    /** Theme metadata for UI display and identification */
+    metadata: ThemeMetadata;
+    /** Theme design tokens (colors, typography, spacing, effects) */
+    tokens: ThemeTokens;
+    /**
+     * Optional CSS overrides for component-level customization (Tier 3)
+     * This CSS is injected when the theme is active
+     */
+    cssOverrides?: string;
+    /**
+     * Optional embedded fonts
+     * Base64-encoded font data for fully self-contained themes
+     */
+    fonts?: EmbeddedFont[];
+    /**
+     * Optional method for dynamic token generation
+     * Called when color mode changes, allows computed theme values
+     * @param mode Current color mode ('light' | 'dark')
+     */
+    getTokensForMode?: (mode: 'light' | 'dark') => ThemeTokens;
+    /**
+     * Optional initialization function
+     * Called when the theme is loaded
+     */
+    initialize?: () => void | Promise<void>;
+}
+/**
+ * Standard export type for theme plugins
+ */
+interface ThemePluginExport {
+    /** The theme plugin instance */
+    plugin: ThemePlugin;
+}
+
+/**
+ * Roleplay Template Plugin Interface types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/plugins/roleplay-template
+ */
+/**
+ * Configuration for a single roleplay template
+ *
+ * A roleplay template defines a formatting protocol for AI responses,
+ * such as how dialogue, actions, thoughts, and OOC comments should be formatted.
+ */
+interface RoleplayTemplateConfig {
+    /** Display name for the template */
+    name: string;
+    /** Optional description explaining the template's formatting style */
+    description?: string;
+    /**
+     * The system prompt that defines the formatting rules.
+     * This is prepended to character system prompts when the template is active.
+     */
+    systemPrompt: string;
+    /** Tags for categorization and searchability */
+    tags?: string[];
+}
+/**
+ * Metadata for a roleplay template plugin
+ */
+interface RoleplayTemplateMetadata {
+    /**
+     * Unique template identifier (lowercase, hyphens allowed)
+     * This is typically derived from the plugin name
+     */
+    templateId: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Template description */
+    description?: string;
+    /** Template author */
+    author?: string | {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /** Template tags for categorization */
+    tags?: string[];
+    /** Template version */
+    version?: string;
+}
+/**
+ * Main Roleplay Template Plugin Interface
+ *
+ * Plugins implementing this interface can be dynamically loaded
+ * by Quilltap to provide custom roleplay formatting templates.
+ *
+ * A plugin can provide one or more templates. Each template defines
+ * a unique formatting protocol for AI responses.
+ *
+ * @example
+ * ```typescript
+ * import type { RoleplayTemplatePlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: RoleplayTemplatePlugin = {
+ *   metadata: {
+ *     templateId: 'my-rp-format',
+ *     displayName: 'My RP Format',
+ *     description: 'A custom roleplay formatting style',
+ *     tags: ['custom', 'roleplay'],
+ *   },
+ *   templates: [
+ *     {
+ *       name: 'My RP Format',
+ *       description: 'Custom formatting with specific syntax',
+ *       systemPrompt: `[FORMATTING INSTRUCTIONS]
+ * 1. Dialogue: Use quotation marks
+ * 2. Actions: Use asterisks *like this*
+ * ...`,
+ *       tags: ['custom'],
+ *     },
+ *   ],
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Plugin with multiple templates
+ * import type { RoleplayTemplatePlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: RoleplayTemplatePlugin = {
+ *   metadata: {
+ *     templateId: 'format-pack',
+ *     displayName: 'RP Format Pack',
+ *     description: 'A collection of roleplay formats',
+ *   },
+ *   templates: [
+ *     {
+ *       name: 'Screenplay',
+ *       systemPrompt: '...',
+ *     },
+ *     {
+ *       name: 'Novel',
+ *       systemPrompt: '...',
+ *     },
+ *   ],
+ * };
+ * ```
+ */
+interface RoleplayTemplatePlugin {
+    /** Plugin metadata for UI display and identification */
+    metadata: RoleplayTemplateMetadata;
+    /**
+     * One or more roleplay templates provided by this plugin.
+     * Each template has its own name, description, and system prompt.
+     */
+    templates: RoleplayTemplateConfig[];
+    /**
+     * Optional initialization function
+     * Called when the plugin is loaded
+     */
+    initialize?: () => void | Promise<void>;
+}
+/**
+ * Standard export type for roleplay template plugins
+ */
+interface RoleplayTemplatePluginExport {
+    /** The roleplay template plugin instance */
+    plugin: RoleplayTemplatePlugin;
+}
+
+export type { AttachmentSupport as A, CheapModelConfig as C, EmbeddingModelInfo as E, FontDefinition as F, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, RoleplayTemplateConfig as R, Spacing as S, ToolFormatType as T, ProviderConfigRequirements as a, ProviderCapabilities as b, ImageProviderConstraints as c, IconProps as d, ProviderPluginExport as e, MessageFormatSupport as f, PluginCapability as g, PluginCategory as h, PluginStatus as i, PluginAuthor as j, PluginCompatibility as k, ProviderConfig as l, PluginPermissions as m, PluginManifest as n, InstalledPluginInfo as o, ColorPalette as p, Typography as q, Effects as r, ThemeTokens as s, EmbeddedFont as t, ThemeMetadata as u, ThemePlugin as v, ThemePluginExport as w, RoleplayTemplateMetadata as x, RoleplayTemplatePlugin as y, RoleplayTemplatePluginExport as z };

package/dist/{index-yK-qJDls.d.ts → index-GOH-2K-k.d.ts}

@@ -337,11 +337,11 @@ interface ProviderPluginExport {
 /**
  * Plugin capability types
  */
-type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'UTILITY';
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'STORAGE_BACKEND' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'UTILITY';
 /**
  * Plugin category
  */
-type PluginCategory = 'PROVIDER' | 'AUTH' | 'STORAGE' | 'UI' | 'UTILITY';
+type PluginCategory = 'PROVIDER' | 'AUTH' | 'STORAGE' | 'UI' | 'TEMPLATE' | 'UTILITY';
 /**
  * Plugin status
  */
@@ -493,4 +493,470 @@ interface InstalledPluginInfo extends PluginManifest {
     installPath?: string;
 }
 
-export type { AttachmentSupport as A, CheapModelConfig as C, EmbeddingModelInfo as E, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, ToolFormatType as T, ProviderConfigRequirements as a, ProviderCapabilities as b, ImageProviderConstraints as c, IconProps as d, ProviderPluginExport as e, MessageFormatSupport as f, PluginCapability as g, PluginCategory as h, PluginStatus as i, PluginAuthor as j, PluginCompatibility as k, ProviderConfig as l, PluginPermissions as m, PluginManifest as n, InstalledPluginInfo as o };
+/**
+ * Theme Plugin Interface types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/plugins/theme
+ */
+/**
+ * Color palette for a single color mode (light or dark)
+ *
+ * Colors can be specified as:
+ * - HSL values: "222.2 84% 4.9%" (without hsl() wrapper)
+ * - Full HSL: "hsl(222.2 84% 4.9%)"
+ * - Hex: "#1a1a2e"
+ * - Other valid CSS color values: rgb(), oklch(), etc.
+ */
+interface ColorPalette {
+    /** Main background color */
+    background: string;
+    /** Main text color */
+    foreground: string;
+    /** Primary brand/action color */
+    primary: string;
+    /** Text on primary color */
+    primaryForeground: string;
+    /** Secondary background color */
+    secondary: string;
+    /** Text on secondary color */
+    secondaryForeground: string;
+    /** Muted background for less prominent elements */
+    muted: string;
+    /** Muted text color */
+    mutedForeground: string;
+    /** Accent color for highlights */
+    accent: string;
+    /** Text on accent color */
+    accentForeground: string;
+    /** Error/destructive action color */
+    destructive: string;
+    /** Text on destructive color */
+    destructiveForeground: string;
+    /** Card background color */
+    card: string;
+    /** Card text color */
+    cardForeground: string;
+    /** Popover/dropdown background */
+    popover: string;
+    /** Popover text color */
+    popoverForeground: string;
+    /** Default border color */
+    border: string;
+    /** Input field border color */
+    input: string;
+    /** Focus ring color */
+    ring: string;
+    /** Success state color */
+    success?: string;
+    /** Text on success color */
+    successForeground?: string;
+    /** Warning state color */
+    warning?: string;
+    /** Text on warning color */
+    warningForeground?: string;
+    /** Info state color */
+    info?: string;
+    /** Text on info color */
+    infoForeground?: string;
+    /** User message bubble background */
+    chatUser?: string;
+    /** User message bubble text */
+    chatUserForeground?: string;
+}
+/**
+ * Typography token configuration
+ */
+interface Typography {
+    /** Sans-serif font stack (default: "Inter, system-ui, sans-serif") */
+    fontSans?: string;
+    /** Serif font stack (default: "Georgia, serif") */
+    fontSerif?: string;
+    /** Monospace font stack (default: "ui-monospace, SFMono-Regular, monospace") */
+    fontMono?: string;
+    /** Extra small text - 12px (default: "0.75rem") */
+    fontSizeXs?: string;
+    /** Small text - 14px (default: "0.875rem") */
+    fontSizeSm?: string;
+    /** Base text size - 16px (default: "1rem") */
+    fontSizeBase?: string;
+    /** Large text - 18px (default: "1.125rem") */
+    fontSizeLg?: string;
+    /** Extra large text - 20px (default: "1.25rem") */
+    fontSizeXl?: string;
+    /** 2XL text - 24px (default: "1.5rem") */
+    fontSize2xl?: string;
+    /** 3XL text - 30px (default: "1.875rem") */
+    fontSize3xl?: string;
+    /** 4XL text - 36px (default: "2.25rem") */
+    fontSize4xl?: string;
+    /** Tight line height (default: "1.25") */
+    lineHeightTight?: string;
+    /** Normal line height (default: "1.5") */
+    lineHeightNormal?: string;
+    /** Relaxed line height (default: "1.75") */
+    lineHeightRelaxed?: string;
+    /** Normal font weight (default: "400") */
+    fontWeightNormal?: string;
+    /** Medium font weight (default: "500") */
+    fontWeightMedium?: string;
+    /** Semibold font weight (default: "600") */
+    fontWeightSemibold?: string;
+    /** Bold font weight (default: "700") */
+    fontWeightBold?: string;
+    /** Tight letter spacing (default: "-0.025em") */
+    letterSpacingTight?: string;
+    /** Normal letter spacing (default: "0") */
+    letterSpacingNormal?: string;
+    /** Wide letter spacing (default: "0.025em") */
+    letterSpacingWide?: string;
+}
+/**
+ * Spacing and layout token configuration
+ */
+interface Spacing {
+    /** Small border radius (default: "calc(0.5rem - 4px)") */
+    radiusSm?: string;
+    /** Medium border radius (default: "calc(0.5rem - 2px)") */
+    radiusMd?: string;
+    /** Large border radius (default: "0.5rem") */
+    radiusLg?: string;
+    /** Extra large border radius (default: "0.75rem") */
+    radiusXl?: string;
+    /** Full/pill border radius (default: "9999px") */
+    radiusFull?: string;
+    /** 4px spacing (default: "0.25rem") */
+    spacing1?: string;
+    /** 8px spacing (default: "0.5rem") */
+    spacing2?: string;
+    /** 12px spacing (default: "0.75rem") */
+    spacing3?: string;
+    /** 16px spacing (default: "1rem") */
+    spacing4?: string;
+    /** 20px spacing (default: "1.25rem") */
+    spacing5?: string;
+    /** 24px spacing (default: "1.5rem") */
+    spacing6?: string;
+    /** 32px spacing (default: "2rem") */
+    spacing8?: string;
+    /** 40px spacing (default: "2.5rem") */
+    spacing10?: string;
+    /** 48px spacing (default: "3rem") */
+    spacing12?: string;
+    /** 64px spacing (default: "4rem") */
+    spacing16?: string;
+}
+/**
+ * Visual effects token configuration
+ */
+interface Effects {
+    /** Small shadow (default: "0 1px 2px 0 rgb(0 0 0 / 0.05)") */
+    shadowSm?: string;
+    /** Medium shadow (default: "0 4px 6px -1px rgb(0 0 0 / 0.1)") */
+    shadowMd?: string;
+    /** Large shadow (default: "0 10px 15px -3px rgb(0 0 0 / 0.1)") */
+    shadowLg?: string;
+    /** Extra large shadow (default: "0 20px 25px -5px rgb(0 0 0 / 0.1)") */
+    shadowXl?: string;
+    /** Fast transition duration (default: "150ms") */
+    transitionFast?: string;
+    /** Normal transition duration (default: "200ms") */
+    transitionNormal?: string;
+    /** Slow transition duration (default: "300ms") */
+    transitionSlow?: string;
+    /** Default easing function (default: "cubic-bezier(0.4, 0, 0.2, 1)") */
+    transitionEasing?: string;
+    /** Focus ring width (default: "2px") */
+    focusRingWidth?: string;
+    /** Focus ring offset (default: "2px") */
+    focusRingOffset?: string;
+}
+/**
+ * Complete theme tokens structure
+ *
+ * Contains all customizable values for a theme:
+ * - colors: Required light and dark mode color palettes
+ * - typography: Optional font customization
+ * - spacing: Optional spacing/radius customization
+ * - effects: Optional shadows/transitions customization
+ */
+interface ThemeTokens {
+    /** Light and dark mode color palettes (required) */
+    colors: {
+        /** Light mode color palette */
+        light: ColorPalette;
+        /** Dark mode color palette */
+        dark: ColorPalette;
+    };
+    /** Typography customization (optional) */
+    typography?: Typography;
+    /** Spacing and radius customization (optional) */
+    spacing?: Spacing;
+    /** Shadow and transition customization (optional) */
+    effects?: Effects;
+}
+/**
+ * Custom font definition for themes that include custom fonts
+ */
+interface FontDefinition {
+    /** Font family name */
+    family: string;
+    /** Font source URL or relative path */
+    src: string;
+    /** Font weight (e.g., "400", "700", "400 700") */
+    weight?: string;
+    /** Font style (e.g., "normal", "italic") */
+    style?: string;
+    /** Font display strategy */
+    display?: 'auto' | 'block' | 'swap' | 'fallback' | 'optional';
+}
+/**
+ * Loaded font with binary data (for self-contained themes)
+ */
+interface EmbeddedFont {
+    /** Font family name */
+    family: string;
+    /** Font weight */
+    weight: string;
+    /** Font style */
+    style?: string;
+    /** Base64-encoded font data or data URL */
+    data: string;
+    /** MIME type of the font */
+    mimeType?: string;
+}
+/**
+ * Theme plugin metadata for UI display and identification
+ */
+interface ThemeMetadata {
+    /** Unique theme identifier (lowercase, hyphens allowed) */
+    themeId: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Theme description */
+    description?: string;
+    /** Theme author */
+    author?: string | {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /** Whether this theme provides dark mode support */
+    supportsDarkMode: boolean;
+    /** Theme tags for categorization */
+    tags?: string[];
+    /** Base64-encoded preview image or path */
+    previewImage?: string;
+}
+/**
+ * Main Theme Plugin Interface
+ *
+ * Plugins implementing this interface can be dynamically loaded
+ * by Quilltap to provide custom theming.
+ *
+ * Self-contained themes export all data directly in the plugin object,
+ * with no file system dependencies after module load.
+ *
+ * @example
+ * ```typescript
+ * import type { ThemePlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: ThemePlugin = {
+ *   metadata: {
+ *     themeId: 'my-theme',
+ *     displayName: 'My Custom Theme',
+ *     description: 'A beautiful custom theme',
+ *     supportsDarkMode: true,
+ *     tags: ['dark', 'minimal'],
+ *   },
+ *   tokens: {
+ *     colors: {
+ *       light: {
+ *         background: 'hsl(0 0% 100%)',
+ *         foreground: 'hsl(222.2 84% 4.9%)',
+ *         // ... all required colors
+ *       },
+ *       dark: {
+ *         background: 'hsl(222.2 84% 4.9%)',
+ *         foreground: 'hsl(210 40% 98%)',
+ *         // ... all required colors
+ *       },
+ *     },
+ *     typography: {
+ *       fontSans: '"Custom Font", system-ui, sans-serif',
+ *     },
+ *   },
+ *   cssOverrides: `
+ *     .qt-button-primary {
+ *       border-radius: 9999px;
+ *     }
+ *   `,
+ *   fonts: [
+ *     { family: 'Custom Font', weight: '400', data: 'base64...' },
+ *   ],
+ * };
+ * ```
+ */
+interface ThemePlugin {
+    /** Theme metadata for UI display and identification */
+    metadata: ThemeMetadata;
+    /** Theme design tokens (colors, typography, spacing, effects) */
+    tokens: ThemeTokens;
+    /**
+     * Optional CSS overrides for component-level customization (Tier 3)
+     * This CSS is injected when the theme is active
+     */
+    cssOverrides?: string;
+    /**
+     * Optional embedded fonts
+     * Base64-encoded font data for fully self-contained themes
+     */
+    fonts?: EmbeddedFont[];
+    /**
+     * Optional method for dynamic token generation
+     * Called when color mode changes, allows computed theme values
+     * @param mode Current color mode ('light' | 'dark')
+     */
+    getTokensForMode?: (mode: 'light' | 'dark') => ThemeTokens;
+    /**
+     * Optional initialization function
+     * Called when the theme is loaded
+     */
+    initialize?: () => void | Promise<void>;
+}
+/**
+ * Standard export type for theme plugins
+ */
+interface ThemePluginExport {
+    /** The theme plugin instance */
+    plugin: ThemePlugin;
+}
+
+/**
+ * Roleplay Template Plugin Interface types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/plugins/roleplay-template
+ */
+/**
+ * Configuration for a single roleplay template
+ *
+ * A roleplay template defines a formatting protocol for AI responses,
+ * such as how dialogue, actions, thoughts, and OOC comments should be formatted.
+ */
+interface RoleplayTemplateConfig {
+    /** Display name for the template */
+    name: string;
+    /** Optional description explaining the template's formatting style */
+    description?: string;
+    /**
+     * The system prompt that defines the formatting rules.
+     * This is prepended to character system prompts when the template is active.
+     */
+    systemPrompt: string;
+    /** Tags for categorization and searchability */
+    tags?: string[];
+}
+/**
+ * Metadata for a roleplay template plugin
+ */
+interface RoleplayTemplateMetadata {
+    /**
+     * Unique template identifier (lowercase, hyphens allowed)
+     * This is typically derived from the plugin name
+     */
+    templateId: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Template description */
+    description?: string;
+    /** Template author */
+    author?: string | {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /** Template tags for categorization */
+    tags?: string[];
+    /** Template version */
+    version?: string;
+}
+/**
+ * Main Roleplay Template Plugin Interface
+ *
+ * Plugins implementing this interface can be dynamically loaded
+ * by Quilltap to provide custom roleplay formatting templates.
+ *
+ * A plugin can provide one or more templates. Each template defines
+ * a unique formatting protocol for AI responses.
+ *
+ * @example
+ * ```typescript
+ * import type { RoleplayTemplatePlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: RoleplayTemplatePlugin = {
+ *   metadata: {
+ *     templateId: 'my-rp-format',
+ *     displayName: 'My RP Format',
+ *     description: 'A custom roleplay formatting style',
+ *     tags: ['custom', 'roleplay'],
+ *   },
+ *   templates: [
+ *     {
+ *       name: 'My RP Format',
+ *       description: 'Custom formatting with specific syntax',
+ *       systemPrompt: `[FORMATTING INSTRUCTIONS]
+ * 1. Dialogue: Use quotation marks
+ * 2. Actions: Use asterisks *like this*
+ * ...`,
+ *       tags: ['custom'],
+ *     },
+ *   ],
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Plugin with multiple templates
+ * import type { RoleplayTemplatePlugin } from '@quilltap/plugin-types';
+ *
+ * export const plugin: RoleplayTemplatePlugin = {
+ *   metadata: {
+ *     templateId: 'format-pack',
+ *     displayName: 'RP Format Pack',
+ *     description: 'A collection of roleplay formats',
+ *   },
+ *   templates: [
+ *     {
+ *       name: 'Screenplay',
+ *       systemPrompt: '...',
+ *     },
+ *     {
+ *       name: 'Novel',
+ *       systemPrompt: '...',
+ *     },
+ *   ],
+ * };
+ * ```
+ */
+interface RoleplayTemplatePlugin {
+    /** Plugin metadata for UI display and identification */
+    metadata: RoleplayTemplateMetadata;
+    /**
+     * One or more roleplay templates provided by this plugin.
+     * Each template has its own name, description, and system prompt.
+     */
+    templates: RoleplayTemplateConfig[];
+    /**
+     * Optional initialization function
+     * Called when the plugin is loaded
+     */
+    initialize?: () => void | Promise<void>;
+}
+/**
+ * Standard export type for roleplay template plugins
+ */
+interface RoleplayTemplatePluginExport {
+    /** The roleplay template plugin instance */
+    plugin: RoleplayTemplatePlugin;
+}
+
+export type { AttachmentSupport as A, CheapModelConfig as C, EmbeddingModelInfo as E, FontDefinition as F, ImageGenerationModelInfo as I, LLMProviderPlugin as L, ModelInfo as M, ProviderMetadata as P, RoleplayTemplateConfig as R, Spacing as S, ToolFormatType as T, ProviderConfigRequirements as a, ProviderCapabilities as b, ImageProviderConstraints as c, IconProps as d, ProviderPluginExport as e, MessageFormatSupport as f, PluginCapability as g, PluginCategory as h, PluginStatus as i, PluginAuthor as j, PluginCompatibility as k, ProviderConfig as l, PluginPermissions as m, PluginManifest as n, InstalledPluginInfo as o, ColorPalette as p, Typography as q, Effects as r, ThemeTokens as s, EmbeddedFont as t, ThemeMetadata as u, ThemePlugin as v, ThemePluginExport as w, RoleplayTemplateMetadata as x, RoleplayTemplatePlugin as y, RoleplayTemplatePluginExport as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 export { AnthropicToolDefinition, AttachmentResults, CacheUsage, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool } from './llm/index.mjs';
-export { A as AttachmentSupport, C as CheapModelConfig, E as EmbeddingModelInfo, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, f as MessageFormatSupport, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, T as ToolFormatType } from './index-BJ_sGB3K.mjs';
+export { A as AttachmentSupport, C as CheapModelConfig, p as ColorPalette, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, f as MessageFormatSupport, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, T as ToolFormatType, q as Typography } from './index-DkdHzVYa.mjs';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.mjs';
 import 'react';
 
@@ -20,6 +20,6 @@ import 'react';
  * Version of the plugin-types package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_TYPES_VERSION = "1.0.3";
+declare const PLUGIN_TYPES_VERSION = "1.2.0";
 
 export { PLUGIN_TYPES_VERSION };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { AnthropicToolDefinition, AttachmentResults, CacheUsage, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool } from './llm/index.js';
-export { A as AttachmentSupport, C as CheapModelConfig, E as EmbeddingModelInfo, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, f as MessageFormatSupport, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, T as ToolFormatType } from './index-yK-qJDls.js';
+export { A as AttachmentSupport, C as CheapModelConfig, p as ColorPalette, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, f as MessageFormatSupport, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, T as ToolFormatType, q as Typography } from './index-GOH-2K-k.js';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.js';
 import 'react';
 
@@ -20,6 +20,6 @@ import 'react';
  * Version of the plugin-types package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_TYPES_VERSION = "1.0.3";
+declare const PLUGIN_TYPES_VERSION = "1.2.0";
 
 export { PLUGIN_TYPES_VERSION };

package/dist/index.js

@@ -107,7 +107,7 @@ function createNoopLogger() {
 }
 
 // src/index.ts
-var PLUGIN_TYPES_VERSION = "1.0.3";
+var PLUGIN_TYPES_VERSION = "1.2.0";
 
 exports.ApiKeyError = ApiKeyError;
 exports.AttachmentError = AttachmentError;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":";;;AAWO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA,EACrC,WAAA,CACE,OAAA,EACgB,IAAA,EACA,UAAA,EAChB;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;AAOO,IAAM,WAAA,GAAN,cAA0B,WAAA,CAAY;AAAA,EAC3C,WAAA,CAAY,SAAiB,UAAA,EAAqB;AAChD,IAAA,KAAA,CAAM,OAAA,EAAS,iBAAiB,UAAU,CAAA;AAC1C,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;AAOO,IAAM,gBAAA,GAAN,cAA+B,WAAA,CAAY;AAAA,EAChD,WAAA,CACE,OAAA,EACgB,UAAA,EACA,QAAA,EAChB,UAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAA,EAAS,sBAAsB,UAAU,CAAA;AAJ/B,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AACA,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,EACd;AACF;AAOO,IAAM,cAAA,GAAN,cAA6B,gBAAA,CAAiB;AAAA,EAGnD,WAAA,CACE,OAAA,EACgB,UAAA,EAChB,UAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAA,EAAS,GAAA,EAAK,MAAA,EAAW,UAAU,CAAA;AAHzB,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAJlB,IAAA,IAAA,CAAyB,IAAA,GAAO,kBAAA;AAQ9B,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EACd;AACF;AAOO,IAAM,kBAAA,GAAN,cAAiC,WAAA,CAAY;AAAA,EAClD,WAAA,CAAY,SAAiB,UAAA,EAAqB;AAChD,IAAA,KAAA,CAAM,OAAA,EAAS,uBAAuB,UAAU,CAAA;AAChD,IAAA,IAAA,CAAK,IAAA,GAAO,oBAAA;AAAA,EACd;AACF;AAOO,IAAM,kBAAA,GAAN,cAAiC,WAAA,CAAY;AAAA,EAClD,WAAA,CACE,OAAA,EACgB,OAAA,EAChB,UAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAA,EAAS,mBAAmB,UAAU,CAAA;AAH5B,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,oBAAA;AAAA,EACd;AACF;AAOO,IAAM,eAAA,GAAN,cAA8B,WAAA,CAAY;AAAA,EAC/C,WAAA,CACE,OAAA,EACgB,YAAA,EAChB,UAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAA,EAAS,oBAAoB,UAAU,CAAA;AAH7B,IAAA,IAAA,CAAA,YAAA,GAAA,YAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAOO,IAAM,kBAAA,GAAN,cAAiC,WAAA,CAAY;AAAA,EAClD,WAAA,CACE,OAAA,EACgB,QAAA,EAChB,UAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAA,EAAS,wBAAwB,UAAU,CAAA;AAHjC,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,oBAAA;AAAA,EACd;AACF;;;AClDO,SAAS,mBAAA,CAAoB,MAAA,EAAgB,QAAA,GAAqB,MAAA,EAAsB;AAC7F,EAAA,MAAM,MAAA,GAAqB,CAAC,OAAA,EAAS,MAAA,EAAQ,QAAQ,OAAO,CAAA;AAC5D,EAAA,MAAM,SAAA,GAAY,CAAC,KAAA,KACjB,MAAA,CAAO,QAAQ,KAAK,CAAA,IAAK,MAAA,CAAO,OAAA,CAAQ,QAAQ,CAAA;AAElD,EAAA,MAAM,aAAA,GAAgB,CAAC,OAAA,KAAiC;AACtD,IAAA,IAAI,CAAC,SAAS,OAAO,EAAA;AACrB,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,CACnC,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,KAAQ,SAAS,CAAA,CACnC,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA,CAAE,CAAA,CACvD,KAAK,GAAG,CAAA;AACX,IAAA,OAAO,OAAA,GAAU,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,GAAK,EAAA;AAAA,EACnC,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,CAAC,OAAA,EAAiB,OAAA,KAA+B;AACtD,MAAA,IAAI,SAAA,CAAU,OAAO,CAAA,EAAG;AACtB,QAAA,OAAA,CAAQ,KAAA,CAAM,IAAI,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,EAAG,aAAA,CAAc,OAAO,CAAC,CAAA,CAAE,CAAA;AAAA,MACjE;AAAA,IACF,CAAA;AAAA,IAEA,IAAA,EAAM,CAAC,OAAA,EAAiB,OAAA,KAA+B;AACrD,MAAA,IAAI,SAAA,CAAU,MAAM,CAAA,EAAG;AACrB,QAAA,OAAA,CAAQ,IAAA,CAAK,IAAI,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,EAAG,aAAA,CAAc,OAAO,CAAC,CAAA,CAAE,CAAA;AAAA,MAChE;AAAA,IACF,CAAA;AAAA,IAEA,IAAA,EAAM,CAAC,OAAA,EAAiB,OAAA,KAA+B;AACrD,MAAA,IAAI,SAAA,CAAU,MAAM,CAAA,EAAG;AACrB,QAAA,OAAA,CAAQ,IAAA,CAAK,IAAI,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,EAAG,aAAA,CAAc,OAAO,CAAC,CAAA,CAAE,CAAA;AAAA,MAChE;AAAA,IACF,CAAA;AAAA,IAEA,KAAA,EAAO,CAAC,OAAA,EAAiB,OAAA,EAAsB,KAAA,KAAwB;AACrE,MAAA,IAAI,SAAA,CAAU,OAAO,CAAA,EAAG;AACtB,QAAA,OAAA,CAAQ,KAAA;AAAA,UACN,IAAI,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,EAAG,aAAA,CAAc,OAAO,CAAC,CAAA,CAAA;AAAA,UAC/C,KAAA,GAAQ;AAAA,EAAK,KAAA,CAAM,KAAA,IAAS,KAAA,CAAM,OAAO,CAAA,CAAA,GAAK;AAAA,SAChD;AAAA,MACF;AAAA,IACF;AAAA,GACF;AACF;AAOO,SAAS,gBAAA,GAAiC;AAC/C,EAAA,MAAM,OAAO,MAAY;AAAA,EAAC,CAAA;AAC1B,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,IAAA;AAAA,IACP,IAAA,EAAM,IAAA;AAAA,IACN,IAAA,EAAM,IAAA;AAAA,IACN,KAAA,EAAO;AAAA,GACT;AACF;;;ACRO,IAAM,oBAAA,GAAuB","file":"index.js","sourcesContent":["/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageProviderConstraints,\n  IconProps,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.0.3';\n"]}
+{"version":3,"sources":["../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageProviderConstraints,\n  IconProps,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\nexport type {\n  // Theme plugin types\n  ColorPalette,\n  Typography,\n  Spacing,\n  Effects,\n  ThemeTokens,\n  FontDefinition,\n  EmbeddedFont,\n  ThemeMetadata,\n  ThemePlugin,\n  ThemePluginExport,\n} from './plugins/theme';\n\nexport type {\n  // Roleplay template plugin types\n  RoleplayTemplateConfig,\n  RoleplayTemplateMetadata,\n  RoleplayTemplatePlugin,\n  RoleplayTemplatePluginExport,\n} from './plugins/roleplay-template';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.2.0';\n"]}

package/dist/index.mjs

@@ -105,7 +105,7 @@ function createNoopLogger() {
 }
 
 // src/index.ts
-var PLUGIN_TYPES_VERSION = "1.0.3";
+var PLUGIN_TYPES_VERSION = "1.2.0";
 
 export { ApiKeyError, AttachmentError, ConfigurationError, ModelNotFoundError, PLUGIN_TYPES_VERSION, PluginError, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageProviderConstraints,\n  IconProps,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.0.3';\n"]}
+{"version":3,"sources":["../src/common/errors.ts","../src/common/logger.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n","/**\n * @quilltap/plugin-types\n *\n * Type definitions for Quilltap plugin development.\n *\n * This package provides TypeScript types and interfaces for building\n * Quilltap plugins, including LLM providers, authentication providers,\n * and utility plugins.\n *\n * @packageDocumentation\n * @module @quilltap/plugin-types\n */\n\n// ============================================================================\n// LLM Types\n// ============================================================================\n\nexport type {\n  // Core message types\n  FileAttachment,\n  LLMMessage,\n  JSONSchemaDefinition,\n  ResponseFormat,\n  LLMParams,\n\n  // Response types\n  TokenUsage,\n  CacheUsage,\n  AttachmentResults,\n  LLMResponse,\n  StreamChunk,\n\n  // Image generation types\n  ImageGenParams,\n  GeneratedImage,\n  ImageGenResponse,\n\n  // Model metadata\n  ModelWarningLevel,\n  ModelWarning,\n  ModelMetadata,\n\n  // Provider interfaces\n  LLMProvider,\n  ImageGenProvider,\n} from './llm/base';\n\nexport type {\n  // Tool definitions\n  OpenAIToolDefinition,\n  UniversalTool,\n  AnthropicToolDefinition,\n  GoogleToolDefinition,\n\n  // Tool calls\n  ToolCall,\n  ToolCallRequest,\n  ToolResult,\n  ToolFormatOptions,\n} from './llm/tools';\n\n// ============================================================================\n// Plugin Types\n// ============================================================================\n\nexport type {\n  // Provider plugin types\n  ProviderMetadata,\n  ProviderConfigRequirements,\n  ProviderCapabilities,\n  AttachmentSupport,\n  ModelInfo,\n  EmbeddingModelInfo,\n  ImageGenerationModelInfo,\n  ImageProviderConstraints,\n  IconProps,\n  LLMProviderPlugin,\n  ProviderPluginExport,\n  // Runtime configuration types\n  MessageFormatSupport,\n  CheapModelConfig,\n  ToolFormatType,\n} from './plugins/provider';\n\nexport type {\n  // Manifest types\n  PluginCapability,\n  PluginCategory,\n  PluginStatus,\n  PluginAuthor,\n  PluginCompatibility,\n  ProviderConfig,\n  PluginPermissions,\n  PluginManifest,\n  InstalledPluginInfo,\n} from './plugins/manifest';\n\nexport type {\n  // Theme plugin types\n  ColorPalette,\n  Typography,\n  Spacing,\n  Effects,\n  ThemeTokens,\n  FontDefinition,\n  EmbeddedFont,\n  ThemeMetadata,\n  ThemePlugin,\n  ThemePluginExport,\n} from './plugins/theme';\n\nexport type {\n  // Roleplay template plugin types\n  RoleplayTemplateConfig,\n  RoleplayTemplateMetadata,\n  RoleplayTemplatePlugin,\n  RoleplayTemplatePluginExport,\n} from './plugins/roleplay-template';\n\n// ============================================================================\n// Common Types\n// ============================================================================\n\nexport type { LogLevel, LogContext, PluginLogger } from './common/logger';\n\n// Error classes (these are values, not just types)\nexport {\n  PluginError,\n  ApiKeyError,\n  ProviderApiError,\n  RateLimitError,\n  ConfigurationError,\n  ModelNotFoundError,\n  AttachmentError,\n  ToolExecutionError,\n} from './common/errors';\n\n// Logger factories\nexport { createConsoleLogger, createNoopLogger } from './common/logger';\n\n// ============================================================================\n// Version\n// ============================================================================\n\n/**\n * Version of the plugin-types package.\n * Can be used at runtime to check compatibility.\n */\nexport const PLUGIN_TYPES_VERSION = '1.2.0';\n"]}

package/dist/plugins/index.d.mts

@@ -1,3 +1,3 @@
-export { A as AttachmentSupport, E as EmbeddingModelInfo, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport } from '../index-BJ_sGB3K.mjs';
+export { A as AttachmentSupport, p as ColorPalette, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, q as Typography } from '../index-DkdHzVYa.mjs';
 import 'react';
 import '../llm/index.mjs';

package/dist/plugins/index.d.ts

@@ -1,3 +1,3 @@
-export { A as AttachmentSupport, E as EmbeddingModelInfo, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport } from '../index-yK-qJDls.js';
+export { A as AttachmentSupport, p as ColorPalette, r as Effects, t as EmbeddedFont, E as EmbeddingModelInfo, F as FontDefinition, d as IconProps, I as ImageGenerationModelInfo, c as ImageProviderConstraints, o as InstalledPluginInfo, L as LLMProviderPlugin, M as ModelInfo, j as PluginAuthor, g as PluginCapability, h as PluginCategory, k as PluginCompatibility, n as PluginManifest, m as PluginPermissions, i as PluginStatus, b as ProviderCapabilities, l as ProviderConfig, a as ProviderConfigRequirements, P as ProviderMetadata, e as ProviderPluginExport, R as RoleplayTemplateConfig, x as RoleplayTemplateMetadata, y as RoleplayTemplatePlugin, z as RoleplayTemplatePluginExport, S as Spacing, u as ThemeMetadata, v as ThemePlugin, w as ThemePluginExport, s as ThemeTokens, q as Typography } from '../index-GOH-2K-k.js';
 import 'react';
 import '../llm/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quilltap/plugin-types",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "Type definitions for Quilltap plugin development",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",