@se-studio/contentful-cms 1.0.15 → 1.0.17

package/dist/rtf/replacePlainText.js

@@ -0,0 +1,455 @@
+import { BLOCKS } from '@contentful/rich-text-types';
+import { markdownToRtfInlines } from './fromMarkdown.js';
+import { isRtfDocument } from './utils.js';
+export class RichTextReplaceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RichTextReplaceError';
+    }
+}
+function plainToInlines(plain) {
+    const node = { nodeType: 'text', value: plain, marks: [], data: {} };
+    return [node];
+}
+function resolveReplacementInlines(options) {
+    const { replaceMarkdown, replacePlain } = options;
+    if (replacePlain !== undefined && replaceMarkdown !== undefined) {
+        throw new RichTextReplaceError('Provide either replacePlain or replaceMarkdown, not both');
+    }
+    if (replacePlain !== undefined) {
+        if (replacePlain.includes('\n') || replacePlain.includes('\r')) {
+            throw new RichTextReplaceError('replacePlain must not contain line breaks (inline only)');
+        }
+        return plainToInlines(replacePlain);
+    }
+    if (replaceMarkdown === undefined || replaceMarkdown === '') {
+        throw new RichTextReplaceError('Provide replacePlain or replaceMarkdown');
+    }
+    if (replaceMarkdown.includes('\n') || replaceMarkdown.includes('\r')) {
+        throw new RichTextReplaceError('replaceMarkdown must not contain line breaks (inline only)');
+    }
+    return markdownToRtfInlines(replaceMarkdown);
+}
+// ---------------------------------------------------------------------------
+// Quidget span protection (FR-1)
+// ---------------------------------------------------------------------------
+/**
+ * Returns the [start, end) ranges of all top-level `{*...*}` quidget spans in `str`.
+ * Only non-nested spans (no inner braces) are matched. Used to prevent search matches
+ * from landing inside an already-inserted quidget token.
+ */
+function getQuidgetSpans(str) {
+    const spans = [];
+    const re = /\{\*[^{}]*\*\}/g;
+    for (;;) {
+        const m = re.exec(str);
+        if (m === null)
+            break;
+        spans.push([m.index, m.index + m[0].length]);
+    }
+    return spans;
+}
+/**
+ * Returns true if the range [matchStart, matchEnd) is strictly contained inside any protected
+ * span — i.e. it starts AFTER the span start. This allows searching for a full quidget token
+ * itself (matchStart === spanStart is not protected) while blocking matches for shorter strings
+ * that land inside an existing quidget.
+ */
+function isInsideAnySpan(matchStart, matchEnd, spans) {
+    for (const [s, e] of spans) {
+        if (matchStart > s && matchEnd <= e)
+            return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Section filtering helpers
+// ---------------------------------------------------------------------------
+const HEADING_LEVEL_MAP = {
+    [BLOCKS.HEADING_1]: 1,
+    [BLOCKS.HEADING_2]: 2,
+    [BLOCKS.HEADING_3]: 3,
+    [BLOCKS.HEADING_4]: 4,
+    [BLOCKS.HEADING_5]: 5,
+    [BLOCKS.HEADING_6]: 6,
+};
+function isHeadingBlock(block) {
+    return block.nodeType in HEADING_LEVEL_MAP;
+}
+function getHeadingLevel(block) {
+    return HEADING_LEVEL_MAP[block.nodeType] ?? 0;
+}
+function extractBlockPlainText(block) {
+    const parts = [];
+    walkTextNodes(block.content, (_p, _i, t) => parts.push(t.value));
+    return parts.join('');
+}
+/**
+ * Returns a shallow Document view containing only the blocks within the named heading section.
+ * The section starts immediately after the matched heading and ends before the next heading of
+ * equal or higher level (i.e. lower or equal heading number).
+ *
+ * When multiple headings share the same text, `nth` (1-indexed, default 1) selects which to use.
+ * Throws {@link RichTextReplaceError} if the heading is not found or `nth` exceeds the count.
+ */
+function resolveSectionDoc(clone, section, nth = 1) {
+    const blocks = clone.content;
+    let matchCount = 0;
+    for (let i = 0; i < blocks.length; i++) {
+        const block = blocks[i];
+        if (!block || !isHeadingBlock(block))
+            continue;
+        if (extractBlockPlainText(block) !== section)
+            continue;
+        matchCount++;
+        if (matchCount < nth)
+            continue;
+        const level = getHeadingLevel(block);
+        let end = blocks.length;
+        for (let j = i + 1; j < blocks.length; j++) {
+            const b = blocks[j];
+            if (b && isHeadingBlock(b) && getHeadingLevel(b) <= level) {
+                end = j;
+                break;
+            }
+        }
+        // Shallow doc wrapping the same block objects — mutations via applyAllReplacements affect clone
+        return {
+            nodeType: BLOCKS.DOCUMENT,
+            data: {},
+            content: blocks.slice(i + 1, end),
+        };
+    }
+    if (matchCount === 0) {
+        throw new RichTextReplaceError(`No heading matching section "${section}" found in document`);
+    }
+    throw new RichTextReplaceError(`Section "${section}" has ${String(matchCount)} occurrence(s) but --section-nth ${String(nth)} was requested`);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Replaces plain-text occurrences in a Contentful rich-text document.
+ *
+ * **Matching:** By default, search runs only inside individual `text` node `value` strings.
+ * Use `ignoreMarks: true` to match across adjacent sibling text nodes in the same block
+ * (e.g. `**Annual fee: **$95` split by bold).
+ *
+ * **Quidget protection:** Matches that fall inside an existing `{*...*}` span are always
+ * skipped — this prevents nesting a new quidget inside an already-inserted one.
+ *
+ * **Modes:** `all` replaces every non-overlapping occurrence. `exactlyOne` requires exactly
+ * one occurrence in the entire document or throws {@link RichTextReplaceError}.
+ *
+ * @returns A deep-cloned document with replacements applied (input is not mutated).
+ */
+export function replaceRtfPlainText(document, options) {
+    if (!isRtfDocument(document)) {
+        throw new RichTextReplaceError('Value is not a rich text document');
+    }
+    const { find, mode, ignoreMarks, section, sectionNth } = options;
+    if (find === '') {
+        throw new RichTextReplaceError('find must be a non-empty string');
+    }
+    const replacement = resolveReplacementInlines(options);
+    const clone = structuredClone(document);
+    const targetDoc = section !== undefined ? resolveSectionDoc(clone, section, sectionNth) : clone;
+    const total = ignoreMarks
+        ? countOccurrencesIgnoreMarks(targetDoc, find, options.tableCol)
+        : countOccurrencesInDocument(targetDoc, find, options.tableCol);
+    if (mode === 'exactlyOne' && total !== 1) {
+        throw new RichTextReplaceError(total === 0
+            ? `No occurrence of find string in document`
+            : `Expected exactly one occurrence of find string, found ${String(total)}`);
+    }
+    if (total === 0) {
+        return { document: clone, matchCount: 0 };
+    }
+    if (ignoreMarks) {
+        applyAllReplacementsIgnoreMarks(targetDoc, find, replacement, options.tableCol);
+    }
+    else {
+        applyAllReplacements(targetDoc, find, replacement, options.tableCol);
+    }
+    return { document: clone, matchCount: total };
+}
+// ---------------------------------------------------------------------------
+// Block / inline root collection (FR-4: tableCol filtering)
+// ---------------------------------------------------------------------------
+function collectInlineRoots(doc, tableCol) {
+    const roots = [];
+    for (const block of doc.content) {
+        collectInlineRootsFromBlock(block, roots, tableCol);
+    }
+    return roots;
+}
+function collectInlineRootsFromBlock(block, roots, tableCol) {
+    switch (block.nodeType) {
+        case BLOCKS.PARAGRAPH:
+        case BLOCKS.HEADING_1:
+        case BLOCKS.HEADING_2:
+        case BLOCKS.HEADING_3:
+        case BLOCKS.HEADING_4:
+        case BLOCKS.HEADING_5:
+        case BLOCKS.HEADING_6:
+            roots.push(block.content);
+            break;
+        case BLOCKS.QUOTE:
+            for (const b of block.content) {
+                collectInlineRootsFromBlock(b, roots, tableCol);
+            }
+            break;
+        case BLOCKS.UL_LIST:
+        case BLOCKS.OL_LIST:
+            for (const item of block.content) {
+                collectInlineRootsFromBlock(item, roots, tableCol);
+            }
+            break;
+        case BLOCKS.LIST_ITEM:
+            for (const b of block.content) {
+                collectInlineRootsFromBlock(b, roots, tableCol);
+            }
+            break;
+        case BLOCKS.TABLE:
+            for (const row of block.content) {
+                if (row.nodeType !== BLOCKS.TABLE_ROW)
+                    continue;
+                const cells = row.content;
+                for (let colIdx = 0; colIdx < cells.length; colIdx++) {
+                    if (tableCol !== undefined && colIdx + 1 !== tableCol)
+                        continue;
+                    const cell = cells[colIdx];
+                    if (!cell)
+                        continue;
+                    for (const inner of cell.content) {
+                        collectInlineRootsFromBlock(inner, roots, tableCol);
+                    }
+                }
+            }
+            break;
+        default:
+            break;
+    }
+}
+// ---------------------------------------------------------------------------
+// Text node walking
+// ---------------------------------------------------------------------------
+export function walkTextNodes(inlines, fn) {
+    for (let i = 0; i < inlines.length; i++) {
+        const n = inlines[i];
+        if (!n)
+            continue;
+        if (n.nodeType === 'text') {
+            fn(inlines, i, n);
+        }
+        else {
+            const inl = n;
+            if ('content' in inl && Array.isArray(inl.content)) {
+                walkTextNodes(inl.content, fn);
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-text-node count & replace (default mode, FR-1 quidget protection)
+// ---------------------------------------------------------------------------
+function countOccurrencesInDocument(doc, find, tableCol) {
+    let n = 0;
+    for (const root of collectInlineRoots(doc, tableCol)) {
+        walkTextNodes(root, (_parent, _index, text) => {
+            n += countNonOverlappingInString(text.value, find);
+        });
+    }
+    return n;
+}
+function countNonOverlappingInString(haystack, needle) {
+    const spans = getQuidgetSpans(haystack);
+    let count = 0;
+    let pos = 0;
+    while (pos <= haystack.length - needle.length) {
+        const i = haystack.indexOf(needle, pos);
+        if (i === -1)
+            break;
+        if (isInsideAnySpan(i, i + needle.length, spans)) {
+            // Advance past the end of the span that contains this match
+            const containing = spans.find(([s, e]) => i > s && i + needle.length <= e);
+            pos = containing ? containing[1] : i + needle.length;
+            continue;
+        }
+        count++;
+        pos = i + needle.length;
+    }
+    return count;
+}
+function applyAllReplacements(doc, find, replacement, tableCol) {
+    const byParent = new Map();
+    for (const root of collectInlineRoots(doc, tableCol)) {
+        walkTextNodes(root, (parent, index, text) => {
+            if (countNonOverlappingInString(text.value, find) === 0)
+                return;
+            let list = byParent.get(parent);
+            if (!list) {
+                list = [];
+                byParent.set(parent, list);
+            }
+            list.push(index);
+        });
+    }
+    for (const [parent, indices] of byParent) {
+        const uniqueDesc = [...new Set(indices)].sort((a, b) => b - a);
+        for (const idx of uniqueDesc) {
+            replaceAllInTextNodeAt(parent, idx, find, replacement);
+        }
+    }
+}
+function replaceAllInTextNodeAt(parent, index, find, replacement) {
+    const node = parent[index];
+    const v = node.value;
+    const spans = getQuidgetSpans(v);
+    const matches = [];
+    let pos = 0;
+    while (pos <= v.length - find.length) {
+        const i = v.indexOf(find, pos);
+        if (i === -1)
+            break;
+        if (isInsideAnySpan(i, i + find.length, spans)) {
+            const containing = spans.find(([s, e]) => i > s && i + find.length <= e);
+            pos = containing ? containing[1] : i + find.length;
+            continue;
+        }
+        matches.push(i);
+        pos = i + find.length;
+    }
+    if (matches.length === 0)
+        return;
+    const out = [];
+    let cursor = 0;
+    for (const m of matches) {
+        if (m > cursor) {
+            out.push({ ...node, value: v.slice(cursor, m) });
+        }
+        out.push(...replacement.map(cloneInlineTree));
+        cursor = m + find.length;
+    }
+    if (cursor < v.length) {
+        out.push({ ...node, value: v.slice(cursor) });
+    }
+    parent.splice(index, 1, ...out);
+}
+/** Groups consecutive direct-child text nodes in `inlines` into runs (inline nodes break runs). */
+function collectDirectTextRuns(inlines) {
+    const runs = [];
+    let current = [];
+    let offset = 0;
+    const flush = () => {
+        if (current.length > 0) {
+            runs.push({
+                parent: inlines,
+                textNodes: current,
+                virtualStr: current.map((e) => e.node.value).join(''),
+            });
+            current = [];
+            offset = 0;
+        }
+    };
+    for (let i = 0; i < inlines.length; i++) {
+        const n = inlines[i];
+        if (!n)
+            continue;
+        if (n.nodeType === 'text') {
+            const start = offset;
+            offset += n.value.length;
+            current.push({ nodeIndex: i, node: n, startOffset: start, endOffset: offset });
+        }
+        else {
+            flush();
+        }
+    }
+    flush();
+    return runs;
+}
+function countOccurrencesIgnoreMarks(doc, find, tableCol) {
+    let n = 0;
+    for (const root of collectInlineRoots(doc, tableCol)) {
+        for (const run of collectDirectTextRuns(root)) {
+            n += countNonOverlappingInString(run.virtualStr, find);
+        }
+    }
+    return n;
+}
+function applyAllReplacementsIgnoreMarks(doc, find, replacement, tableCol) {
+    for (const root of collectInlineRoots(doc, tableCol)) {
+        // Collect runs fresh each pass (splices invalidate indices)
+        // Process one run at a time; within a run process matches in reverse order.
+        const runs = collectDirectTextRuns(root);
+        // Reverse so that splices at later positions don't shift earlier ones.
+        for (let ri = runs.length - 1; ri >= 0; ri--) {
+            const run = runs[ri];
+            if (!run)
+                continue;
+            const { virtualStr, textNodes, parent } = run;
+            const spans = getQuidgetSpans(virtualStr);
+            const matches = [];
+            let pos = 0;
+            while (pos <= virtualStr.length - find.length) {
+                const i = virtualStr.indexOf(find, pos);
+                if (i === -1)
+                    break;
+                if (isInsideAnySpan(i, i + find.length, spans)) {
+                    const containing = spans.find(([s, e]) => i > s && i + find.length <= e);
+                    pos = containing ? containing[1] : i + find.length;
+                    continue;
+                }
+                matches.push(i);
+                pos = i + find.length;
+            }
+            if (matches.length === 0)
+                continue;
+            // Apply in reverse so splices don't corrupt earlier match positions.
+            for (let mi = matches.length - 1; mi >= 0; mi--) {
+                const matchStart = matches[mi];
+                if (matchStart === undefined)
+                    continue;
+                const matchEnd = matchStart + find.length;
+                const involved = textNodes.filter((tn) => tn.startOffset < matchEnd && tn.endOffset > matchStart);
+                if (involved.length === 0)
+                    continue;
+                const first = involved[0];
+                const last = involved[involved.length - 1];
+                if (!first || !last)
+                    continue;
+                const out = [];
+                const prefixLen = matchStart - first.startOffset;
+                if (prefixLen > 0) {
+                    out.push({ ...first.node, value: first.node.value.slice(0, prefixLen) });
+                }
+                out.push(...replacement.map(cloneInlineTree));
+                const suffixStart = matchEnd - last.startOffset;
+                if (suffixStart < last.node.value.length) {
+                    out.push({ ...last.node, value: last.node.value.slice(suffixStart) });
+                }
+                parent.splice(first.nodeIndex, last.nodeIndex - first.nodeIndex + 1, ...out);
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Clone helpers
+// ---------------------------------------------------------------------------
+function cloneInlineTree(n) {
+    if (n.nodeType === 'text') {
+        return {
+            ...n,
+            marks: n.marks.map((m) => ({ ...m })),
+        };
+    }
+    const inl = n;
+    if (Array.isArray(inl.content)) {
+        return {
+            ...inl,
+            content: inl.content.map(cloneInlineTree),
+        };
+    }
+    return { ...inl };
+}
+//# sourceMappingURL=replacePlainText.js.map

package/dist/rtf/replacePlainText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replacePlainText.js","sourceRoot":"","sources":["../../src/rtf/replacePlainText.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAiDD,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,IAAI,GAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAmC;IACpE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAClD,IAAI,YAAY,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,oBAAoB,CAAC,0DAA0D,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,oBAAoB,CAAC,yDAAyD,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,IAAI,oBAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,oBAAoB,CAAC,4DAA4D,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,oBAAoB,CAAC,eAAe,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,MAAM,EAAE,GAAG,iBAAiB,CAAC;IAC7B,SAAS,CAAC;QACR,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM;QACtB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CACtB,UAAkB,EAClB,QAAgB,EAChB,KAA8B;IAE9B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,IAAI,UAAU,GAAG,CAAC,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,iBAAiB,GAAoC;IACzD,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IACrB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IACrB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IACrB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IACrB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IACrB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;CACtB,CAAC;AAEF,SAAS,cAAc,CAAC,KAAY;IAClC,OAAO,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,KAAY;IACnC,OAAO,iBAAiB,CAAC,KAAK,CAAC,QAAkB,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAY;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,aAAa,CAAC,KAAK,CAAC,OAA4B,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,GAAG,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAkB,CAAC;IACxC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/C,IAAI,qBAAqB,CAAC,KAAK,CAAC,KAAK,OAAO;YAAE,SAAS;QAEvD,UAAU,EAAE,CAAC;QACb,IAAI,UAAU,GAAG,GAAG;YAAE,SAAS;QAE/B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;gBAC1D,GAAG,GAAG,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;QACH,CAAC;QACD,gGAAgG;QAChG,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAwB;SACzD,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,oBAAoB,CAAC,gCAAgC,OAAO,qBAAqB,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,IAAI,oBAAoB,CAC5B,YAAY,OAAO,SAAS,MAAM,CAAC,UAAU,CAAC,oCAAoC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAC9G,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,OAAmC;IAEnC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,oBAAoB,CAAC,mCAAmC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACjE,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,oBAAoB,CAAC,iCAAiC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAa,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEhG,MAAM,KAAK,GAAG,WAAW;QACvB,CAAC,CAAC,2BAA2B,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;QAChE,CAAC,CAAC,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElE,IAAI,IAAI,KAAK,YAAY,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,oBAAoB,CAC5B,KAAK,KAAK,CAAC;YACT,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,yDAAyD,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7E,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,+BAA+B,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E,SAAS,kBAAkB,CAAC,GAAa,EAAE,QAAiB;IAC1D,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChC,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,2BAA2B,CAClC,KAAY,EACZ,KAA0B,EAC1B,QAAiB;IAEjB,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,SAAS,CAAC;QACtB,KAAK,MAAM,CAAC,SAAS,CAAC;QACtB,KAAK,MAAM,CAAC,SAAS,CAAC;QACtB,KAAK,MAAM,CAAC,SAAS,CAAC;QACtB,KAAK,MAAM,CAAC,SAAS,CAAC;QACtB,KAAK,MAAM,CAAC,SAAS,CAAC;QACtB,KAAK,MAAM,CAAC,SAAS;YACnB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAA4B,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,MAAM,CAAC,KAAK;YACf,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC9B,2BAA2B,CAAC,CAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM;QACR,KAAK,MAAM,CAAC,OAAO,CAAC;QACpB,KAAK,MAAM,CAAC,OAAO;YACjB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACjC,2BAA2B,CAAC,IAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM;QACR,KAAK,MAAM,CAAC,SAAS;YACnB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC9B,2BAA2B,CAAC,CAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM;QACR,KAAK,MAAM,CAAC,KAAK;YACf,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAK,GAAa,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS;oBAAE,SAAS;gBAC3D,MAAM,KAAK,GAAI,GAAa,CAAC,OAAO,CAAC;gBACrC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;oBACrD,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC,KAAK,QAAQ;wBAAE,SAAS;oBAChE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC3B,IAAI,CAAC,IAAI;wBAAE,SAAS;oBACpB,KAAK,MAAM,KAAK,IAAK,IAAc,CAAC,OAAO,EAAE,CAAC;wBAC5C,2BAA2B,CAAC,KAAc,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;YACD,MAAM;QACR;YACE,MAAM;IACV,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAC3B,OAA0B,EAC1B,EAAkE;IAElE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC1B,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,CAAW,CAAC;YACxB,IAAI,SAAS,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,aAAa,CAAC,GAAG,CAAC,OAA4B,EAAE,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAE9E,SAAS,0BAA0B,CAAC,GAAa,EAAE,IAAY,EAAE,QAAiB;IAChF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrD,aAAa,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC5C,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAgB,EAAE,MAAc;IACnE,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,MAAM;QACpB,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACjD,4DAA4D;YAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YAC3E,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACrD,SAAS;QACX,CAAC;QACD,KAAK,EAAE,CAAC;QACR,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAC3B,GAAa,EACb,IAAY,EACZ,WAA8B,EAC9B,QAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrD,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1C,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO;YAChE,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,EAAE,CAAC;gBACV,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAyB,EACzB,KAAa,EACb,IAAY,EACZ,WAA8B;IAE9B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAS,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IACrB,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,MAAM;QACpB,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YACzE,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACnD,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;AAClC,CAAC;AAmBD,mGAAmG;AACnG,SAAS,qBAAqB,CAAC,OAA0B;IACvD,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAoB,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC;gBACR,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,OAAO;gBAClB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;aACtD,CAAC,CAAC;YACH,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAa,EAAE,IAAY,EAAE,QAAiB;IACjF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrD,KAAK,MAAM,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,CAAC,IAAI,2BAA2B,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,+BAA+B,CACtC,GAAa,EACb,IAAY,EACZ,WAA8B,EAC9B,QAAiB;IAEjB,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrD,4DAA4D;QAC5D,4EAA4E;QAC5E,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACzC,uEAAuE;QACvE,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;YAC9C,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9C,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACxC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAAE,MAAM;gBACpB,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;oBACzE,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;oBACnD,SAAS;gBACX,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACxB,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEnC,qEAAqE;YACrE,KAAK,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;gBAChD,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC/B,IAAI,UAAU,KAAK,SAAS;oBAAE,SAAS;gBACvC,MAAM,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;gBAE1C,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAC/B,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,GAAG,QAAQ,IAAI,EAAE,CAAC,SAAS,GAAG,UAAU,CAC/D,CAAC;gBACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3C,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAE9B,MAAM,GAAG,GAAsB,EAAE,CAAC;gBAElC,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC;gBACjD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBAClB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC3E,CAAC;gBAED,GAAG,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;gBAE9C,MAAM,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC;gBAChD,IAAI,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACzC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACxE,CAAC;gBAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,eAAe,CAAC,CAAgB;IACvC,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO;YACL,GAAG,CAAC;YACJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SACtC,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,CAAW,CAAC;IACxB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,GAAG;YACN,OAAO,EAAG,GAAG,CAAC,OAA6B,CAAC,GAAG,CAAC,eAAe,CAAC;SACvD,CAAC;IACd,CAAC;IACD,OAAO,EAAE,GAAG,GAAG,EAAY,CAAC;AAC9B,CAAC"}

package/dist/session/backup.d.ts

@@ -0,0 +1,34 @@
+import type { SerializedEntry } from './state.js';
+export declare const BACKUPS_DIR: string;
+export interface BackupMeta {
+    version: 1;
+    createdAt: string;
+    label: string;
+    spaceKey: string;
+    spaceId: string;
+    environment: string;
+    defaultLocale: string;
+    rootEntryId: string;
+    rootSlug: string | null;
+    entryCount: number;
+}
+export interface BackupFile {
+    meta: BackupMeta;
+    entries: Record<string, SerializedEntry>;
+}
+export declare function generateBackupFilename(spaceKey: string, rootEntryId: string): string;
+/**
+ * Resolves a backup name/path to an absolute file path.
+ * - Bare filename (no path separators) → look in BACKUPS_DIR
+ * - Relative or absolute path → resolve from cwd
+ */
+export declare function resolveBackupPath(nameOrPath: string): string;
+export declare function writeBackup(backup: BackupFile, outputPath: string): void;
+export declare function readBackup(resolvedPath: string): BackupFile;
+export interface BackupListEntry {
+    filename: string;
+    filePath: string;
+    meta: BackupMeta;
+}
+export declare function listBackups(): BackupListEntry[];
+//# sourceMappingURL=backup.d.ts.map

package/dist/session/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/session/backup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,WAAW,QAAwD,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGxE;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAiB3D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAiB/C"}

package/dist/session/backup.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+export const BACKUPS_DIR = path.join(os.homedir(), '.contentful-cms', 'backups');
+export function generateBackupFilename(spaceKey, rootEntryId) {
+    const now = new Date();
+    const pad = (n, len = 2) => String(n).padStart(len, '0');
+    const timestamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
+        `-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    return `${spaceKey}-${rootEntryId}-${timestamp}.json`;
+}
+/**
+ * Resolves a backup name/path to an absolute file path.
+ * - Bare filename (no path separators) → look in BACKUPS_DIR
+ * - Relative or absolute path → resolve from cwd
+ */
+export function resolveBackupPath(nameOrPath) {
+    if (!nameOrPath.includes(path.sep) && !nameOrPath.includes('/')) {
+        return path.join(BACKUPS_DIR, nameOrPath);
+    }
+    return path.resolve(nameOrPath);
+}
+export function writeBackup(backup, outputPath) {
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, JSON.stringify(backup, null, 2), 'utf-8');
+}
+export function readBackup(resolvedPath) {
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Backup not found: ${resolvedPath}\nRun "cms-edit backup list" to see available backups.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(resolvedPath, 'utf-8'));
+    }
+    catch {
+        throw new Error(`Failed to parse backup file: ${resolvedPath}`);
+    }
+    const backup = parsed;
+    if (!backup?.meta || backup.meta.version !== 1 || typeof backup.entries !== 'object') {
+        throw new Error(`Invalid backup file format: ${resolvedPath}`);
+    }
+    return backup;
+}
+export function listBackups() {
+    if (!fs.existsSync(BACKUPS_DIR))
+        return [];
+    const files = fs.readdirSync(BACKUPS_DIR).filter((f) => f.endsWith('.json'));
+    const results = [];
+    for (const filename of files) {
+        const filePath = path.join(BACKUPS_DIR, filename);
+        try {
+            const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            if (parsed?.meta?.version === 1) {
+                results.push({ filename, filePath, meta: parsed.meta });
+            }
+        }
+        catch {
+            // skip corrupt files silently — caller may warn
+        }
+    }
+    // Sort newest-first by createdAt (ISO strings sort lexicographically)
+    return results.sort((a, b) => b.meta.createdAt.localeCompare(a.meta.createdAt));
+}
+//# sourceMappingURL=backup.js.map

package/dist/session/backup.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-cms",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "CLI tool for AI agents to read and edit Contentful draft content without publish permissions",
   "repository": {
     "type": "git",
@@ -33,7 +33,7 @@
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.7",
+    "@biomejs/biome": "^2.4.8",
     "@types/node": "^22.19.15",
     "typescript": "^5.9.3",
     "vitest": "^4.1.0"
@@ -56,6 +56,6 @@
     "type-check": "tsc --noEmit",
     "lint": "biome lint .",
     "clean": "rm -rf dist .turbo *.tsbuildinfo",
-    "test": "vitest run --passWithNoTests"
+    "test": "vitest run"
   }
 }

package/skills/cms-guidelines/README.md

@@ -18,7 +18,7 @@ Guidelines are short markdown fragments — one per CMS type — that describe h
    pnpm --filter <appName> generate-showcase
    ```
    This writes `src/generated/showcase-examples.json`.
-3. **Curate showcase mocks** — run the [curate-showcase-mocks skill](.cursor/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md) to select the best examples into `showcase-mocks.json`. This makes the showcase (and screenshots) show realistic content.
+3. **Curate showcase mocks** — run the [curate-showcase-mocks skill](.agents/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md) to select the best examples into `showcase-mocks.json`. This makes the showcase (and screenshots) show realistic content.
 4. **Generate field list** — parse TypeScript types to produce structured field metadata:
    ```bash
    # From the app directory:
@@ -27,7 +27,7 @@ Guidelines are short markdown fragments — one per CMS type — that describe h
    # Or from repo root:
    pnpm --filter <appName> exec cms-generate-field-list --app-dir .
    ```
-5. **Generate guidelines** — run the [Generate CMS guidelines skill](.cursor/skills/contentful-cms/generate-cms-guidelines/SKILL.md).
+5. **Generate guidelines** — run the [Generate CMS guidelines skill](.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md).
 
 Steps 1–3 only need to be repeated when content or component code changes significantly. Step 4 only needs to be repeated when TypeScript types change. Step 5 can be re-run at any time.
 
@@ -35,7 +35,7 @@ Steps 1–3 only need to be repeated when content or component code changes sign
 
 ## How to run guideline generation
 
-Use the Cursor skill at [`.cursor/skills/contentful-cms/generate-cms-guidelines/SKILL.md`](.cursor/skills/contentful-cms/generate-cms-guidelines/SKILL.md). It supports three modes:
+Use the Cursor skill at [`.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md`](.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md). It supports three modes:
 
 | Mode | When to use |
 |---|---|

package/skills/core/SKILL.md

@@ -121,6 +121,20 @@ cms-edit rtf @c1 body --file path/to/file.md
 cms-edit rtf @c1 body - < path/to/file.md
 ```
 
+**Surgical rich text replace** (compliance / quidget tokens — does not re-import the whole field):
+
+- Matching is **per Contentful text node** only. If the author split a phrase with bold (e.g. `**Annual fee: **$95`), the string `Annual fee: $95` will **not** match as one piece; use a shorter `--find` or full `rtf … --file`.
+- Quidget strings contain `*`, which Markdown would treat as italic — use **`--replace-plain`**, not `--replace`.
+
+```bash
+# Replace every "$95" in this field with the quidget (e.g. multiple table cells)
+cms-edit rtf replace @c2 body --find '$95' --replace-plain '{*credit_card_id*:*5048345*,*field*:*annual_fees*,*api*:*cc*}' --mode all
+
+# Exactly one occurrence required (fails if 0 or 2+)
+cms-edit rtf replace @c2 body --find '75,000 miles after spending $4,000 in the first 3 months' \
+  --replace-plain '{*credit_card_id*:*5048345*,*field*:*bonus_miles*,*api*:*cc*}' --mode exactlyOne
+```
+
 ### Step 5: Review changes
 
 ```bash