@elytracms/core 0.0.6

package/dist/rich-text/markdown.js

@@ -0,0 +1,235 @@
+/**
+ * Lossy Markdown import/export helpers (brief §7.6).
+ *
+ * Supports the common CommonMark-ish subset: ATX headings, paragraphs, bullet and
+ * ordered lists, blockquotes, fenced code blocks, horizontal rules, plus inline
+ * bold/italic/code and links. Anything outside this subset is dropped on export
+ * and treated as plain text on import — lossy by design. No external Markdown
+ * library is required, keeping the spike dependency-free and server-safe.
+ */
+function attrStr(node, name) {
+    const v = node.attrs?.[name];
+    return typeof v === 'string' ? v : undefined;
+}
+// ---------------------------------------------------------------------------
+// Export: storage tree → Markdown
+// ---------------------------------------------------------------------------
+function hasMark(node, type) {
+    return node.marks?.find((m) => m.type === type);
+}
+function inlineToMd(nodes) {
+    return (nodes ?? [])
+        .map((node) => {
+        if (node.type === 'hardBreak')
+            return '\n';
+        if (node.type !== 'text')
+            return inlineToMd(node.content);
+        let text = node.text ?? '';
+        if (hasMark(node, 'code'))
+            text = `\`${text}\``;
+        if (hasMark(node, 'bold'))
+            text = `**${text}**`;
+        if (hasMark(node, 'italic'))
+            text = `*${text}*`;
+        const link = hasMark(node, 'link');
+        if (link) {
+            const href = typeof link.attrs?.href === 'string' ? link.attrs.href : '';
+            text = `[${text}](${href})`;
+        }
+        return text;
+    })
+        .join('');
+}
+function listToMd(node, ordered) {
+    return (node.content ?? [])
+        .map((item, i) => {
+        const marker = ordered ? `${i + 1}.` : '-';
+        const body = (item.content ?? [])
+            .map((child) => (child.type === 'paragraph' ? inlineToMd(child.content) : nodeToMd(child)))
+            .join(' ');
+        return `${marker} ${body}`;
+    })
+        .join('\n');
+}
+function nodeToMd(node) {
+    switch (node.type) {
+        case 'paragraph':
+            return inlineToMd(node.content);
+        case 'heading': {
+            const level = typeof node.attrs?.level === 'number' ? node.attrs.level : 1;
+            const l = Math.min(Math.max(level, 1), 6);
+            return `${'#'.repeat(l)} ${inlineToMd(node.content)}`;
+        }
+        case 'bulletList':
+            return listToMd(node, false);
+        case 'orderedList':
+            return listToMd(node, true);
+        case 'blockquote':
+            return (node.content ?? [])
+                .map((child) => nodeToMd(child))
+                .join('\n')
+                .split('\n')
+                .map((line) => `> ${line}`)
+                .join('\n');
+        case 'codeBlock': {
+            const language = attrStr(node, 'language') ?? '';
+            const text = (node.content ?? []).map((c) => c.text ?? '').join('');
+            return `\`\`\`${language}\n${text}\n\`\`\``;
+        }
+        case 'horizontalRule':
+            return '---';
+        case 'image': {
+            const src = attrStr(node, 'src') ?? '';
+            const alt = attrStr(node, 'alt') ?? '';
+            return `![${alt}](${src})`;
+        }
+        default:
+            // Lossy: unknown/custom blocks have no Markdown form — drop them.
+            return '';
+    }
+}
+/** Serialize a document to a lossy Markdown string. */
+export function richTextToMarkdown(doc) {
+    return doc.content
+        .map(nodeToMd)
+        .filter((block) => block.length > 0)
+        .join('\n\n');
+}
+// ---------------------------------------------------------------------------
+// Import: Markdown → storage tree
+// ---------------------------------------------------------------------------
+/** Parse inline Markdown (bold/italic/code/link) into text nodes. Lossy. */
+export function parseInlineMarkdown(text) {
+    const nodes = [];
+    // Token regex, ordered so code spans win over emphasis inside them.
+    const re = /(`[^`]+`)|(\*\*[^*]+\*\*)|(\*[^*]+\*)|(\[[^\]]+\]\([^)]*\))/g;
+    let last = 0;
+    let m;
+    const pushText = (raw, marks) => {
+        if (raw.length === 0)
+            return;
+        nodes.push(marks.length > 0 ? { type: 'text', text: raw, marks } : { type: 'text', text: raw });
+    };
+    while ((m = re.exec(text)) !== null) {
+        if (m.index > last)
+            pushText(text.slice(last, m.index), []);
+        last = re.lastIndex;
+        const token = m[0];
+        if (token.startsWith('`')) {
+            pushText(token.slice(1, -1), [{ type: 'code' }]);
+        }
+        else if (token.startsWith('**')) {
+            pushText(token.slice(2, -2), [{ type: 'bold' }]);
+        }
+        else if (token.startsWith('*')) {
+            pushText(token.slice(1, -1), [{ type: 'italic' }]);
+        }
+        else if (token.startsWith('[')) {
+            const linkMatch = /^\[([^\]]+)\]\(([^)]*)\)$/.exec(token);
+            if (linkMatch) {
+                const label = linkMatch[1] ?? '';
+                const href = linkMatch[2] ?? '';
+                pushText(label, [{ type: 'link', attrs: { href } }]);
+            }
+        }
+    }
+    if (last < text.length)
+        pushText(text.slice(last), []);
+    return nodes;
+}
+function isOrderedItem(line) {
+    return /^\s*\d+\.\s+/.test(line);
+}
+function isBulletItem(line) {
+    return /^\s*[-*+]\s+/.test(line);
+}
+/** Parse a lossy Markdown string into a document tree. */
+export function markdownToRichText(markdown) {
+    const lines = markdown.replace(/\r\n/g, '\n').split('\n');
+    const content = [];
+    let i = 0;
+    const flushParagraph = (buffer) => {
+        if (buffer.length === 0)
+            return;
+        const text = buffer.join(' ').trim();
+        if (text.length > 0)
+            content.push({ type: 'paragraph', content: parseInlineMarkdown(text) });
+        buffer.length = 0;
+    };
+    const paragraph = [];
+    while (i < lines.length) {
+        const line = lines[i] ?? '';
+        const trimmed = line.trim();
+        // Fenced code block.
+        const fence = /^```(\w*)\s*$/.exec(trimmed);
+        if (fence) {
+            flushParagraph(paragraph);
+            const language = fence[1] ?? '';
+            const codeLines = [];
+            i++;
+            while (i < lines.length && !/^```\s*$/.test((lines[i] ?? '').trim())) {
+                codeLines.push(lines[i] ?? '');
+                i++;
+            }
+            i++; // skip closing fence
+            content.push({
+                type: 'codeBlock',
+                ...(language ? { attrs: { language } } : {}),
+                content: codeLines.length > 0 ? [{ type: 'text', text: codeLines.join('\n') }] : [],
+            });
+            continue;
+        }
+        // Blank line ends a paragraph.
+        if (trimmed.length === 0) {
+            flushParagraph(paragraph);
+            i++;
+            continue;
+        }
+        // Horizontal rule.
+        if (/^(-{3,}|\*{3,}|_{3,})$/.test(trimmed)) {
+            flushParagraph(paragraph);
+            content.push({ type: 'horizontalRule' });
+            i++;
+            continue;
+        }
+        // ATX heading.
+        const heading = /^(#{1,6})\s+(.*)$/.exec(trimmed);
+        if (heading) {
+            flushParagraph(paragraph);
+            const level = heading[1]?.length ?? 1;
+            content.push({ type: 'heading', attrs: { level }, content: parseInlineMarkdown(heading[2] ?? '') });
+            i++;
+            continue;
+        }
+        // Blockquote (consume consecutive `>` lines).
+        if (/^>\s?/.test(trimmed)) {
+            flushParagraph(paragraph);
+            const quoteLines = [];
+            while (i < lines.length && /^\s*>\s?/.test(lines[i] ?? '')) {
+                quoteLines.push((lines[i] ?? '').replace(/^\s*>\s?/, ''));
+                i++;
+            }
+            content.push({ type: 'blockquote', content: [{ type: 'paragraph', content: parseInlineMarkdown(quoteLines.join(' ').trim()) }] });
+            continue;
+        }
+        // Lists (consume consecutive items of the same kind).
+        if (isBulletItem(line) || isOrderedItem(line)) {
+            flushParagraph(paragraph);
+            const ordered = isOrderedItem(line);
+            const items = [];
+            while (i < lines.length && (ordered ? isOrderedItem(lines[i] ?? '') : isBulletItem(lines[i] ?? ''))) {
+                const itemText = (lines[i] ?? '').replace(ordered ? /^\s*\d+\.\s+/ : /^\s*[-*+]\s+/, '');
+                items.push({ type: 'listItem', content: [{ type: 'paragraph', content: parseInlineMarkdown(itemText) }] });
+                i++;
+            }
+            content.push({ type: ordered ? 'orderedList' : 'bulletList', content: items });
+            continue;
+        }
+        // Otherwise accumulate into the current paragraph.
+        paragraph.push(trimmed);
+        i++;
+    }
+    flushParagraph(paragraph);
+    return { type: 'doc', content };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/rich-text/markdown.js.map

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

package/dist/rich-text/portable-text.d.ts

@@ -0,0 +1,50 @@
+import type { RichTextValue } from './schema';
+/**
+ * Sanity **Portable Text → TipTap richText** migration transform (EC-229).
+ *
+ * Both real migration targets store long-form content as Portable Text
+ * (Naturkinder's `freeform` block, Konditorei's `richTextSection.content`). This
+ * is the one reusable piece of migration tooling both sites need — written once,
+ * as a pure, dependency-free, never-throwing transform that lives next to the
+ * storage format it produces (`./schema`).
+ *
+ * What it maps:
+ * - block `style` → node: `normal`→`paragraph`, `h1..h6`→`heading{level}`,
+ *   `blockquote`→`blockquote`(wrapping a paragraph). Unknown styles fall back to
+ *   a paragraph **with a flagged issue** (text preserved, never lost).
+ * - span decorators → marks: `strong`→`bold`, `em`→`italic`, `code`→`code`,
+ *   `underline`→`underline`, `strike-through`→`strike`.
+ * - span annotation keys → marks via the block's `markDefs`: a `link` def →
+ *   a `link` mark (`href`, `target` when the def is `blank`).
+ * - `listItem`/`level` blocks → nested `bulletList`/`orderedList`/`listItem`.
+ *
+ * What it deliberately does NOT map (flagged, never silently dropped):
+ * - Embedded **object blocks** (`_type` other than `block`: images, custom
+ *   sections, references). Resolving a Sanity image needs asset dereferencing,
+ *   and custom sections need per-site component mapping — neither is a pure text
+ *   transform. Each becomes an `unmapped-block-type` issue so the site-specific
+ *   migration can handle it (assets pipeline / component mapping).
+ * - Unknown decorators / annotation types → `unmapped-mark` issues; the text is
+ *   always kept, only the mark is dropped.
+ *
+ * The contract is "never a silent loss": anything the transform can't represent
+ * surfaces as a structured {@link PortableTextIssue}, mirroring how the rest of
+ * the system treats unmappable content as a visible validation issue.
+ */
+/** A structured, non-fatal problem encountered while transforming Portable Text. */
+export interface PortableTextIssue {
+    code: 'unmapped-block-type' | 'unmapped-block-style' | 'unmapped-mark' | 'malformed';
+    message: string;
+    /** Location in the input, e.g. `[3]` or `[3, 'children', 1]`. */
+    path: (string | number)[];
+}
+/** Result of {@link portableTextToRichText}: the value plus any issues. */
+export interface PortableTextResult {
+    value: RichTextValue;
+    issues: PortableTextIssue[];
+}
+/**
+ * Transform Sanity Portable Text into a versioned {@link RichTextValue}. Pure and
+ * total — never throws; unmappable content surfaces as {@link PortableTextIssue}s.
+ */
+export declare function portableTextToRichText(input: unknown): PortableTextResult;

package/dist/rich-text/portable-text.js

@@ -0,0 +1,223 @@
+import { createRichTextValue } from './schema';
+/** Sanity decorator name → TipTap mark type. */
+const DECORATOR_TO_MARK = {
+    strong: 'bold',
+    em: 'italic',
+    code: 'code',
+    underline: 'underline',
+    'strike-through': 'strike',
+};
+/** Heading-style block `style` → heading level. */
+const HEADING_LEVELS = {
+    h1: 1,
+    h2: 2,
+    h3: 3,
+    h4: 4,
+    h5: 5,
+    h6: 6,
+};
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** Resolve a span's `marks` (decorators + annotation keys) to TipTap marks. */
+function resolveMarks(raw, markDefs, path, issues) {
+    if (!Array.isArray(raw))
+        return [];
+    const marks = [];
+    for (const entry of raw) {
+        if (typeof entry !== 'string')
+            continue;
+        const decorator = DECORATOR_TO_MARK[entry];
+        if (decorator) {
+            marks.push({ type: decorator });
+            continue;
+        }
+        // Not a known decorator → an annotation key referencing a markDef.
+        const def = markDefs.find((candidate) => isObject(candidate) && candidate['_key'] === entry);
+        if (isObject(def)) {
+            const mark = annotationToMark(def);
+            if (mark) {
+                marks.push(mark);
+                continue;
+            }
+            issues.push({
+                code: 'unmapped-mark',
+                message: `Annotation "${str(def['_type']) ?? '(missing _type)'}" (${entry}) has no mark mapping; dropped (text kept).`,
+                path,
+            });
+            continue;
+        }
+        issues.push({
+            code: 'unmapped-mark',
+            message: `Unknown mark "${entry}"; dropped (text kept).`,
+            path,
+        });
+    }
+    return marks;
+}
+/** Map a Portable Text annotation (markDef) to a TipTap mark, or null if unmapped. */
+function annotationToMark(def) {
+    if (str(def['_type']) === 'link') {
+        const href = str(def['href']) ?? '';
+        const attrs = { href };
+        if (def['blank'] === true || str(def['target']) === '_blank')
+            attrs['target'] = '_blank';
+        return { type: 'link', attrs };
+    }
+    return null;
+}
+/** Convert a `block`'s `children` spans into inline text nodes. */
+function inlineChildren(block, index, issues) {
+    const children = block['children'];
+    if (!Array.isArray(children))
+        return [];
+    const markDefs = Array.isArray(block['markDefs']) ? block['markDefs'] : [];
+    const nodes = [];
+    children.forEach((span, si) => {
+        if (!isObject(span))
+            return;
+        if (str(span['_type']) !== 'span') {
+            issues.push({
+                code: 'unmapped-block-type',
+                message: `Inline "${str(span['_type']) ?? '(missing _type)'}" has no rich-text mapping; dropped.`,
+                path: [index, 'children', si],
+            });
+            return;
+        }
+        // ProseMirror text nodes must be non-empty.
+        const text = typeof span['text'] === 'string' ? span['text'] : '';
+        if (text.length === 0)
+            return;
+        const marks = resolveMarks(span['marks'], markDefs, [index, 'children', si], issues);
+        nodes.push(marks.length > 0 ? { type: 'text', text, marks } : { type: 'text', text });
+    });
+    return nodes;
+}
+/** Convert a single non-list Portable Text block to a node, or null if dropped. */
+function convertBlock(block, index, issues) {
+    if (str(block['_type']) !== 'block') {
+        issues.push({
+            code: 'unmapped-block-type',
+            message: `Embedded block "${str(block['_type']) ?? '(missing _type)'}" has no rich-text mapping; dropped. Handle it in site-specific migration (asset/component).`,
+            path: [index],
+        });
+        return null;
+    }
+    const content = inlineChildren(block, index, issues);
+    const style = str(block['style']) ?? 'normal';
+    if (style === 'normal')
+        return { type: 'paragraph', content };
+    if (style === 'blockquote') {
+        return { type: 'blockquote', content: [{ type: 'paragraph', content }] };
+    }
+    const level = HEADING_LEVELS[style];
+    if (level)
+        return { type: 'heading', attrs: { level }, content };
+    issues.push({
+        code: 'unmapped-block-style',
+        message: `Unknown block style "${style}"; rendered as a paragraph (text kept).`,
+        path: [index, 'style'],
+    });
+    return { type: 'paragraph', content };
+}
+function listTypeFor(listItem) {
+    return listItem === 'number' ? 'orderedList' : 'bulletList';
+}
+function itemsOf(node) {
+    if (!node.content)
+        node.content = [];
+    return node.content;
+}
+/**
+ * Build nested lists from a run of consecutive `listItem` blocks. Sanity encodes
+ * nesting with a 1-based `level`; a deeper level nests inside the previous item,
+ * and a different `listItem` kind at the same level starts a sibling list.
+ */
+function buildLists(run, issues) {
+    const roots = [];
+    const stack = [];
+    for (const { block, index } of run) {
+        const listItem = str(block['listItem']) ?? 'bullet';
+        const rawLevel = block['level'];
+        const level = typeof rawLevel === 'number' && rawLevel >= 1 ? Math.floor(rawLevel) : 1;
+        const itemNode = {
+            type: 'listItem',
+            content: [{ type: 'paragraph', content: inlineChildren(block, index, issues) }],
+        };
+        // Close any lists deeper than this item.
+        while (stack.length > 0 && stack[stack.length - 1].level > level)
+            stack.pop();
+        let top = stack[stack.length - 1];
+        // Same depth but a different list kind → close it and open a sibling.
+        if (top && top.level === level && top.listItem !== listItem) {
+            stack.pop();
+            top = stack[stack.length - 1];
+        }
+        if (top && top.level === level) {
+            itemsOf(top.node).push(itemNode);
+            continue;
+        }
+        // Open a new list at this level — nested in the parent's last item, or a root.
+        const listNode = { type: listTypeFor(listItem), content: [itemNode] };
+        if (top && top.level < level) {
+            const parentItems = itemsOf(top.node);
+            const lastItem = parentItems[parentItems.length - 1];
+            if (lastItem)
+                itemsOf(lastItem).push(listNode);
+            else
+                parentItems.push({ type: 'listItem', content: [listNode] });
+        }
+        else {
+            roots.push(listNode);
+        }
+        stack.push({ level, listItem, node: listNode });
+    }
+    return roots;
+}
+/**
+ * Transform Sanity Portable Text into a versioned {@link RichTextValue}. Pure and
+ * total — never throws; unmappable content surfaces as {@link PortableTextIssue}s.
+ */
+export function portableTextToRichText(input) {
+    const issues = [];
+    const content = [];
+    // A nullish field is empty content, not an error.
+    if (input === null || input === undefined) {
+        return { value: createRichTextValue({ type: 'doc', content }), issues };
+    }
+    if (!Array.isArray(input)) {
+        issues.push({ code: 'malformed', message: 'Portable Text must be an array of blocks.', path: [] });
+        return { value: createRichTextValue({ type: 'doc', content }), issues };
+    }
+    let i = 0;
+    while (i < input.length) {
+        const block = input[i];
+        if (!isObject(block)) {
+            issues.push({ code: 'malformed', message: `Block at index ${i} is not an object; skipped.`, path: [i] });
+            i++;
+            continue;
+        }
+        // Group a run of consecutive list blocks into nested lists.
+        if (str(block['_type']) === 'block' && str(block['listItem'])) {
+            const run = [];
+            while (i < input.length) {
+                const next = input[i];
+                if (!isObject(next) || str(next['_type']) !== 'block' || !str(next['listItem']))
+                    break;
+                run.push({ block: next, index: i });
+                i++;
+            }
+            content.push(...buildLists(run, issues));
+            continue;
+        }
+        const node = convertBlock(block, i, issues);
+        if (node)
+            content.push(node);
+        i++;
+    }
+    return { value: createRichTextValue({ type: 'doc', content }), issues };
+}
+//# sourceMappingURL=portable-text.js.map

package/dist/rich-text/portable-text.js.map

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

package/dist/rich-text/registry.d.ts

@@ -0,0 +1,48 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { RichTextNode } from './schema';
+/**
+ * Registration hooks for rendering custom rich-text nodes (brief §7.6).
+ *
+ * Two flavours, mirroring TipTap's node groups:
+ * - **block** components — full-width blocks (e.g. a callout, a CTA card) that the
+ *   builder surfaces from the component registry as custom blocks.
+ * - **inline** components — mentions, badges, tokens, and data references that sit
+ *   inside a paragraph alongside text.
+ *
+ * The renderer (see `render.tsx`) is server-safe and only knows the *shape* of a
+ * registry, not where it comes from. Consumers build a registry from their own
+ * component manifests and pass it in, keeping the renderer decoupled from the
+ * project's component registry package.
+ */
+/** Props handed to a custom node renderer. */
+export interface CustomNodeRenderProps {
+    /** The raw storage node, so the component can read its `attrs`. */
+    node: RichTextNode;
+    /**
+     * Already-rendered children (present for block components with inline/leaf
+     * content). Inline atoms typically ignore this.
+     */
+    children?: ReactNode;
+}
+export type CustomNodeRenderer = (props: CustomNodeRenderProps) => ReactElement | null;
+export interface CustomNodeDefinition {
+    /** The storage `node.type` this renderer handles, e.g. `callout` or `mention`. */
+    type: string;
+    group: 'block' | 'inline';
+    render: CustomNodeRenderer;
+}
+/**
+ * A read-only registry of custom node renderers. Look-ups are keyed by storage
+ * `node.type`; the renderer falls back to a visible placeholder when a type is not
+ * registered and is not a built-in.
+ */
+export interface RichTextRegistry {
+    has(type: string): boolean;
+    get(type: string): CustomNodeDefinition | undefined;
+    /** Whether a registered custom node renders inline (vs. as a block). */
+    isInline(type: string): boolean;
+}
+/** Build an immutable {@link RichTextRegistry} from a list of definitions. */
+export declare function createRichTextRegistry(definitions?: readonly CustomNodeDefinition[]): RichTextRegistry;
+/** An empty registry — convenient default for callers with no custom blocks. */
+export declare const emptyRichTextRegistry: RichTextRegistry;

package/dist/rich-text/registry.js

@@ -0,0 +1,16 @@
+/** Build an immutable {@link RichTextRegistry} from a list of definitions. */
+export function createRichTextRegistry(definitions = []) {
+    const byType = new Map();
+    for (const def of definitions) {
+        // Last registration wins, matching how a builder would override a block.
+        byType.set(def.type, def);
+    }
+    return {
+        has: (type) => byType.has(type),
+        get: (type) => byType.get(type),
+        isInline: (type) => byType.get(type)?.group === 'inline',
+    };
+}
+/** An empty registry — convenient default for callers with no custom blocks. */
+export const emptyRichTextRegistry = createRichTextRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/rich-text/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/rich-text/registry.tsx"],"names":[],"mappings":"AAkDA,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CACpC,cAA+C,EAAE;IAEjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAA;IACtD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,yEAAyE;QACzE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,QAAQ;KACzD,CAAA;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAqB,sBAAsB,EAAE,CAAA"}