@changerawr/markdown 1.0.4 → 1.1.0

package/LICENSE

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

package/README.md

@@ -1,6 +1,6 @@
 # @changerawr/markdown
 
-> Powerful TypeScript-first markdown renderer with custom extensions - supports HTML, Tailwind CSS, and JSON outputs
+> Powerful TypeScript-first markdown renderer with modular extensions - supports HTML, Tailwind CSS, and JSON outputs
 
 [![npm version](https://badge.fury.io/js/@changerawr%2Fmarkdown.svg)](https://www.npmjs.com/package/@changerawr/markdown)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
@@ -9,7 +9,9 @@
 ## ✨ Features
 
 - 🚀 **Multiple Output Formats**: HTML, Tailwind CSS, or JSON AST
-- 🧩 **Custom Extensions**: Built-in Alert, Button, and Embed extensions
+- 🧩 **Modular Extensions**: Every feature is an extension - mix and match what you need
+- 📦 **Core Extensions**: Text, headings, bold, italic, code, links, images, lists, blockquotes, and more
+- 🎨 **Feature Extensions**: Built-in Alert, Button, and Embed extensions
 - ⚛️ **React Integration**: Drop-in `<MarkdownRenderer>` component + hooks
 - 🍦 **Vanilla JS Support**: Use anywhere with `renderCum()` function
 - 📝 **TypeScript First**: Fully typed with excellent IntelliSense
@@ -94,6 +96,57 @@ function MarkdownEditor() {
 }
 ```
 
+## 🧩 Modular Architecture
+
+Unlike traditional markdown parsers, **every feature is an extension**. This gives you complete control over what functionality you include.
+
+### Core Extensions (Always Available)
+- **TextExtension**: Plain text rendering with HTML escaping
+- **HeadingExtension**: H1-H6 headings with anchor links
+- **BoldExtension** & **ItalicExtension**: Text formatting
+- **InlineCodeExtension** & **CodeBlockExtension**: Code syntax
+- **LinkExtension** & **ImageExtension**: Links and images
+- **ListExtension** & **TaskListExtension**: Regular and task lists
+- **BlockquoteExtension**: Quote blocks
+- **HorizontalRuleExtension**: Horizontal dividers
+- **ParagraphExtension** & **LineBreakExtension**: Text flow
+
+### Feature Extensions (Built-in)
+- **AlertExtension**: Colored alert boxes
+- **ButtonExtension**: Interactive styled buttons
+- **EmbedExtension**: Media embeds (YouTube, GitHub, etc.)
+
+### Engine Variants
+
+```typescript
+import { 
+  createEngine,           // Full-featured (default)
+  createCoreOnlyEngine,   // Just markdown basics
+  createMinimalEngine,    // Only specified extensions
+  createHTMLEngine,       // Plain HTML output
+  createTailwindEngine    // Tailwind CSS output
+} from '@changerawr/markdown';
+
+// Full-featured engine (all extensions)
+const full = createEngine();
+
+// Core markdown only (no alerts/buttons/embeds)
+const core = createCoreOnlyEngine();
+
+// Minimal engine with only specific extensions
+const minimal = createMinimalEngine([
+  TextExtension,
+  HeadingExtension,
+  BoldExtension
+]);
+
+// Custom combination
+const custom = createCustomEngine([
+  ...CoreExtensions,      // All core extensions
+  MyCustomExtension       // Your extension
+]);
+```
+
 ## 🎨 Output Formats
 
 ### Tailwind CSS (Default)
@@ -155,6 +208,8 @@ Add styled buttons with custom actions:
 ```markdown
 [button:Get Started](https://example.com){primary,lg}
 [button:Learn More](https://docs.example.com){secondary,sm}
+[button:Same Tab](https://example.com){success,self}
+[button:Disabled](#){danger,disabled}
 ```
 
 ### Media Embeds
@@ -162,7 +217,8 @@ Embed videos, images, and other media:
 
 ```markdown
 [embed:youtube](https://www.youtube.com/watch?v=dQw4w9WgXcQ){autoplay:1}
-[embed:image](https://example.com/image.jpg){width:800,height:600}
+[embed:github](https://github.com/user/repo)
+[embed:codepen](https://codepen.io/user/pen/abc123){height:500,theme:dark}
 ```
 
 ## ⚛️ React Components
@@ -206,7 +262,7 @@ import { ChangerawrMarkdown } from '@changerawr/markdown';
 const engine = new ChangerawrMarkdown();
 
 // Add a highlight extension
-engine.registerExtension({
+const highlightExtension = {
   name: 'highlight',
   parseRules: [{
     name: 'highlight',
@@ -221,7 +277,9 @@ engine.registerExtension({
     type: 'highlight',
     render: (token) => `<mark class="bg-yellow-200 px-1">${token.content}</mark>`
   }]
-});
+};
+
+engine.registerExtension(highlightExtension);
 
 const html = engine.toHtml('This is ==highlighted text==');
 // <mark class="bg-yellow-200 px-1">highlighted text</mark>
@@ -278,10 +336,11 @@ import {
   createHTMLEngine,
   createTailwindEngine,
   createDebugEngine,
-  createMinimalEngine
+  createMinimalEngine,
+  createCoreOnlyEngine
 } from '@changerawr/markdown';
 
-// General purpose engine
+// General purpose engine (all extensions)
 const engine = createEngine();
 
 // HTML-only engine
@@ -290,8 +349,11 @@ const htmlEngine = createHTMLEngine();
 // Debug-enabled engine
 const debugEngine = createDebugEngine();
 
+// Core markdown only (no feature extensions)
+const coreEngine = createCoreOnlyEngine();
+
 // Minimal engine (no built-in extensions)
-const minimalEngine = createMinimalEngine();
+const minimalEngine = createMinimalEngine([TextExtension, HeadingExtension]);
 ```
 
 ## 🍦 Standalone Usage (No React)
@@ -299,7 +361,7 @@ const minimalEngine = createMinimalEngine();
 Perfect for Node.js, vanilla JavaScript, or any non-React environment:
 
 ```html
-<script src="https://unpkg.com/@changerawr/markdown/dist/standalone.js"></script>
+<script src="https://unpkg.com/@changerawr/markdown/dist/standalone.browser.js"></script>
 <script>
   const html = ChangerawrMarkdown.renderCum('# Hello World!');
   document.body.innerHTML = html;
@@ -316,6 +378,42 @@ const tokens = parseCum('# Hello World');
 
 ## 🎨 Styling & Theming
 
+### Tailwind CSS Plugin (v3 & v4 Compatible)
+
+**For Tailwind CSS v3:**
+```javascript
+// tailwind.config.js
+const { changerawrMarkdownPlugin } = require('@changerawr/markdown/tailwind');
+
+module.exports = {
+  content: ['./src/**/*.{js,ts,jsx,tsx}'],
+  plugins: [
+    changerawrMarkdownPlugin({
+      includeExtensions: true,   // Include alert/button styles
+      darkMode: true            // Include dark mode variants
+    })
+  ]
+}
+```
+
+**For Tailwind CSS v4:**
+```javascript
+// tailwind.config.js
+import { changerawrMarkdownPlugin } from '@changerawr/markdown/tailwind';
+
+export default {
+  content: ['./src/**/*.{js,ts,jsx,tsx}'],
+  plugins: [
+    changerawrMarkdownPlugin({
+      includeExtensions: true,   // Include alert/button styles
+      darkMode: true            // Include dark mode variants
+    })
+  ]
+}
+```
+
+The plugin ensures all necessary classes are available for markdown rendering, even if they're not used elsewhere in your app.
+
 ### Custom CSS Classes
 
 ```typescript
@@ -349,6 +447,9 @@ const docsEngine = createEngineWithPreset('docs');
 
 // Minimal styling
 const minimalEngine = createEngineWithPreset('minimal');
+
+// Core-only (no feature extensions)
+const coreEngine = createEngineWithPreset('coreOnly');
 ```
 
 ## 🔍 Debugging & Development
@@ -400,7 +501,8 @@ console.log('Token count:', metrics.tokenCount);
 
 ### Optimization Tips
 
-- Use `createMinimalEngine()` if you don't need built-in extensions
+- Use `createCoreOnlyEngine()` if you don't need feature extensions
+- Use `createMinimalEngine()` with only the extensions you need
 - Set `sanitize: false` if you trust your content (be careful!)
 - Use `format: 'html'` for lighter output without CSS classes
 - Implement custom extensions efficiently to avoid performance bottlenecks
@@ -425,6 +527,16 @@ npm run test:coverage   # Run with coverage report
 - `renderToTailwind(markdown: string): string` - Render with Tailwind classes
 - `renderToJSON(markdown: string): JsonAstNode` - Render to JSON AST
 
+### Factory Functions
+
+- `createEngine(config?)` - Full-featured engine
+- `createCoreOnlyEngine(config?)` - Core markdown only
+- `createMinimalEngine(extensions[])` - Minimal with specified extensions
+- `createHTMLEngine(config?)` - HTML output optimized
+- `createTailwindEngine(config?)` - Tailwind output optimized
+- `createDebugEngine(config?)` - Debug mode enabled
+- `createCustomEngine(extensions[], config?)` - Custom extension set
+
 ### React Components
 
 - `<MarkdownRenderer />` - Main React component
@@ -444,6 +556,12 @@ npm run test:coverage   # Run with coverage report
 - `MarkdownParser` - Content parsing
 - `MarkdownRenderer` - Token rendering
 
+### Extensions
+
+- **Core Extensions**: `CoreExtensions` array or individual exports
+- **Feature Extensions**: `AlertExtension`, `ButtonExtension`, `EmbedExtension`
+- **Custom**: Create your own with `parseRules` and `renderRules`
+
 ## 🤝 Contributing
 
 We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
@@ -462,9 +580,9 @@ MIT © [Changerawr Team](https://github.com/changerawr)
 
 ## 💡 What Makes It Special?
 
+- **Extension-First Architecture**: Every feature is modular - use only what you need
 - **TypeScript-First**: Built with TypeScript from the ground up for excellent developer experience
 - **Framework Agnostic**: Works with React, Vue, Svelte, vanilla JS, or any framework
-- **Extensible Architecture**: Easy to add custom markdown syntax and rendering
 - **Production Ready**: Thoroughly tested, performant, and secure
 - **Modern Output**: Tailwind CSS support for modern web applications
 - **Developer Friendly**: Great debugging tools and clear error messages

package/dist/index.d.mts

@@ -91,53 +91,18 @@ declare class ChangerawrMarkdown {
     private renderer;
     private extensions;
     constructor(config?: EngineConfig);
-    /**
-     * Register a custom extension
-     */
+    private registerFeatureExtensions;
+    private registerCoreExtensions;
     registerExtension(extension: Extension): ExtensionRegistration;
-    /**
-     * Unregister an extension
-     */
     unregisterExtension(name: string): boolean;
-    /**
-     * Parse markdown content into tokens
-     */
     parse(markdown: string): MarkdownToken[];
-    /**
-     * Render tokens to HTML
-     */
     render(tokens: MarkdownToken[]): string;
-    /**
-     * Parse and render markdown to HTML in one step
-     */
     toHtml(markdown: string): string;
-    /**
-     * Get list of registered extensions
-     */
     getExtensions(): string[];
-    /**
-     * Check if extension is registered
-     */
     hasExtension(name: string): boolean;
-    /**
-     * Get parser warnings
-     */
     getWarnings(): string[];
-    /**
-     * Get debug information from last render
-     */
     getDebugInfo(): DebugInfo | null;
-    /**
-     * Get performance metrics for the last operation
-     */
     getPerformanceMetrics(): PerformanceMetrics | null;
-    /**
-     * Register built-in extensions
-     */
-    private registerBuiltInExtensions;
-    /**
-     * Rebuild parser and renderer with current extensions
-     */
     private rebuildParserAndRenderer;
 }
 declare function parseMarkdown(content: string): MarkdownToken[];
@@ -409,7 +374,6 @@ declare class MarkdownParser {
     private config;
     constructor(config?: ParserConfig);
     addRule(rule: ParseRule): void;
-    setupDefaultRulesIfEmpty(): void;
     hasRule(name: string): boolean;
     parse(markdown: string): MarkdownToken[];
     getWarnings(): string[];
@@ -417,11 +381,9 @@ declare class MarkdownParser {
     updateConfig(config: Partial<ParserConfig>): void;
     setDebugMode(enabled: boolean): void;
     clearWarnings(): void;
-    getIterationCount(): number;
     private preprocessMarkdown;
     private validateMarkdown;
     private postProcessTokens;
-    private setupDefaultRules;
 }
 
 declare class MarkdownRenderer {
@@ -432,15 +394,14 @@ declare class MarkdownRenderer {
     addRule(rule: RenderRule): void;
     hasRule(type: string): boolean;
     render(tokens: MarkdownToken[]): string;
+    private renderToken;
+    private createErrorBlock;
+    private createDebugBlock;
     getWarnings(): string[];
     getConfig(): RendererConfig;
     updateConfig(config: Partial<RendererConfig>): void;
     setDebugMode(enabled: boolean): void;
     clearWarnings(): void;
-    private renderToken;
-    private createErrorBlock;
-    private createDebugBlock;
-    private setupDefaultRules;
 }
 
 declare const AlertExtension: Extension;
@@ -449,6 +410,33 @@ declare const ButtonExtension: Extension;
 
 declare const EmbedExtension: Extension;
 
+declare const BlockquoteExtension: Extension;
+
+declare const LineBreakExtension: Extension;
+
+declare const InlineCodeExtension: Extension;
+declare const CodeBlockExtension: Extension;
+
+declare const BoldExtension: Extension;
+declare const ItalicExtension: Extension;
+
+declare const HeadingExtension: Extension;
+
+declare const HorizontalRuleExtension: Extension;
+
+declare const ImageExtension: Extension;
+
+declare const LinkExtension: Extension;
+
+declare const ListExtension: Extension;
+declare const TaskListExtension: Extension;
+
+declare const ParagraphExtension: Extension;
+
+declare const TextExtension: Extension;
+
+declare const CoreExtensions: readonly [Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension];
+
 /**
  * @changerawr/markdown - Main package exports
  *
@@ -473,9 +461,13 @@ declare function createTailwindEngine(config?: Omit<EngineConfig, 'renderer'>):
  */
 declare function createDebugEngine(config?: EngineConfig): ChangerawrMarkdown;
 /**
- * Create an engine without built-in extensions (minimal setup)
+ * Create an engine with only specified extensions (minimal setup)
+ */
+declare function createMinimalEngine(extensions?: Extension[]): ChangerawrMarkdown;
+/**
+ * Create an engine with only core markdown extensions (no custom features)
  */
-declare function createMinimalEngine(config?: EngineConfig): ChangerawrMarkdown;
+declare function createCoreOnlyEngine(config?: EngineConfig): ChangerawrMarkdown;
 /**
  * Create an engine with custom extensions only
  */
@@ -496,11 +488,27 @@ declare const markdown: {
     readonly createTailwindEngine: typeof createTailwindEngine;
     readonly createDebugEngine: typeof createDebugEngine;
     readonly createMinimalEngine: typeof createMinimalEngine;
+    readonly createCoreOnlyEngine: typeof createCoreOnlyEngine;
     readonly createCustomEngine: typeof createCustomEngine;
     readonly renderCum: typeof renderCum;
     readonly parseCum: typeof parseCum;
     readonly ChangerawrMarkdown: typeof ChangerawrMarkdown;
     readonly extensions: {
+        readonly core: readonly [Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension];
+        readonly Text: Extension;
+        readonly Heading: Extension;
+        readonly Bold: Extension;
+        readonly Italic: Extension;
+        readonly InlineCode: Extension;
+        readonly CodeBlock: Extension;
+        readonly Link: Extension;
+        readonly Image: Extension;
+        readonly List: Extension;
+        readonly TaskList: Extension;
+        readonly Blockquote: Extension;
+        readonly HorizontalRule: Extension;
+        readonly Paragraph: Extension;
+        readonly LineBreak: Extension;
         readonly Alert: Extension;
         readonly Button: Extension;
         readonly Embed: Extension;
@@ -563,6 +571,14 @@ declare const presets: {
             readonly sanitize: true;
         };
     };
+    /**
+     * Core-only preset with just markdown basics
+     */
+    readonly coreOnly: {
+        readonly renderer: {
+            readonly format: "tailwind";
+        };
+    };
     /**
      * Performance preset with minimal processing
      */
@@ -582,4 +598,4 @@ declare const presets: {
  */
 declare function createEngineWithPreset(presetName: keyof typeof presets, additionalConfig?: EngineConfig): ChangerawrMarkdown;
 
-export { type ASTStatistics, AlertExtension, ButtonExtension, ChangerawrMarkdown, type DebugInfo, EmbedExtension, type EngineConfig, type EngineEvents, type Extension, ExtensionError, type Extension as ExtensionInterface, type ExtensionRegistration, type JsonAstNode, Logger, MarkdownParseError, MarkdownParser, MarkdownRenderError, MarkdownRenderer, type MarkdownToken, type OutputFormat, type ParseRule, type ParserConfig, type PerformanceMetrics, PerformanceTimer, type RenderRule, type RendererConfig, type TokenComparison, type TokenDifference, type TokenStatistics, type TokenType, astToJSONString, astToTokens, basicSanitize, compareTokens, createCumEngine, createCustomEngine, createDebugEngine, createEngine, createEngineWithPreset, createHTMLEngine, createMinimalEngine, createTailwindEngine, debounce, deepMerge, markdown as default, defaultTailwindClasses, escapeHtml, extractDomain, generateId, getASTStats, getTokenStats, isBrowser, isNode, isValidUrl, markdown, minimalClasses, parseASTFromJSON, parseCum, parseMarkdown, parseOptions, parseTokensFromJSON, presets, proseClasses, renderCum, renderCumToHtml, renderCumToJson, renderCumToTailwind, renderMarkdown, renderToAST, renderToHTML, renderToHTMLUnsafe, renderToHTMLWithConfig, renderToJSON, renderToTailwind, renderToTailwindWithClasses, renderToTailwindWithConfig, sanitizeHtml, tokensToAST, tokensToJSONString };
+export { type ASTStatistics, AlertExtension, BlockquoteExtension, BoldExtension, ButtonExtension, ChangerawrMarkdown, CodeBlockExtension, CoreExtensions, type DebugInfo, EmbedExtension, type EngineConfig, type EngineEvents, type Extension, ExtensionError, type Extension as ExtensionInterface, type ExtensionRegistration, HeadingExtension, HorizontalRuleExtension, ImageExtension, InlineCodeExtension, ItalicExtension, type JsonAstNode, LineBreakExtension, LinkExtension, ListExtension, Logger, MarkdownParseError, MarkdownParser, MarkdownRenderError, MarkdownRenderer, type MarkdownToken, type OutputFormat, ParagraphExtension, type ParseRule, type ParserConfig, type PerformanceMetrics, PerformanceTimer, type RenderRule, type RendererConfig, TaskListExtension, TextExtension, type TokenComparison, type TokenDifference, type TokenStatistics, type TokenType, astToJSONString, astToTokens, basicSanitize, compareTokens, createCoreOnlyEngine, createCumEngine, createCustomEngine, createDebugEngine, createEngine, createEngineWithPreset, createHTMLEngine, createMinimalEngine, createTailwindEngine, debounce, deepMerge, markdown as default, defaultTailwindClasses, escapeHtml, extractDomain, generateId, getASTStats, getTokenStats, isBrowser, isNode, isValidUrl, markdown, minimalClasses, parseASTFromJSON, parseCum, parseMarkdown, parseOptions, parseTokensFromJSON, presets, proseClasses, renderCum, renderCumToHtml, renderCumToJson, renderCumToTailwind, renderMarkdown, renderToAST, renderToHTML, renderToHTMLUnsafe, renderToHTMLWithConfig, renderToJSON, renderToTailwind, renderToTailwindWithClasses, renderToTailwindWithConfig, sanitizeHtml, tokensToAST, tokensToJSONString };

package/dist/index.d.ts

@@ -91,53 +91,18 @@ declare class ChangerawrMarkdown {
     private renderer;
     private extensions;
     constructor(config?: EngineConfig);
-    /**
-     * Register a custom extension
-     */
+    private registerFeatureExtensions;
+    private registerCoreExtensions;
     registerExtension(extension: Extension): ExtensionRegistration;
-    /**
-     * Unregister an extension
-     */
     unregisterExtension(name: string): boolean;
-    /**
-     * Parse markdown content into tokens
-     */
     parse(markdown: string): MarkdownToken[];
-    /**
-     * Render tokens to HTML
-     */
     render(tokens: MarkdownToken[]): string;
-    /**
-     * Parse and render markdown to HTML in one step
-     */
     toHtml(markdown: string): string;
-    /**
-     * Get list of registered extensions
-     */
     getExtensions(): string[];
-    /**
-     * Check if extension is registered
-     */
     hasExtension(name: string): boolean;
-    /**
-     * Get parser warnings
-     */
     getWarnings(): string[];
-    /**
-     * Get debug information from last render
-     */
     getDebugInfo(): DebugInfo | null;
-    /**
-     * Get performance metrics for the last operation
-     */
     getPerformanceMetrics(): PerformanceMetrics | null;
-    /**
-     * Register built-in extensions
-     */
-    private registerBuiltInExtensions;
-    /**
-     * Rebuild parser and renderer with current extensions
-     */
     private rebuildParserAndRenderer;
 }
 declare function parseMarkdown(content: string): MarkdownToken[];
@@ -409,7 +374,6 @@ declare class MarkdownParser {
     private config;
     constructor(config?: ParserConfig);
     addRule(rule: ParseRule): void;
-    setupDefaultRulesIfEmpty(): void;
     hasRule(name: string): boolean;
     parse(markdown: string): MarkdownToken[];
     getWarnings(): string[];
@@ -417,11 +381,9 @@ declare class MarkdownParser {
     updateConfig(config: Partial<ParserConfig>): void;
     setDebugMode(enabled: boolean): void;
     clearWarnings(): void;
-    getIterationCount(): number;
     private preprocessMarkdown;
     private validateMarkdown;
     private postProcessTokens;
-    private setupDefaultRules;
 }
 
 declare class MarkdownRenderer {
@@ -432,15 +394,14 @@ declare class MarkdownRenderer {
     addRule(rule: RenderRule): void;
     hasRule(type: string): boolean;
     render(tokens: MarkdownToken[]): string;
+    private renderToken;
+    private createErrorBlock;
+    private createDebugBlock;
     getWarnings(): string[];
     getConfig(): RendererConfig;
     updateConfig(config: Partial<RendererConfig>): void;
     setDebugMode(enabled: boolean): void;
     clearWarnings(): void;
-    private renderToken;
-    private createErrorBlock;
-    private createDebugBlock;
-    private setupDefaultRules;
 }
 
 declare const AlertExtension: Extension;
@@ -449,6 +410,33 @@ declare const ButtonExtension: Extension;
 
 declare const EmbedExtension: Extension;
 
+declare const BlockquoteExtension: Extension;
+
+declare const LineBreakExtension: Extension;
+
+declare const InlineCodeExtension: Extension;
+declare const CodeBlockExtension: Extension;
+
+declare const BoldExtension: Extension;
+declare const ItalicExtension: Extension;
+
+declare const HeadingExtension: Extension;
+
+declare const HorizontalRuleExtension: Extension;
+
+declare const ImageExtension: Extension;
+
+declare const LinkExtension: Extension;
+
+declare const ListExtension: Extension;
+declare const TaskListExtension: Extension;
+
+declare const ParagraphExtension: Extension;
+
+declare const TextExtension: Extension;
+
+declare const CoreExtensions: readonly [Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension];
+
 /**
  * @changerawr/markdown - Main package exports
  *
@@ -473,9 +461,13 @@ declare function createTailwindEngine(config?: Omit<EngineConfig, 'renderer'>):
  */
 declare function createDebugEngine(config?: EngineConfig): ChangerawrMarkdown;
 /**
- * Create an engine without built-in extensions (minimal setup)
+ * Create an engine with only specified extensions (minimal setup)
+ */
+declare function createMinimalEngine(extensions?: Extension[]): ChangerawrMarkdown;
+/**
+ * Create an engine with only core markdown extensions (no custom features)
  */
-declare function createMinimalEngine(config?: EngineConfig): ChangerawrMarkdown;
+declare function createCoreOnlyEngine(config?: EngineConfig): ChangerawrMarkdown;
 /**
  * Create an engine with custom extensions only
  */
@@ -496,11 +488,27 @@ declare const markdown: {
     readonly createTailwindEngine: typeof createTailwindEngine;
     readonly createDebugEngine: typeof createDebugEngine;
     readonly createMinimalEngine: typeof createMinimalEngine;
+    readonly createCoreOnlyEngine: typeof createCoreOnlyEngine;
     readonly createCustomEngine: typeof createCustomEngine;
     readonly renderCum: typeof renderCum;
     readonly parseCum: typeof parseCum;
     readonly ChangerawrMarkdown: typeof ChangerawrMarkdown;
     readonly extensions: {
+        readonly core: readonly [Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension, Extension];
+        readonly Text: Extension;
+        readonly Heading: Extension;
+        readonly Bold: Extension;
+        readonly Italic: Extension;
+        readonly InlineCode: Extension;
+        readonly CodeBlock: Extension;
+        readonly Link: Extension;
+        readonly Image: Extension;
+        readonly List: Extension;
+        readonly TaskList: Extension;
+        readonly Blockquote: Extension;
+        readonly HorizontalRule: Extension;
+        readonly Paragraph: Extension;
+        readonly LineBreak: Extension;
         readonly Alert: Extension;
         readonly Button: Extension;
         readonly Embed: Extension;
@@ -563,6 +571,14 @@ declare const presets: {
             readonly sanitize: true;
         };
     };
+    /**
+     * Core-only preset with just markdown basics
+     */
+    readonly coreOnly: {
+        readonly renderer: {
+            readonly format: "tailwind";
+        };
+    };
     /**
      * Performance preset with minimal processing
      */
@@ -582,4 +598,4 @@ declare const presets: {
  */
 declare function createEngineWithPreset(presetName: keyof typeof presets, additionalConfig?: EngineConfig): ChangerawrMarkdown;
 
-export { type ASTStatistics, AlertExtension, ButtonExtension, ChangerawrMarkdown, type DebugInfo, EmbedExtension, type EngineConfig, type EngineEvents, type Extension, ExtensionError, type Extension as ExtensionInterface, type ExtensionRegistration, type JsonAstNode, Logger, MarkdownParseError, MarkdownParser, MarkdownRenderError, MarkdownRenderer, type MarkdownToken, type OutputFormat, type ParseRule, type ParserConfig, type PerformanceMetrics, PerformanceTimer, type RenderRule, type RendererConfig, type TokenComparison, type TokenDifference, type TokenStatistics, type TokenType, astToJSONString, astToTokens, basicSanitize, compareTokens, createCumEngine, createCustomEngine, createDebugEngine, createEngine, createEngineWithPreset, createHTMLEngine, createMinimalEngine, createTailwindEngine, debounce, deepMerge, markdown as default, defaultTailwindClasses, escapeHtml, extractDomain, generateId, getASTStats, getTokenStats, isBrowser, isNode, isValidUrl, markdown, minimalClasses, parseASTFromJSON, parseCum, parseMarkdown, parseOptions, parseTokensFromJSON, presets, proseClasses, renderCum, renderCumToHtml, renderCumToJson, renderCumToTailwind, renderMarkdown, renderToAST, renderToHTML, renderToHTMLUnsafe, renderToHTMLWithConfig, renderToJSON, renderToTailwind, renderToTailwindWithClasses, renderToTailwindWithConfig, sanitizeHtml, tokensToAST, tokensToJSONString };
+export { type ASTStatistics, AlertExtension, BlockquoteExtension, BoldExtension, ButtonExtension, ChangerawrMarkdown, CodeBlockExtension, CoreExtensions, type DebugInfo, EmbedExtension, type EngineConfig, type EngineEvents, type Extension, ExtensionError, type Extension as ExtensionInterface, type ExtensionRegistration, HeadingExtension, HorizontalRuleExtension, ImageExtension, InlineCodeExtension, ItalicExtension, type JsonAstNode, LineBreakExtension, LinkExtension, ListExtension, Logger, MarkdownParseError, MarkdownParser, MarkdownRenderError, MarkdownRenderer, type MarkdownToken, type OutputFormat, ParagraphExtension, type ParseRule, type ParserConfig, type PerformanceMetrics, PerformanceTimer, type RenderRule, type RendererConfig, TaskListExtension, TextExtension, type TokenComparison, type TokenDifference, type TokenStatistics, type TokenType, astToJSONString, astToTokens, basicSanitize, compareTokens, createCoreOnlyEngine, createCumEngine, createCustomEngine, createDebugEngine, createEngine, createEngineWithPreset, createHTMLEngine, createMinimalEngine, createTailwindEngine, debounce, deepMerge, markdown as default, defaultTailwindClasses, escapeHtml, extractDomain, generateId, getASTStats, getTokenStats, isBrowser, isNode, isValidUrl, markdown, minimalClasses, parseASTFromJSON, parseCum, parseMarkdown, parseOptions, parseTokensFromJSON, presets, proseClasses, renderCum, renderCumToHtml, renderCumToJson, renderCumToTailwind, renderMarkdown, renderToAST, renderToHTML, renderToHTMLUnsafe, renderToHTMLWithConfig, renderToJSON, renderToTailwind, renderToTailwindWithClasses, renderToTailwindWithConfig, sanitizeHtml, tokensToAST, tokensToJSONString };