create-markdown 0.1.1 → 0.2.0

package/README.md

@@ -3,10 +3,19 @@
 [![npm version](https://img.shields.io/npm/v/create-markdown.svg)](https://www.npmjs.com/package/create-markdown)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Markdown package to enable creating markdown interfaces seamlessly because it is complicated and annoying asf.
+A complete block-based markdown notes package with zero dependencies. Parse, create, and serialize markdown with full TypeScript support.
 
 📦 **[View on npm](https://www.npmjs.com/package/create-markdown)**
 
+## Features
+
+- 🧱 **Block-based architecture** - Work with structured blocks instead of raw strings
+- 🔄 **Bidirectional conversion** - Parse markdown to blocks, serialize blocks to markdown
+- 📝 **Rich inline styles** - Bold, italic, code, links, strikethrough, highlights
+- ⚛️ **React components** - Optional React bindings for rendering and editing
+- 🪶 **Zero dependencies** - Core package has no runtime dependencies
+- 🔒 **Full TypeScript** - Complete type definitions with generics
+
 ## Installation
 
 ```bash
@@ -23,73 +32,191 @@ yarn add create-markdown
 pnpm add create-markdown
 ```
 
-## Usage
+## Quick Start
 
-### ESM (recommended)
+### Parse Markdown to Blocks
 
 ```typescript
-import { createMarkdown } from 'create-markdown';
+import { parse } from 'create-markdown';
+
+const blocks = parse(`# Hello World
+
+This is **bold** and *italic* text.
+
+- Item one
+- Item two
+`);
 
-const doc = createMarkdown('# Hello World');
-console.log(doc.content);
+console.log(blocks);
+// [
+//   { type: 'heading', props: { level: 1 }, content: [...] },
+//   { type: 'paragraph', content: [...] },
+//   { type: 'bulletList', children: [...] }
+// ]
 ```
 
-### Default Export
+### Create Blocks Programmatically
 
 ```typescript
-import createMarkdown from 'create-markdown';
+import { h1, paragraph, bulletList, bold, italic, spans } from 'create-markdown';
+
+const blocks = [
+  h1('My Document'),
+  paragraph(spans(
+    bold('Important: '),
+    { text: 'This is ', styles: {} },
+    italic('really'),
+    { text: ' cool!', styles: {} }
+  )),
+  bulletList(['First item', 'Second item', 'Third item']),
+];
+```
+
+### Serialize Blocks to Markdown
 
-const doc = createMarkdown('# Hello World');
-console.log(doc.content);
+```typescript
+import { stringify, h1, paragraph, codeBlock } from 'create-markdown';
+
+const markdown = stringify([
+  h1('Hello'),
+  paragraph('World'),
+  codeBlock('console.log("Hi!");', 'javascript'),
+]);
+
+console.log(markdown);
+// # Hello
+//
+// World
+//
+// ```javascript
+// console.log("Hi!");
+// ```
 ```
 
-### CommonJS
+### Document Management
+
+```typescript
+import { 
+  createDocument, 
+  appendBlock, 
+  removeBlock, 
+  findBlock,
+  paragraph 
+} from 'create-markdown';
 
-```javascript
-const { createMarkdown } = require('create-markdown');
+// Create a document
+let doc = createDocument([paragraph('First paragraph')]);
 
-const doc = createMarkdown('# Hello World');
-console.log(doc.content);
+// Add a block
+doc = appendBlock(doc, paragraph('Second paragraph'));
+
+// Find a block
+const block = findBlock(doc, 'some-id');
+
+// Remove a block
+doc = removeBlock(doc, 'some-id');
 ```
 
-### With Options
+## React Components
+
+Optional React bindings are available via a separate import:
+
+```tsx
+import { BlockRenderer, useDocument, useMarkdown } from 'create-markdown/react';
+import { paragraph, h1 } from 'create-markdown/react';
+
+function Editor() {
+  const { blocks, appendBlock, toMarkdown } = useDocument();
+  
+  return (
+    <div>
+      <BlockRenderer blocks={blocks} />
+      <button onClick={() => appendBlock(paragraph('New paragraph'))}>
+        Add Paragraph
+      </button>
+      <button onClick={() => console.log(toMarkdown())}>
+        Export Markdown
+      </button>
+    </div>
+  );
+}
+
+function MarkdownEditor() {
+  const { markdown, blocks, setMarkdown } = useMarkdown('# Hello');
+  
+  return (
+    <div>
+      <textarea 
+        value={markdown} 
+        onChange={(e) => setMarkdown(e.target.value)} 
+      />
+      <BlockRenderer blocks={blocks} />
+    </div>
+  );
+}
+```
 
-```typescript
-import { createMarkdown, type MarkdownOptions } from 'create-markdown';
+## Block Types
+
+| Type | Factory Function | Description |
+|------|-----------------|-------------|
+| `paragraph` | `paragraph(content)` | Text paragraph |
+| `heading` | `heading(level, content)` or `h1`-`h6` | Heading levels 1-6 |
+| `bulletList` | `bulletList(items)` | Unordered list |
+| `numberedList` | `numberedList(items)` | Ordered list |
+| `checkList` | `checkList(items)` | Task list with checkboxes |
+| `codeBlock` | `codeBlock(code, language?)` | Fenced code block |
+| `blockquote` | `blockquote(content)` | Block quote |
+| `image` | `image(url, alt?)` | Image |
+| `divider` | `divider()` | Horizontal rule |
+| `table` | `table(headers, rows)` | Table with headers |
+| `callout` | `callout(type, content)` | Callout/admonition |
 
-const options: MarkdownOptions = {
-  strict: true,
-  lineEnding: '\n',
-};
+## Inline Styles
 
-const doc = createMarkdown('# My Document', options);
+```typescript
+import { bold, italic, code, link, strikethrough, highlight } from 'create-markdown';
+
+// Create styled text spans
+const content = [
+  bold('Bold text'),
+  italic('Italic text'),
+  code('inline code'),
+  link('Click here', 'https://example.com'),
+  strikethrough('deleted'),
+  highlight('highlighted'),
+];
 ```
 
-## API
+## API Reference
 
-### `createMarkdown(content?, options?)`
+### Parsing
 
-Creates a new markdown document.
+- `parse(markdown)` - Parse markdown string to blocks
+- `markdownToBlocks(markdown, options?)` - Full parser with options
+- `markdownToDocument(markdown)` - Parse to a Document object
 
-**Parameters:**
-- `content` (string, optional): Initial markdown content
-- `options` (MarkdownOptions, optional): Configuration options
-  - `strict` (boolean): Enable strict parsing mode
-  - `lineEnding` (string): Custom line ending (default: `'\n'`)
+### Serialization
 
-**Returns:** `MarkdownDocument`
-- `content` (string): Raw markdown content
-- `meta` (Record<string, unknown>): Document metadata
+- `stringify(blocks)` - Serialize blocks to markdown
+- `blocksToMarkdown(blocks, options?)` - Full serializer with options
+- `documentToMarkdown(doc)` - Serialize a Document
 
-### `VERSION`
+### Document Operations
 
-Package version string.
+- `createDocument(blocks?, options?)` - Create a new document
+- `insertBlock(doc, block, index?)` - Insert block at position
+- `appendBlock(doc, block)` - Add block at end
+- `removeBlock(doc, blockId)` - Remove block by ID
+- `updateBlock(doc, blockId, updates)` - Update block properties
+- `moveBlock(doc, blockId, newIndex)` - Reorder blocks
+- `findBlock(doc, blockId)` - Find block by ID
 
-```typescript
-import { VERSION } from 'create-markdown';
+### React Hooks
 
-console.log(VERSION); // '0.1.1'
-```
+- `useDocument(initialBlocks?)` - Full document state management
+- `useMarkdown(initialMarkdown?)` - Bidirectional markdown/blocks
+- `useBlockEditor(doc)` - Selection and editing operations
 
 ## Development
 
@@ -100,11 +227,8 @@ bun install
 # Build the package
 bun run build
 
-# Watch mode during development
-bun run dev
-
-# Clean build artifacts
-bun run clean
+# Type check
+bun run typecheck
 
 # Run the playground
 bun run playground
@@ -114,6 +238,7 @@ bun run playground
 
 - Node.js 20+
 - Bun 1.0+ (for development)
+- React 18+ (optional, for React components)
 
 ## Contributing
 

package/dist/core/blocks.d.ts

@@ -0,0 +1,136 @@
+/**
+ * create-markdown - Block Factory Functions
+ * Create and manipulate block structures
+ */
+import type { Block, BlockType, TextSpan, InlineStyle, HeadingBlock, ParagraphBlock, BulletListBlock, NumberedListBlock, CheckListBlock, CodeBlockBlock, BlockquoteBlock, ImageBlock, DividerBlock, CalloutBlock, CalloutType, TableBlock } from '../types';
+/**
+ * Creates: block with the specified type and properties
+ */
+export declare function createBlock<T extends BlockType>(type: T, content?: TextSpan[], props?: Block<T>['props'], children?: Block[]): Block<T>;
+/**
+ * Creates: plain text span with no styles
+ */
+export declare function text(content: string): TextSpan;
+/**
+ * Creates: bold text span
+ */
+export declare function bold(content: string): TextSpan;
+/**
+ * Creates: italic text span
+ */
+export declare function italic(content: string): TextSpan;
+/**
+ * Creates: inline code text span
+ */
+export declare function code(content: string): TextSpan;
+/**
+ * Creates: strikethrough text span
+ */
+export declare function strikethrough(content: string): TextSpan;
+/**
+ * Creates: underlined text span
+ */
+export declare function underline(content: string): TextSpan;
+/**
+ * Creates: highlighted text span
+ */
+export declare function highlight(content: string): TextSpan;
+/**
+ * Creates: link text span
+ */
+export declare function link(content: string, url: string, title?: string): TextSpan;
+/**
+ * Creates: text span with custom styles
+ */
+export declare function styled(content: string, styles: InlineStyle): TextSpan;
+/**
+ * Combines multiple text spans into a content array
+ */
+export declare function spans(...textSpans: TextSpan[]): TextSpan[];
+/**
+ * Creates: paragraph block
+ */
+export declare function paragraph(content: string | TextSpan[]): ParagraphBlock;
+/**
+ * Creates: heading block
+ */
+export declare function heading(level: 1 | 2 | 3 | 4 | 5 | 6, content: string | TextSpan[]): HeadingBlock;
+export declare const h1: (content: string | TextSpan[]) => HeadingBlock;
+export declare const h2: (content: string | TextSpan[]) => HeadingBlock;
+export declare const h3: (content: string | TextSpan[]) => HeadingBlock;
+export declare const h4: (content: string | TextSpan[]) => HeadingBlock;
+export declare const h5: (content: string | TextSpan[]) => HeadingBlock;
+export declare const h6: (content: string | TextSpan[]) => HeadingBlock;
+/**
+ * Creates: bullet list block with items
+ */
+export declare function bulletList(items: (string | TextSpan[] | Block)[]): BulletListBlock;
+/**
+ * Creates: numbered list block with items
+ */
+export declare function numberedList(items: (string | TextSpan[] | Block)[]): NumberedListBlock;
+/**
+ * Creates: checklist item
+ */
+export declare function checkListItem(content: string | TextSpan[], checked?: boolean): CheckListBlock;
+/**
+ * Creates: checklist with multiple items
+ */
+export declare function checkList(items: {
+    content: string | TextSpan[];
+    checked?: boolean;
+}[]): Block[];
+/**
+ * Creates: code block
+ */
+export declare function codeBlock(code: string, language?: string): CodeBlockBlock;
+/**
+ * Creates: blockquote
+ */
+export declare function blockquote(content: string | TextSpan[]): BlockquoteBlock;
+/**
+ * Creates: horizontal divider
+ */
+export declare function divider(): DividerBlock;
+/**
+ * Creates: image block
+ */
+export declare function image(url: string, alt?: string, options?: {
+    title?: string;
+    width?: number;
+    height?: number;
+}): ImageBlock;
+/**
+ * Creates: callout block
+ */
+export declare function callout(type: CalloutType, content: string | TextSpan[]): CalloutBlock;
+export declare const infoCallout: (content: string | TextSpan[]) => CalloutBlock;
+export declare const warningCallout: (content: string | TextSpan[]) => CalloutBlock;
+export declare const tipCallout: (content: string | TextSpan[]) => CalloutBlock;
+export declare const dangerCallout: (content: string | TextSpan[]) => CalloutBlock;
+export declare const noteCallout: (content: string | TextSpan[]) => CalloutBlock;
+/**
+ * Creates: table block
+ */
+export declare function table(headers: string[], rows: string[][], alignments?: ('left' | 'center' | 'right' | null)[]): TableBlock;
+/**
+ * Adds: content to an existing block
+ */
+export declare function appendContent<T extends BlockType>(block: Block<T>, ...newSpans: TextSpan[]): Block<T>;
+/**
+ * Prepends: content to an existing block
+ */
+export declare function prependContent<T extends BlockType>(block: Block<T>, ...newSpans: TextSpan[]): Block<T>;
+/**
+ * Replaces: the content of a block
+ */
+export declare function setContent<T extends BlockType>(block: Block<T>, content: TextSpan[]): Block<T>;
+/**
+ * Adds: children to a block
+ */
+export declare function addChildren<T extends BlockType>(block: Block<T>, ...newChildren: Block[]): Block<T>;
+/**
+ * Updates: block properties
+ */
+export declare function updateProps<T extends BlockType>(block: Block<T>, props: Partial<Block<T>['props']>): Block<T>;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/core/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/core/blocks.ts"],"names":[],"mappings":"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"}

package/dist/core/document.d.ts

@@ -0,0 +1,135 @@
+/**
+ * create-markdown - Document Management
+ * Create and manipulate document structures
+ */
+import type { Block, BlockType, Document, DocumentMeta, DocumentOptions, TextSpan } from '../types';
+/**
+ * Current document schema version
+ */
+export declare const DOCUMENT_VERSION = 1;
+/**
+ * Creates: new document with optional initial blocks and metadata
+ */
+export declare function createDocument(blocks?: Block[], options?: DocumentOptions): Document;
+/**
+ * Creates: empty document
+ */
+export declare function emptyDocument(options?: DocumentOptions): Document;
+/**
+ * Clones: document with new IDs for all blocks
+ */
+export declare function cloneDocument(doc: Document): Document;
+/**
+ * Inserts: block at the specified index
+ * If index is not provided, appends to the end
+ */
+export declare function insertBlock(doc: Document, block: Block, index?: number): Document;
+/**
+ * Appends: block to the end of the document
+ */
+export declare function appendBlock(doc: Document, block: Block): Document;
+/**
+ * Prepends: block to the beginning of the document
+ */
+export declare function prependBlock(doc: Document, block: Block): Document;
+/**
+ * Inserts: multiple blocks at the specified index
+ */
+export declare function insertBlocks(doc: Document, blocks: Block[], index?: number): Document;
+/**
+ * Removes: block by its ID
+ */
+export declare function removeBlock(doc: Document, blockId: string): Document;
+/**
+ * Removes: multiple blocks by their IDs
+ */
+export declare function removeBlocks(doc: Document, blockIds: string[]): Document;
+/**
+ * Updates: block by its ID with partial updates
+ */
+export declare function updateBlock<T extends BlockType>(doc: Document, blockId: string, updates: Partial<Omit<Block<T>, 'id' | 'type'>>): Document;
+/**
+ * Replaces: block entirely by its ID
+ */
+export declare function replaceBlock(doc: Document, blockId: string, newBlock: Block): Document;
+/**
+ * Moves: block to a new position
+ */
+export declare function moveBlock(doc: Document, blockId: string, newIndex: number): Document;
+/**
+ * Swaps: two blocks by their IDs
+ */
+export declare function swapBlocks(doc: Document, blockId1: string, blockId2: string): Document;
+/**
+ * Finds: block by its ID
+ */
+export declare function findBlock(doc: Document, blockId: string): Block | undefined;
+/**
+ * Finds: index of a block by its ID
+ */
+export declare function getBlockIndex(doc: Document, blockId: string): number;
+/**
+ * Gets: block at the specified index
+ */
+export declare function getBlockAt(doc: Document, index: number): Block | undefined;
+/**
+ * Gets: first block in the document
+ */
+export declare function getFirstBlock(doc: Document): Block | undefined;
+/**
+ * Gets: last block in the document
+ */
+export declare function getLastBlock(doc: Document): Block | undefined;
+/**
+ * Finds: all blocks of a specific type
+ */
+export declare function findBlocksByType<T extends BlockType>(doc: Document, type: T): Block<T>[];
+/**
+ * Checks: if the document contains a block with the given ID
+ */
+export declare function hasBlock(doc: Document, blockId: string): boolean;
+/**
+ * Gets: total number of blocks in the document
+ */
+export declare function getBlockCount(doc: Document): number;
+/**
+ * Checks: if the document is empty
+ */
+export declare function isEmpty(doc: Document): boolean;
+/**
+ * Updates: content of a specific block
+ */
+export declare function setBlockContent(doc: Document, blockId: string, content: TextSpan[]): Document;
+/**
+ * Appends: content to a specific block
+ */
+export declare function appendBlockContent(doc: Document, blockId: string, content: TextSpan[]): Document;
+/**
+ * Updates: document metadata
+ */
+export declare function updateMeta(doc: Document, meta: Partial<DocumentMeta>): Document;
+/**
+ * Sets: specific metadata field
+ */
+export declare function setMetaField(doc: Document, key: string, value: unknown): Document;
+/**
+ * Gets: specific metadata field
+ */
+export declare function getMetaField<T = unknown>(doc: Document, key: string): T | undefined;
+/**
+ * Clears: all blocks from the document
+ */
+export declare function clearBlocks(doc: Document): Document;
+/**
+ * Replaces: all blocks in the document
+ */
+export declare function setBlocks(doc: Document, blocks: Block[]): Document;
+/**
+ * Filters: blocks based on a predicate
+ */
+export declare function filterBlocks(doc: Document, predicate: (block: Block, index: number) => boolean): Document;
+/**
+ * Maps: over all blocks and transforms them
+ */
+export declare function mapBlocks(doc: Document, transform: (block: Block, index: number) => Block): Document;
+//# sourceMappingURL=document.d.ts.map

package/dist/core/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/core/document.ts"],"names":[],"mappings":"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"}

package/dist/core/utils.d.ts

@@ -0,0 +1,80 @@
+/**
+ * create-markdown - Utility Functions
+ * Core utilities for block manipulation and markdown handling
+ */
+import type { Block, BlockType, TextSpan } from '../types';
+/**
+ * Generates a unique ID for blocks
+ * Nano ID-style implementation without dependencies
+ */
+export declare function generateId(length?: number): string;
+/**
+ * Deep clones a block and all its children
+ * Generates new IDs for cloned blocks to ensure uniqueness
+ */
+export declare function deepClone<T extends BlockType>(block: Block<T>, regenerateIds?: boolean): Block<T>;
+/**
+ * Deep clones an array of blocks
+ */
+export declare function deepCloneBlocks(blocks: Block[], regenerateIds?: boolean): Block[];
+/**
+ * Normalizes line endings to LF (\n)
+ */
+export declare function normalizeLineEndings(text: string): string;
+/**
+ * Converts line endings to the specified format
+ */
+export declare function convertLineEndings(text: string, lineEnding: '\n' | '\r\n'): string;
+/**
+ * Escapes special markdown characters in text
+ */
+export declare function escapeMarkdown(text: string): string;
+/**
+ * Unescapes markdown escape sequences
+ */
+export declare function unescapeMarkdown(text: string): string;
+/**
+ * Escapes text for use inside code blocks (minimal escaping)
+ */
+export declare function escapeCodeBlock(text: string): string;
+/**
+ * Trims trailing whitespace from each line
+ */
+export declare function trimTrailingWhitespace(text: string): string;
+/**
+ * Removes leading/trailing blank lines
+ */
+export declare function trimBlankLines(text: string): string;
+/**
+ * Indents each line of text by the specified number of spaces
+ */
+export declare function indent(text: string, spaces: number): string;
+/**
+ * Extracts plain text from an array of text spans
+ */
+export declare function spansToPlainText(spans: TextSpan[]): string;
+/**
+ * Creates a simple text span with no styles
+ */
+export declare function plainSpan(text: string): TextSpan;
+/**
+ * Creates an array with a single plain text span
+ */
+export declare function plainContent(text: string): TextSpan[];
+/**
+ * Checks if a block has any content
+ */
+export declare function hasContent(block: Block): boolean;
+/**
+ * Checks if a block has children
+ */
+export declare function hasChildren(block: Block): boolean;
+/**
+ * Validates a heading level
+ */
+export declare function isValidHeadingLevel(level: number): level is 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Validates a block type
+ */
+export declare function isValidBlockType(type: string): type is BlockType;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAY3D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAkB,GAAG,MAAM,CAS7D;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,EAC3C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,aAAa,GAAE,OAAc,GAC5B,KAAK,CAAC,CAAC,CAAC,CAWV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,GAAE,OAAc,GAC5B,KAAK,EAAE,CAET;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,IAAI,GAAG,MAAM,GACxB,MAAM,CAMR;AAWD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBnD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM3D;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAKhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEjD;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAehE"}