@quilltap/plugin-types 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ 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).
 
+## [2.2.0] - 2026-04-09
+
+### Removed
+
+- **Breaking:** Removed `ROLEPLAY_TEMPLATE` from `PluginCapability` type — roleplay templates are now native first-class entities in Quilltap v4.2.0
+- Removed roleplay template type re-exports from `@quilltap/plugin-types/plugins` barrel
+- Types in `./plugins/roleplay-template` are preserved but deprecated — import directly if backward compat is needed
+
 ## [1.15.1] - 2026-02-23
 
 ### Removed

package/README.md

@@ -143,9 +143,6 @@ logger.error('Failed to connect', { endpoint: 'api.example.com' }, error);
 | `SystemPromptPlugin` | System prompt plugin interface |
 | `SystemPromptData` | Individual prompt entry |
 | `SystemPromptMetadata` | System prompt plugin metadata |
-| `RoleplayTemplatePlugin` | Roleplay template plugin interface |
-| `RoleplayTemplateConfig` | Roleplay template configuration |
-
 ### Common Types
 
 | Type | Description |

package/dist/{index-BcrOjfYG.d.mts → index-BiFtkKWr.d.mts}

@@ -598,7 +598,7 @@ interface ScoringProviderPluginExport {
 /**
  * Plugin capability types
  */
-type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'TOOL_PROVIDER' | 'SEARCH_PROVIDER' | 'MODERATION_PROVIDER' | 'SYSTEM_PROMPT' | 'UTILITY';
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'THEME' | 'TOOL_PROVIDER' | 'SEARCH_PROVIDER' | 'MODERATION_PROVIDER' | 'SYSTEM_PROMPT' | 'UTILITY';
 /**
  * Plugin category
  */
@@ -1196,282 +1196,6 @@ interface ThemePluginExport {
     plugin: ThemePlugin;
 }
 
-/**
- * Roleplay Template Plugin Interface types for Quilltap plugin development
- *
- * @module @quilltap/plugin-types/plugins/roleplay-template
- */
-/**
- * Configuration for an annotation button in the formatting toolbar.
- *
- * Annotation buttons allow users to insert roleplay formatting
- * (e.g., narration brackets, OOC markers) with a single click.
- */
-interface AnnotationButton {
-    /** Full name displayed in tooltip (e.g., "Narration", "Internal Monologue") */
-    label: string;
-    /** Abbreviated label displayed on button (e.g., "Nar", "Int", "OOC") */
-    abbrev: string;
-    /** Opening delimiter (e.g., "[", "*", "{{") */
-    prefix: string;
-    /** Closing delimiter (e.g., "]", "*", "}}") - empty string for line-end delimiters */
-    suffix: string;
-}
-/**
- * A pattern for styling roleplay text in message content.
- *
- * Rendering patterns define how to match and style specific text patterns
- * in AI responses (e.g., narration, OOC comments, internal monologue).
- *
- * @example
- * ```typescript
- * // Match *narration* with single asterisks
- * { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' }
- *
- * // Match ((OOC comments)) with double parentheses
- * { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' }
- *
- * // Match // OOC at start of line (multiline mode)
- * { pattern: '^// .+$', className: 'qt-chat-ooc', flags: 'm' }
- * ```
- */
-interface RenderingPattern {
-    /** Regex pattern as a string (converted to RegExp at runtime) */
-    pattern: string;
-    /**
-     * CSS class to apply to matched text.
-     * Standard classes: qt-chat-dialogue, qt-chat-narration, qt-chat-ooc, qt-chat-inner-monologue
-     */
-    className: string;
-    /** Optional regex flags (e.g., 'm' for multiline). Default: none */
-    flags?: string;
-}
-/**
- * Configuration for detecting dialogue at the paragraph level.
- *
- * When dialogue contains markdown formatting (like **bold**), the text gets split
- * into multiple children and inline regex patterns can't match. Paragraph-level
- * detection checks if the entire paragraph starts and ends with quote characters.
- *
- * @example
- * ```typescript
- * // Standard dialogue with straight and curly quotes
- * {
- *   openingChars: ['"', '"'],
- *   closingChars: ['"', '"'],
- *   className: 'qt-chat-dialogue'
- * }
- * ```
- */
-interface DialogueDetection {
-    /** Opening quote characters to detect (e.g., ['"', '"']) */
-    openingChars: string[];
-    /** Closing quote characters to detect (e.g., ['"', '"']) */
-    closingChars: string[];
-    /** CSS class to apply to dialogue paragraphs */
-    className: string;
-}
-/**
- * Narration delimiters define how narration/action text is marked in roleplay output.
- * Required for all roleplay templates.
- *
- * - A single string means the same character is used for opening and closing (e.g., '*')
- * - A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']'])
- *
- * @example
- * ```typescript
- * // Single asterisk for both open and close
- * narrationDelimiters: '*'
- *
- * // Square brackets with different open/close
- * narrationDelimiters: ['[', ']']
- * ```
- */
-type NarrationDelimiters = string | [string, string];
-/**
- * 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[];
-    /**
-     * Annotation buttons for the formatting toolbar.
-     * Defines which formatting options are available when document editing mode is enabled.
-     *
-     * @example
-     * ```typescript
-     * annotationButtons: [
-     *   { label: 'Narration', abbrev: 'Nar', prefix: '[', suffix: ']' },
-     *   { label: 'Internal Monologue', abbrev: 'Int', prefix: '{', suffix: '}' },
-     *   { label: 'Out of Character', abbrev: 'OOC', prefix: '// ', suffix: '' },
-     * ]
-     * ```
-     */
-    annotationButtons?: AnnotationButton[];
-    /**
-     * Patterns for styling roleplay text in message content.
-     * These patterns are matched against text nodes and wrapped in styled spans.
-     *
-     * @example
-     * ```typescript
-     * renderingPatterns: [
-     *   // Match *narration* with single asterisks
-     *   { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' },
-     *   // Match ((OOC)) with double parentheses
-     *   { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' },
-     * ]
-     * ```
-     */
-    renderingPatterns?: RenderingPattern[];
-    /**
-     * Optional dialogue detection for paragraph-level styling.
-     * When dialogue contains markdown formatting, inline patterns can't match.
-     * This detects paragraphs that start/end with quote characters.
-     *
-     * @example
-     * ```typescript
-     * dialogueDetection: {
-     *   openingChars: ['"', '"'],
-     *   closingChars: ['"', '"'],
-     *   className: 'qt-chat-dialogue'
-     * }
-     * ```
-     */
-    dialogueDetection?: DialogueDetection;
-    /**
-     * Narration delimiters — required for all templates.
-     * Defines how narration/action text is delimited in the template's formatting.
-     *
-     * A single string means the same delimiter is used for opening and closing (e.g., '*').
-     * A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']']).
-     *
-     * @example
-     * ```typescript
-     * // Standard: *narration*
-     * narrationDelimiters: '*'
-     *
-     * // Quilltap RP: [narration]
-     * narrationDelimiters: ['[', ']']
-     * ```
-     */
-    narrationDelimiters: NarrationDelimiters;
-}
-/**
- * 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;
-}
-
 /**
  * Search Provider Plugin types for Quilltap plugin development
  *
@@ -1736,4 +1460,4 @@ interface ModerationProviderPluginExport {
     moderationPlugin: ModerationProviderPlugin;
 }
 
-export type { ThemeMetadata as $, AttachmentSupport as A, RoleplayTemplateMetadata as B, CheapModelConfig as C, RoleplayTemplatePlugin as D, Effects as E, FontDefinition as F, RoleplayTemplatePluginExport as G, ScoringProviderMetadata as H, IconProps as I, ScoringProviderPlugin as J, ScoringProviderPluginExport as K, LLMProviderPlugin as L, MessageFormatSupport as M, NarrationDelimiters as N, SearchOutput as O, PluginAuthor as P, SearchProviderConfig as Q, RoleplayTemplateConfig as R, ScoringProviderConfigRequirements as S, SearchProviderConfigRequirements as T, SearchProviderMetadata as U, SearchProviderPlugin as V, SearchProviderPluginExport as W, SearchResult as X, Spacing as Y, SubsystemOverrides as Z, TextProviderPlugin as _, ColorPalette as a, ThemePlugin as a0, ThemePluginExport as a1, ThemeTokens as a2, ToolFormatType as a3, Typography as a4, AnnotationButton as a5, DialogueDetection as a6, ModerationProviderConfig as a7, RenderingPattern as a8, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, ModerationCategoryResult as i, ModerationProviderConfigRequirements as j, ModerationProviderMetadata as k, ModerationProviderPlugin as l, ModerationProviderPluginExport as m, ModerationResult as n, PluginCapability as o, PluginCategory as p, PluginCompatibility as q, PluginIconData as r, PluginManifest as s, PluginPermissions as t, PluginStatus as u, ProviderCapabilities as v, ProviderConfig as w, ProviderConfigRequirements as x, ProviderMetadata as y, ProviderPluginExport as z };
+export type { Typography as $, AttachmentSupport as A, ScoringProviderMetadata as B, CheapModelConfig as C, ScoringProviderPlugin as D, Effects as E, FontDefinition as F, ScoringProviderPluginExport as G, SearchOutput as H, IconProps as I, SearchProviderConfig as J, SearchProviderConfigRequirements as K, LLMProviderPlugin as L, MessageFormatSupport as M, SearchProviderMetadata as N, SearchProviderPlugin as O, PluginAuthor as P, SearchProviderPluginExport as Q, SearchResult as R, ScoringProviderConfigRequirements as S, Spacing as T, SubsystemOverrides as U, TextProviderPlugin as V, ThemeMetadata as W, ThemePlugin as X, ThemePluginExport as Y, ThemeTokens as Z, ToolFormatType as _, ColorPalette as a, ModerationProviderConfig as a0, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, ModerationCategoryResult as i, ModerationProviderConfigRequirements as j, ModerationProviderMetadata as k, ModerationProviderPlugin as l, ModerationProviderPluginExport as m, ModerationResult as n, PluginCapability as o, PluginCategory as p, PluginCompatibility as q, PluginIconData as r, PluginManifest as s, PluginPermissions as t, PluginStatus as u, ProviderCapabilities as v, ProviderConfig as w, ProviderConfigRequirements as x, ProviderMetadata as y, ProviderPluginExport as z };

package/dist/{index-DS_4gWcN.d.ts → index-DNgmDKd5.d.ts}

@@ -598,7 +598,7 @@ interface ScoringProviderPluginExport {
 /**
  * Plugin capability types
  */
-type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'THEME' | 'ROLEPLAY_TEMPLATE' | 'TOOL_PROVIDER' | 'SEARCH_PROVIDER' | 'MODERATION_PROVIDER' | 'SYSTEM_PROMPT' | 'UTILITY';
+type PluginCapability = 'LLM_PROVIDER' | 'AUTH_PROVIDER' | 'THEME' | 'TOOL_PROVIDER' | 'SEARCH_PROVIDER' | 'MODERATION_PROVIDER' | 'SYSTEM_PROMPT' | 'UTILITY';
 /**
  * Plugin category
  */
@@ -1196,282 +1196,6 @@ interface ThemePluginExport {
     plugin: ThemePlugin;
 }
 
-/**
- * Roleplay Template Plugin Interface types for Quilltap plugin development
- *
- * @module @quilltap/plugin-types/plugins/roleplay-template
- */
-/**
- * Configuration for an annotation button in the formatting toolbar.
- *
- * Annotation buttons allow users to insert roleplay formatting
- * (e.g., narration brackets, OOC markers) with a single click.
- */
-interface AnnotationButton {
-    /** Full name displayed in tooltip (e.g., "Narration", "Internal Monologue") */
-    label: string;
-    /** Abbreviated label displayed on button (e.g., "Nar", "Int", "OOC") */
-    abbrev: string;
-    /** Opening delimiter (e.g., "[", "*", "{{") */
-    prefix: string;
-    /** Closing delimiter (e.g., "]", "*", "}}") - empty string for line-end delimiters */
-    suffix: string;
-}
-/**
- * A pattern for styling roleplay text in message content.
- *
- * Rendering patterns define how to match and style specific text patterns
- * in AI responses (e.g., narration, OOC comments, internal monologue).
- *
- * @example
- * ```typescript
- * // Match *narration* with single asterisks
- * { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' }
- *
- * // Match ((OOC comments)) with double parentheses
- * { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' }
- *
- * // Match // OOC at start of line (multiline mode)
- * { pattern: '^// .+$', className: 'qt-chat-ooc', flags: 'm' }
- * ```
- */
-interface RenderingPattern {
-    /** Regex pattern as a string (converted to RegExp at runtime) */
-    pattern: string;
-    /**
-     * CSS class to apply to matched text.
-     * Standard classes: qt-chat-dialogue, qt-chat-narration, qt-chat-ooc, qt-chat-inner-monologue
-     */
-    className: string;
-    /** Optional regex flags (e.g., 'm' for multiline). Default: none */
-    flags?: string;
-}
-/**
- * Configuration for detecting dialogue at the paragraph level.
- *
- * When dialogue contains markdown formatting (like **bold**), the text gets split
- * into multiple children and inline regex patterns can't match. Paragraph-level
- * detection checks if the entire paragraph starts and ends with quote characters.
- *
- * @example
- * ```typescript
- * // Standard dialogue with straight and curly quotes
- * {
- *   openingChars: ['"', '"'],
- *   closingChars: ['"', '"'],
- *   className: 'qt-chat-dialogue'
- * }
- * ```
- */
-interface DialogueDetection {
-    /** Opening quote characters to detect (e.g., ['"', '"']) */
-    openingChars: string[];
-    /** Closing quote characters to detect (e.g., ['"', '"']) */
-    closingChars: string[];
-    /** CSS class to apply to dialogue paragraphs */
-    className: string;
-}
-/**
- * Narration delimiters define how narration/action text is marked in roleplay output.
- * Required for all roleplay templates.
- *
- * - A single string means the same character is used for opening and closing (e.g., '*')
- * - A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']'])
- *
- * @example
- * ```typescript
- * // Single asterisk for both open and close
- * narrationDelimiters: '*'
- *
- * // Square brackets with different open/close
- * narrationDelimiters: ['[', ']']
- * ```
- */
-type NarrationDelimiters = string | [string, string];
-/**
- * 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[];
-    /**
-     * Annotation buttons for the formatting toolbar.
-     * Defines which formatting options are available when document editing mode is enabled.
-     *
-     * @example
-     * ```typescript
-     * annotationButtons: [
-     *   { label: 'Narration', abbrev: 'Nar', prefix: '[', suffix: ']' },
-     *   { label: 'Internal Monologue', abbrev: 'Int', prefix: '{', suffix: '}' },
-     *   { label: 'Out of Character', abbrev: 'OOC', prefix: '// ', suffix: '' },
-     * ]
-     * ```
-     */
-    annotationButtons?: AnnotationButton[];
-    /**
-     * Patterns for styling roleplay text in message content.
-     * These patterns are matched against text nodes and wrapped in styled spans.
-     *
-     * @example
-     * ```typescript
-     * renderingPatterns: [
-     *   // Match *narration* with single asterisks
-     *   { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' },
-     *   // Match ((OOC)) with double parentheses
-     *   { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' },
-     * ]
-     * ```
-     */
-    renderingPatterns?: RenderingPattern[];
-    /**
-     * Optional dialogue detection for paragraph-level styling.
-     * When dialogue contains markdown formatting, inline patterns can't match.
-     * This detects paragraphs that start/end with quote characters.
-     *
-     * @example
-     * ```typescript
-     * dialogueDetection: {
-     *   openingChars: ['"', '"'],
-     *   closingChars: ['"', '"'],
-     *   className: 'qt-chat-dialogue'
-     * }
-     * ```
-     */
-    dialogueDetection?: DialogueDetection;
-    /**
-     * Narration delimiters — required for all templates.
-     * Defines how narration/action text is delimited in the template's formatting.
-     *
-     * A single string means the same delimiter is used for opening and closing (e.g., '*').
-     * A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']']).
-     *
-     * @example
-     * ```typescript
-     * // Standard: *narration*
-     * narrationDelimiters: '*'
-     *
-     * // Quilltap RP: [narration]
-     * narrationDelimiters: ['[', ']']
-     * ```
-     */
-    narrationDelimiters: NarrationDelimiters;
-}
-/**
- * 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;
-}
-
 /**
  * Search Provider Plugin types for Quilltap plugin development
  *
@@ -1736,4 +1460,4 @@ interface ModerationProviderPluginExport {
     moderationPlugin: ModerationProviderPlugin;
 }
 
-export type { ThemeMetadata as $, AttachmentSupport as A, RoleplayTemplateMetadata as B, CheapModelConfig as C, RoleplayTemplatePlugin as D, Effects as E, FontDefinition as F, RoleplayTemplatePluginExport as G, ScoringProviderMetadata as H, IconProps as I, ScoringProviderPlugin as J, ScoringProviderPluginExport as K, LLMProviderPlugin as L, MessageFormatSupport as M, NarrationDelimiters as N, SearchOutput as O, PluginAuthor as P, SearchProviderConfig as Q, RoleplayTemplateConfig as R, ScoringProviderConfigRequirements as S, SearchProviderConfigRequirements as T, SearchProviderMetadata as U, SearchProviderPlugin as V, SearchProviderPluginExport as W, SearchResult as X, Spacing as Y, SubsystemOverrides as Z, TextProviderPlugin as _, ColorPalette as a, ThemePlugin as a0, ThemePluginExport as a1, ThemeTokens as a2, ToolFormatType as a3, Typography as a4, AnnotationButton as a5, DialogueDetection as a6, ModerationProviderConfig as a7, RenderingPattern as a8, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, ModerationCategoryResult as i, ModerationProviderConfigRequirements as j, ModerationProviderMetadata as k, ModerationProviderPlugin as l, ModerationProviderPluginExport as m, ModerationResult as n, PluginCapability as o, PluginCategory as p, PluginCompatibility as q, PluginIconData as r, PluginManifest as s, PluginPermissions as t, PluginStatus as u, ProviderCapabilities as v, ProviderConfig as w, ProviderConfigRequirements as x, ProviderMetadata as y, ProviderPluginExport as z };
+export type { Typography as $, AttachmentSupport as A, ScoringProviderMetadata as B, CheapModelConfig as C, ScoringProviderPlugin as D, Effects as E, FontDefinition as F, ScoringProviderPluginExport as G, SearchOutput as H, IconProps as I, SearchProviderConfig as J, SearchProviderConfigRequirements as K, LLMProviderPlugin as L, MessageFormatSupport as M, SearchProviderMetadata as N, SearchProviderPlugin as O, PluginAuthor as P, SearchProviderPluginExport as Q, SearchResult as R, ScoringProviderConfigRequirements as S, Spacing as T, SubsystemOverrides as U, TextProviderPlugin as V, ThemeMetadata as W, ThemePlugin as X, ThemePluginExport as Y, ThemeTokens as Z, ToolFormatType as _, ColorPalette as a, ModerationProviderConfig as a0, EmbeddedFont as b, EmbeddingModelInfo as c, ImageGenerationModelInfo as d, ImageProviderConstraints as e, ImageStyleInfo as f, InstalledPluginInfo as g, ModelInfo as h, ModerationCategoryResult as i, ModerationProviderConfigRequirements as j, ModerationProviderMetadata as k, ModerationProviderPlugin as l, ModerationProviderPluginExport as m, ModerationResult as n, PluginCapability as o, PluginCategory as p, PluginCompatibility as q, PluginIconData as r, PluginManifest as s, PluginPermissions as t, PluginStatus as u, ProviderCapabilities as v, ProviderConfig as w, ProviderConfigRequirements as x, ProviderMetadata as y, ProviderPluginExport as z };

package/dist/index.d.mts

@@ -1,9 +1,290 @@
 import { UniversalTool } from './llm/index.mjs';
 export { AnthropicToolDefinition, AttachmentResults, CacheUsage, EmbeddingOptions, EmbeddingProvider, EmbeddingResult, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, ImageGenProvider as ImageProvider, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, LocalEmbeddingProvider, LocalEmbeddingProviderState, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, LLMProvider as TextProvider, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, isLocalEmbeddingProvider } from './llm/index.mjs';
 export { CategoryScore, ScoringInput, ScoringProvider, ScoringResult, ScoringTask } from './providers/index.mjs';
-export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, i as ModerationCategoryResult, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, N as NarrationDelimiters, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, r as PluginIconData, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, R as RoleplayTemplateConfig, B as RoleplayTemplateMetadata, D as RoleplayTemplatePlugin, G as RoleplayTemplatePluginExport, S as ScoringProviderConfigRequirements, H as ScoringProviderMetadata, J as ScoringProviderPlugin, K as ScoringProviderPluginExport, O as SearchOutput, Q as SearchProviderConfig, T as SearchProviderConfigRequirements, U as SearchProviderMetadata, V as SearchProviderPlugin, W as SearchProviderPluginExport, X as SearchResult, Y as Spacing, Z as SubsystemOverrides, _ as TextProviderPlugin, $ as ThemeMetadata, a0 as ThemePlugin, a1 as ThemePluginExport, a2 as ThemeTokens, a3 as ToolFormatType, a4 as Typography } from './index-BcrOjfYG.mjs';
+export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, i as ModerationCategoryResult, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, r as PluginIconData, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, S as ScoringProviderConfigRequirements, B as ScoringProviderMetadata, D as ScoringProviderPlugin, G as ScoringProviderPluginExport, H as SearchOutput, J as SearchProviderConfig, K as SearchProviderConfigRequirements, N as SearchProviderMetadata, O as SearchProviderPlugin, Q as SearchProviderPluginExport, R as SearchResult, T as Spacing, U as SubsystemOverrides, V as TextProviderPlugin, W as ThemeMetadata, X as ThemePlugin, Y as ThemePluginExport, Z as ThemeTokens, _ as ToolFormatType, $ as Typography } from './index-BiFtkKWr.mjs';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.mjs';
 
+/**
+ * Roleplay Template Plugin Interface types for Quilltap plugin development
+ *
+ * @deprecated The ROLEPLAY_TEMPLATE plugin capability was removed in Quilltap v4.2.0.
+ * Roleplay templates are now native first-class entities managed through the Settings UI.
+ * These types are preserved for backward compatibility with existing third-party plugins
+ * but will be removed in a future major version.
+ *
+ * @module @quilltap/plugin-types/plugins/roleplay-template
+ */
+/**
+ * Configuration for an annotation button in the formatting toolbar.
+ *
+ * Annotation buttons allow users to insert roleplay formatting
+ * (e.g., narration brackets, OOC markers) with a single click.
+ */
+interface AnnotationButton {
+    /** Full name displayed in tooltip (e.g., "Narration", "Internal Monologue") */
+    label: string;
+    /** Abbreviated label displayed on button (e.g., "Nar", "Int", "OOC") */
+    abbrev: string;
+    /** Opening delimiter (e.g., "[", "*", "{{") */
+    prefix: string;
+    /** Closing delimiter (e.g., "]", "*", "}}") - empty string for line-end delimiters */
+    suffix: string;
+}
+/**
+ * A pattern for styling roleplay text in message content.
+ *
+ * Rendering patterns define how to match and style specific text patterns
+ * in AI responses (e.g., narration, OOC comments, internal monologue).
+ *
+ * @example
+ * ```typescript
+ * // Match *narration* with single asterisks
+ * { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' }
+ *
+ * // Match ((OOC comments)) with double parentheses
+ * { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' }
+ *
+ * // Match // OOC at start of line (multiline mode)
+ * { pattern: '^// .+$', className: 'qt-chat-ooc', flags: 'm' }
+ * ```
+ */
+interface RenderingPattern {
+    /** Regex pattern as a string (converted to RegExp at runtime) */
+    pattern: string;
+    /**
+     * CSS class to apply to matched text.
+     * Standard classes: qt-chat-dialogue, qt-chat-narration, qt-chat-ooc, qt-chat-inner-monologue
+     */
+    className: string;
+    /** Optional regex flags (e.g., 'm' for multiline). Default: none */
+    flags?: string;
+}
+/**
+ * Configuration for detecting dialogue at the paragraph level.
+ *
+ * When dialogue contains markdown formatting (like **bold**), the text gets split
+ * into multiple children and inline regex patterns can't match. Paragraph-level
+ * detection checks if the entire paragraph starts and ends with quote characters.
+ *
+ * @example
+ * ```typescript
+ * // Standard dialogue with straight and curly quotes
+ * {
+ *   openingChars: ['"', '"'],
+ *   closingChars: ['"', '"'],
+ *   className: 'qt-chat-dialogue'
+ * }
+ * ```
+ */
+interface DialogueDetection {
+    /** Opening quote characters to detect (e.g., ['"', '"']) */
+    openingChars: string[];
+    /** Closing quote characters to detect (e.g., ['"', '"']) */
+    closingChars: string[];
+    /** CSS class to apply to dialogue paragraphs */
+    className: string;
+}
+/**
+ * Narration delimiters define how narration/action text is marked in roleplay output.
+ * Required for all roleplay templates.
+ *
+ * - A single string means the same character is used for opening and closing (e.g., '*')
+ * - A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']'])
+ *
+ * @example
+ * ```typescript
+ * // Single asterisk for both open and close
+ * narrationDelimiters: '*'
+ *
+ * // Square brackets with different open/close
+ * narrationDelimiters: ['[', ']']
+ * ```
+ */
+type NarrationDelimiters = string | [string, string];
+/**
+ * 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[];
+    /**
+     * Annotation buttons for the formatting toolbar.
+     * Defines which formatting options are available when document editing mode is enabled.
+     *
+     * @example
+     * ```typescript
+     * annotationButtons: [
+     *   { label: 'Narration', abbrev: 'Nar', prefix: '[', suffix: ']' },
+     *   { label: 'Internal Monologue', abbrev: 'Int', prefix: '{', suffix: '}' },
+     *   { label: 'Out of Character', abbrev: 'OOC', prefix: '// ', suffix: '' },
+     * ]
+     * ```
+     */
+    annotationButtons?: AnnotationButton[];
+    /**
+     * Patterns for styling roleplay text in message content.
+     * These patterns are matched against text nodes and wrapped in styled spans.
+     *
+     * @example
+     * ```typescript
+     * renderingPatterns: [
+     *   // Match *narration* with single asterisks
+     *   { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' },
+     *   // Match ((OOC)) with double parentheses
+     *   { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' },
+     * ]
+     * ```
+     */
+    renderingPatterns?: RenderingPattern[];
+    /**
+     * Optional dialogue detection for paragraph-level styling.
+     * When dialogue contains markdown formatting, inline patterns can't match.
+     * This detects paragraphs that start/end with quote characters.
+     *
+     * @example
+     * ```typescript
+     * dialogueDetection: {
+     *   openingChars: ['"', '"'],
+     *   closingChars: ['"', '"'],
+     *   className: 'qt-chat-dialogue'
+     * }
+     * ```
+     */
+    dialogueDetection?: DialogueDetection;
+    /**
+     * Narration delimiters — required for all templates.
+     * Defines how narration/action text is delimited in the template's formatting.
+     *
+     * A single string means the same delimiter is used for opening and closing (e.g., '*').
+     * A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']']).
+     *
+     * @example
+     * ```typescript
+     * // Standard: *narration*
+     * narrationDelimiters: '*'
+     *
+     * // Quilltap RP: [narration]
+     * narrationDelimiters: ['[', ']']
+     * ```
+     */
+    narrationDelimiters: NarrationDelimiters;
+}
+/**
+ * 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;
+}
+
 /**
  * System Prompt Plugin Interface types for Quilltap plugin development
  *
@@ -373,4 +654,4 @@ interface ToolPluginExport {
  */
 declare const PLUGIN_TYPES_VERSION = "2.0.0";
 
-export { PLUGIN_TYPES_VERSION, type SystemPromptData, type SystemPromptMetadata, type SystemPromptPlugin, type SystemPromptPluginExport, type ToolExecutionContext, type ToolExecutionResult, type ToolHierarchyInfo, type ToolMetadata, type ToolPlugin, type ToolPluginExport, UniversalTool };
+export { type NarrationDelimiters, PLUGIN_TYPES_VERSION, type RoleplayTemplateConfig, type RoleplayTemplateMetadata, type RoleplayTemplatePlugin, type RoleplayTemplatePluginExport, type SystemPromptData, type SystemPromptMetadata, type SystemPromptPlugin, type SystemPromptPluginExport, type ToolExecutionContext, type ToolExecutionResult, type ToolHierarchyInfo, type ToolMetadata, type ToolPlugin, type ToolPluginExport, UniversalTool };

package/dist/index.d.ts

@@ -1,9 +1,290 @@
 import { UniversalTool } from './llm/index.js';
 export { AnthropicToolDefinition, AttachmentResults, CacheUsage, EmbeddingOptions, EmbeddingProvider, EmbeddingResult, FileAttachment, GeneratedImage, GoogleToolDefinition, ImageGenParams, ImageGenProvider, ImageGenResponse, ImageGenProvider as ImageProvider, JSONSchemaDefinition, LLMMessage, LLMParams, LLMProvider, LLMResponse, LocalEmbeddingProvider, LocalEmbeddingProviderState, ModelMetadata, ModelWarning, ModelWarningLevel, OpenAIToolDefinition, ResponseFormat, StreamChunk, LLMProvider as TextProvider, TokenUsage, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, isLocalEmbeddingProvider } from './llm/index.js';
 export { CategoryScore, ScoringInput, ScoringProvider, ScoringResult, ScoringTask } from './providers/index.js';
-export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, i as ModerationCategoryResult, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, N as NarrationDelimiters, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, r as PluginIconData, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, R as RoleplayTemplateConfig, B as RoleplayTemplateMetadata, D as RoleplayTemplatePlugin, G as RoleplayTemplatePluginExport, S as ScoringProviderConfigRequirements, H as ScoringProviderMetadata, J as ScoringProviderPlugin, K as ScoringProviderPluginExport, O as SearchOutput, Q as SearchProviderConfig, T as SearchProviderConfigRequirements, U as SearchProviderMetadata, V as SearchProviderPlugin, W as SearchProviderPluginExport, X as SearchResult, Y as Spacing, Z as SubsystemOverrides, _ as TextProviderPlugin, $ as ThemeMetadata, a0 as ThemePlugin, a1 as ThemePluginExport, a2 as ThemeTokens, a3 as ToolFormatType, a4 as Typography } from './index-DS_4gWcN.js';
+export { A as AttachmentSupport, C as CheapModelConfig, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, f as ImageStyleInfo, g as InstalledPluginInfo, L as LLMProviderPlugin, M as MessageFormatSupport, h as ModelInfo, i as ModerationCategoryResult, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, r as PluginIconData, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, S as ScoringProviderConfigRequirements, B as ScoringProviderMetadata, D as ScoringProviderPlugin, G as ScoringProviderPluginExport, H as SearchOutput, J as SearchProviderConfig, K as SearchProviderConfigRequirements, N as SearchProviderMetadata, O as SearchProviderPlugin, Q as SearchProviderPluginExport, R as SearchResult, T as Spacing, U as SubsystemOverrides, V as TextProviderPlugin, W as ThemeMetadata, X as ThemePlugin, Y as ThemePluginExport, Z as ThemeTokens, _ as ToolFormatType, $ as Typography } from './index-DNgmDKd5.js';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.js';
 
+/**
+ * Roleplay Template Plugin Interface types for Quilltap plugin development
+ *
+ * @deprecated The ROLEPLAY_TEMPLATE plugin capability was removed in Quilltap v4.2.0.
+ * Roleplay templates are now native first-class entities managed through the Settings UI.
+ * These types are preserved for backward compatibility with existing third-party plugins
+ * but will be removed in a future major version.
+ *
+ * @module @quilltap/plugin-types/plugins/roleplay-template
+ */
+/**
+ * Configuration for an annotation button in the formatting toolbar.
+ *
+ * Annotation buttons allow users to insert roleplay formatting
+ * (e.g., narration brackets, OOC markers) with a single click.
+ */
+interface AnnotationButton {
+    /** Full name displayed in tooltip (e.g., "Narration", "Internal Monologue") */
+    label: string;
+    /** Abbreviated label displayed on button (e.g., "Nar", "Int", "OOC") */
+    abbrev: string;
+    /** Opening delimiter (e.g., "[", "*", "{{") */
+    prefix: string;
+    /** Closing delimiter (e.g., "]", "*", "}}") - empty string for line-end delimiters */
+    suffix: string;
+}
+/**
+ * A pattern for styling roleplay text in message content.
+ *
+ * Rendering patterns define how to match and style specific text patterns
+ * in AI responses (e.g., narration, OOC comments, internal monologue).
+ *
+ * @example
+ * ```typescript
+ * // Match *narration* with single asterisks
+ * { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' }
+ *
+ * // Match ((OOC comments)) with double parentheses
+ * { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' }
+ *
+ * // Match // OOC at start of line (multiline mode)
+ * { pattern: '^// .+$', className: 'qt-chat-ooc', flags: 'm' }
+ * ```
+ */
+interface RenderingPattern {
+    /** Regex pattern as a string (converted to RegExp at runtime) */
+    pattern: string;
+    /**
+     * CSS class to apply to matched text.
+     * Standard classes: qt-chat-dialogue, qt-chat-narration, qt-chat-ooc, qt-chat-inner-monologue
+     */
+    className: string;
+    /** Optional regex flags (e.g., 'm' for multiline). Default: none */
+    flags?: string;
+}
+/**
+ * Configuration for detecting dialogue at the paragraph level.
+ *
+ * When dialogue contains markdown formatting (like **bold**), the text gets split
+ * into multiple children and inline regex patterns can't match. Paragraph-level
+ * detection checks if the entire paragraph starts and ends with quote characters.
+ *
+ * @example
+ * ```typescript
+ * // Standard dialogue with straight and curly quotes
+ * {
+ *   openingChars: ['"', '"'],
+ *   closingChars: ['"', '"'],
+ *   className: 'qt-chat-dialogue'
+ * }
+ * ```
+ */
+interface DialogueDetection {
+    /** Opening quote characters to detect (e.g., ['"', '"']) */
+    openingChars: string[];
+    /** Closing quote characters to detect (e.g., ['"', '"']) */
+    closingChars: string[];
+    /** CSS class to apply to dialogue paragraphs */
+    className: string;
+}
+/**
+ * Narration delimiters define how narration/action text is marked in roleplay output.
+ * Required for all roleplay templates.
+ *
+ * - A single string means the same character is used for opening and closing (e.g., '*')
+ * - A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']'])
+ *
+ * @example
+ * ```typescript
+ * // Single asterisk for both open and close
+ * narrationDelimiters: '*'
+ *
+ * // Square brackets with different open/close
+ * narrationDelimiters: ['[', ']']
+ * ```
+ */
+type NarrationDelimiters = string | [string, string];
+/**
+ * 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[];
+    /**
+     * Annotation buttons for the formatting toolbar.
+     * Defines which formatting options are available when document editing mode is enabled.
+     *
+     * @example
+     * ```typescript
+     * annotationButtons: [
+     *   { label: 'Narration', abbrev: 'Nar', prefix: '[', suffix: ']' },
+     *   { label: 'Internal Monologue', abbrev: 'Int', prefix: '{', suffix: '}' },
+     *   { label: 'Out of Character', abbrev: 'OOC', prefix: '// ', suffix: '' },
+     * ]
+     * ```
+     */
+    annotationButtons?: AnnotationButton[];
+    /**
+     * Patterns for styling roleplay text in message content.
+     * These patterns are matched against text nodes and wrapped in styled spans.
+     *
+     * @example
+     * ```typescript
+     * renderingPatterns: [
+     *   // Match *narration* with single asterisks
+     *   { pattern: '(?<!\\*)\\*[^*]+\\*(?!\\*)', className: 'qt-chat-narration' },
+     *   // Match ((OOC)) with double parentheses
+     *   { pattern: '\\(\\([^)]+\\)\\)', className: 'qt-chat-ooc' },
+     * ]
+     * ```
+     */
+    renderingPatterns?: RenderingPattern[];
+    /**
+     * Optional dialogue detection for paragraph-level styling.
+     * When dialogue contains markdown formatting, inline patterns can't match.
+     * This detects paragraphs that start/end with quote characters.
+     *
+     * @example
+     * ```typescript
+     * dialogueDetection: {
+     *   openingChars: ['"', '"'],
+     *   closingChars: ['"', '"'],
+     *   className: 'qt-chat-dialogue'
+     * }
+     * ```
+     */
+    dialogueDetection?: DialogueDetection;
+    /**
+     * Narration delimiters — required for all templates.
+     * Defines how narration/action text is delimited in the template's formatting.
+     *
+     * A single string means the same delimiter is used for opening and closing (e.g., '*').
+     * A tuple of two strings means different opening and closing delimiters (e.g., ['[', ']']).
+     *
+     * @example
+     * ```typescript
+     * // Standard: *narration*
+     * narrationDelimiters: '*'
+     *
+     * // Quilltap RP: [narration]
+     * narrationDelimiters: ['[', ']']
+     * ```
+     */
+    narrationDelimiters: NarrationDelimiters;
+}
+/**
+ * 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;
+}
+
 /**
  * System Prompt Plugin Interface types for Quilltap plugin development
  *
@@ -373,4 +654,4 @@ interface ToolPluginExport {
  */
 declare const PLUGIN_TYPES_VERSION = "2.0.0";
 
-export { PLUGIN_TYPES_VERSION, type SystemPromptData, type SystemPromptMetadata, type SystemPromptPlugin, type SystemPromptPluginExport, type ToolExecutionContext, type ToolExecutionResult, type ToolHierarchyInfo, type ToolMetadata, type ToolPlugin, type ToolPluginExport, UniversalTool };
+export { type NarrationDelimiters, PLUGIN_TYPES_VERSION, type RoleplayTemplateConfig, type RoleplayTemplateMetadata, type RoleplayTemplatePlugin, type RoleplayTemplatePluginExport, type SystemPromptData, type SystemPromptMetadata, type SystemPromptPlugin, type SystemPromptPluginExport, type ToolExecutionContext, type ToolExecutionResult, type ToolHierarchyInfo, type ToolMetadata, type ToolPlugin, type ToolPluginExport, UniversalTool };

package/dist/plugins/index.d.mts

@@ -1,3 +1,3 @@
-export { a5 as AnnotationButton, A as AttachmentSupport, a as ColorPalette, a6 as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, i as ModerationCategoryResult, a7 as ModerationProviderConfig, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, N as NarrationDelimiters, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, a8 as RenderingPattern, R as RoleplayTemplateConfig, B as RoleplayTemplateMetadata, D as RoleplayTemplatePlugin, G as RoleplayTemplatePluginExport, S as ScoringProviderConfigRequirements, H as ScoringProviderMetadata, J as ScoringProviderPlugin, K as ScoringProviderPluginExport, O as SearchOutput, Q as SearchProviderConfig, T as SearchProviderConfigRequirements, U as SearchProviderMetadata, V as SearchProviderPlugin, W as SearchProviderPluginExport, X as SearchResult, Y as Spacing, _ as TextProviderPlugin, $ as ThemeMetadata, a0 as ThemePlugin, a1 as ThemePluginExport, a2 as ThemeTokens, a4 as Typography } from '../index-BcrOjfYG.mjs';
+export { A as AttachmentSupport, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, i as ModerationCategoryResult, a0 as ModerationProviderConfig, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, S as ScoringProviderConfigRequirements, B as ScoringProviderMetadata, D as ScoringProviderPlugin, G as ScoringProviderPluginExport, H as SearchOutput, J as SearchProviderConfig, K as SearchProviderConfigRequirements, N as SearchProviderMetadata, O as SearchProviderPlugin, Q as SearchProviderPluginExport, R as SearchResult, T as Spacing, V as TextProviderPlugin, W as ThemeMetadata, X as ThemePlugin, Y as ThemePluginExport, Z as ThemeTokens, $ as Typography } from '../index-BiFtkKWr.mjs';
 import '../llm/index.mjs';
 import '../providers/index.mjs';

package/dist/plugins/index.d.ts

@@ -1,3 +1,3 @@
-export { a5 as AnnotationButton, A as AttachmentSupport, a as ColorPalette, a6 as DialogueDetection, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, i as ModerationCategoryResult, a7 as ModerationProviderConfig, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, N as NarrationDelimiters, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, a8 as RenderingPattern, R as RoleplayTemplateConfig, B as RoleplayTemplateMetadata, D as RoleplayTemplatePlugin, G as RoleplayTemplatePluginExport, S as ScoringProviderConfigRequirements, H as ScoringProviderMetadata, J as ScoringProviderPlugin, K as ScoringProviderPluginExport, O as SearchOutput, Q as SearchProviderConfig, T as SearchProviderConfigRequirements, U as SearchProviderMetadata, V as SearchProviderPlugin, W as SearchProviderPluginExport, X as SearchResult, Y as Spacing, _ as TextProviderPlugin, $ as ThemeMetadata, a0 as ThemePlugin, a1 as ThemePluginExport, a2 as ThemeTokens, a4 as Typography } from '../index-DS_4gWcN.js';
+export { A as AttachmentSupport, a as ColorPalette, E as Effects, b as EmbeddedFont, c as EmbeddingModelInfo, F as FontDefinition, I as IconProps, d as ImageGenerationModelInfo, e as ImageProviderConstraints, g as InstalledPluginInfo, L as LLMProviderPlugin, h as ModelInfo, i as ModerationCategoryResult, a0 as ModerationProviderConfig, j as ModerationProviderConfigRequirements, k as ModerationProviderMetadata, l as ModerationProviderPlugin, m as ModerationProviderPluginExport, n as ModerationResult, P as PluginAuthor, o as PluginCapability, p as PluginCategory, q as PluginCompatibility, s as PluginManifest, t as PluginPermissions, u as PluginStatus, v as ProviderCapabilities, w as ProviderConfig, x as ProviderConfigRequirements, y as ProviderMetadata, z as ProviderPluginExport, S as ScoringProviderConfigRequirements, B as ScoringProviderMetadata, D as ScoringProviderPlugin, G as ScoringProviderPluginExport, H as SearchOutput, J as SearchProviderConfig, K as SearchProviderConfigRequirements, N as SearchProviderMetadata, O as SearchProviderPlugin, Q as SearchProviderPluginExport, R as SearchResult, T as Spacing, V as TextProviderPlugin, W as ThemeMetadata, X as ThemePlugin, Y as ThemePluginExport, Z as ThemeTokens, $ as Typography } from '../index-DNgmDKd5.js';
 import '../llm/index.js';
 import '../providers/index.js';

package/package.json

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