@quilltap/plugin-types 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.5.0] - 2026-01-02
+
+### Added
+
+- Added `RenderingPattern` interface for configurable message content styling:
+  - `pattern: string` - Regex pattern as a string (converted to RegExp at runtime)
+  - `className: string` - CSS class to apply to matched text
+  - `flags?: string` - Optional regex flags (e.g., 'm' for multiline)
+- Added `DialogueDetection` interface for paragraph-level dialogue detection:
+  - `openingChars: string[]` - Opening quote characters to detect
+  - `closingChars: string[]` - Closing quote characters to detect
+  - `className: string` - CSS class to apply to dialogue paragraphs
+- Added `renderingPatterns?: RenderingPattern[]` field to `RoleplayTemplateConfig`
+- Added `dialogueDetection?: DialogueDetection` field to `RoleplayTemplateConfig`
+- Exported `AnnotationButton`, `RenderingPattern`, `DialogueDetection` from `@quilltap/plugin-types/plugins`
+
 ## [1.4.0] - 2026-01-02
 
 ### Added

package/dist/{index-BH5jVqB9.d.mts → index-CRkRb81P.d.mts}

@@ -861,6 +861,60 @@ interface AnnotationButton {
     /** 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;
+}
 /**
  * Configuration for a single roleplay template
  *
@@ -893,6 +947,36 @@ interface RoleplayTemplateConfig {
      * ```
      */
     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;
 }
 /**
  * Metadata for a roleplay template plugin
@@ -998,4 +1082,4 @@ interface RoleplayTemplatePluginExport {
     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 };
+export type { AttachmentSupport as A, AnnotationButton as B, CheapModelConfig as C, RenderingPattern as D, EmbeddingModelInfo as E, FontDefinition as F, DialogueDetection as G, 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-C0tKQeeQ.d.ts → index-Cp1fIE0T.d.ts}

@@ -861,6 +861,60 @@ interface AnnotationButton {
     /** 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;
+}
 /**
  * Configuration for a single roleplay template
  *
@@ -893,6 +947,36 @@ interface RoleplayTemplateConfig {
      * ```
      */
     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;
 }
 /**
  * Metadata for a roleplay template plugin
@@ -998,4 +1082,4 @@ interface RoleplayTemplatePluginExport {
     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 };
+export type { AttachmentSupport as A, AnnotationButton as B, CheapModelConfig as C, RenderingPattern as D, EmbeddingModelInfo as E, FontDefinition as F, DialogueDetection as G, 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, 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-BH5jVqB9.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-CRkRb81P.mjs';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.mjs';
 import 'react';
 

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, 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-C0tKQeeQ.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-Cp1fIE0T.js';
 export { ApiKeyError, AttachmentError, ConfigurationError, LogContext, LogLevel, ModelNotFoundError, PluginError, PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger } from './common/index.js';
 import 'react';
 

package/dist/plugins/index.d.mts

@@ -1,3 +1,3 @@
-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-BH5jVqB9.mjs';
+export { B as AnnotationButton, A as AttachmentSupport, p as ColorPalette, G as DialogueDetection, 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, D as RenderingPattern, 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-CRkRb81P.mjs';
 import 'react';
 import '../llm/index.mjs';

package/dist/plugins/index.d.ts

@@ -1,3 +1,3 @@
-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-C0tKQeeQ.js';
+export { B as AnnotationButton, A as AttachmentSupport, p as ColorPalette, G as DialogueDetection, 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, D as RenderingPattern, 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-Cp1fIE0T.js';
 import 'react';
 import '../llm/index.js';

package/package.json

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