@se-studio/contentful-cms 0.0.0-next16-20260822103555

package/dist/rtf/inlineHtml.js

@@ -0,0 +1,152 @@
+import { INLINES, MARKS } from '@contentful/rich-text-types';
+function decodeEntities(s) {
+    return s
+        .replace(/ /gi, '\u00a0')
+        .replace(/&/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number.parseInt(n, 10)))
+        .replace(/&#x([0-9a-f]+);/gi, (_, h) => String.fromCodePoint(Number.parseInt(h, 16)));
+}
+function makeText(value, marks = []) {
+    return { nodeType: 'text', value, marks, data: {} };
+}
+function findClosingTag(html, from, tag) {
+    const re = new RegExp(`<\\s*(/?)\\s*${tag}\\b[^>]*>`, 'gi');
+    re.lastIndex = from;
+    let depth = 1;
+    for (;;) {
+        const m = re.exec(html);
+        if (m === null)
+            break;
+        const isClose = m[1] === '/';
+        if (isClose) {
+            depth--;
+            if (depth === 0)
+                return m.index;
+        }
+        else {
+            depth++;
+        }
+    }
+    return -1;
+}
+/**
+ * Parses inline HTML (bold, italic, links, code, br) into Contentful rich-text inline nodes.
+ */
+export function htmlToRtfInlines(fragment) {
+    const normalized = fragment.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (i > 0)
+            out.push(makeText('\n'));
+        out.push(...parseInlineSegment(lines[i] ?? ''));
+    }
+    return mergeAdjacentTextNodes(out);
+}
+function parseInlineSegment(line) {
+    const nodes = [];
+    let pos = 0;
+    while (pos < line.length) {
+        if (line[pos] !== '<') {
+            const nextLt = line.indexOf('<', pos);
+            const end = nextLt === -1 ? line.length : nextLt;
+            const raw = line.slice(pos, end);
+            if (raw)
+                nodes.push(makeText(decodeEntities(raw)));
+            pos = end;
+            continue;
+        }
+        const m = /^<\s*(\/?)\s*([a-zA-Z][\w-]*)\b([^>]*)>/.exec(line.slice(pos));
+        if (!m?.[0]) {
+            nodes.push(makeText(decodeEntities(line[pos] ?? '')));
+            pos++;
+            continue;
+        }
+        const fullTag = m[0];
+        const isClose = m[1] === '/';
+        const tag = (m[2] ?? '').toLowerCase();
+        const attrs = m[3] ?? '';
+        if (isClose) {
+            pos += fullTag.length;
+            continue;
+        }
+        if (tag === 'br') {
+            nodes.push(makeText('\n'));
+            pos += fullTag.length;
+            continue;
+        }
+        const closeStart = pos + fullTag.length;
+        const closeIdx = findClosingTag(line, closeStart, tag);
+        if (closeIdx === -1) {
+            pos += fullTag.length;
+            continue;
+        }
+        const inner = line.slice(closeStart, closeIdx);
+        const closeMatch = /^<\/\s*[^>]+\s*>/i.exec(line.slice(closeIdx));
+        const closeLen = closeMatch?.[0].length ?? 0;
+        pos = closeIdx + closeLen;
+        const innerNodes = parseInlineSegment(inner);
+        if (tag === 'strong' || tag === 'b') {
+            nodes.push(...applyMarksToInlines(innerNodes, [{ type: MARKS.BOLD }]));
+        }
+        else if (tag === 'em' || tag === 'i') {
+            nodes.push(...applyMarksToInlines(innerNodes, [{ type: MARKS.ITALIC }]));
+        }
+        else if (tag === 'code') {
+            nodes.push(...applyMarksToInlines(innerNodes, [{ type: MARKS.CODE }]));
+        }
+        else if (tag === 'a') {
+            const hrefMatch = /\bhref\s*=\s*("([^"]*)"|'([^']*)'|([^\s>]+))/i.exec(attrs);
+            const href = hrefMatch?.[2] ?? hrefMatch?.[3] ?? hrefMatch?.[4] ?? '#';
+            const hyperlink = {
+                nodeType: INLINES.HYPERLINK,
+                data: { uri: href },
+                content: innerNodes.length > 0 ? innerNodes : [makeText('')],
+            };
+            nodes.push(hyperlink);
+        }
+        else if (tag === 'span' || tag === 'u') {
+            nodes.push(...innerNodes);
+        }
+        else {
+            nodes.push(...innerNodes);
+        }
+    }
+    return nodes.length > 0 ? nodes : [makeText('')];
+}
+function applyMarksToInlines(nodes, marks) {
+    const out = [];
+    for (const n of nodes) {
+        if (n.nodeType === 'text') {
+            out.push({
+                ...n,
+                marks: [...(n.marks ?? []), ...marks],
+            });
+        }
+        else {
+            out.push(n);
+        }
+    }
+    return out;
+}
+function marksEqual(a, b) {
+    return JSON.stringify(a ?? []) === JSON.stringify(b ?? []);
+}
+function mergeAdjacentTextNodes(nodes) {
+    const merged = [];
+    for (const n of nodes) {
+        const prev = merged[merged.length - 1];
+        if (n.nodeType === 'text' && prev?.nodeType === 'text' && marksEqual(prev.marks, n.marks)) {
+            prev.value += n.value;
+        }
+        else {
+            merged.push(n);
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=inlineHtml.js.map

package/dist/rtf/inlineHtml.js.map

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

package/dist/rtf/references.d.ts

@@ -0,0 +1,9 @@
+import type { SessionState } from '../session/state.js';
+/**
+ * Returns true if the given entry ID is embedded in any rich text field
+ * across all entries in the current session. Used by the `remove` command
+ * to avoid deleting entries that are still referenced in rich text blocks
+ * even after being unlinked from a content array.
+ */
+export declare function isReferencedInSessionRichText(session: SessionState, entryId: string): boolean;
+//# sourceMappingURL=references.d.ts.map

package/dist/rtf/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/rtf/references.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAW7F"}

package/dist/rtf/references.js

@@ -0,0 +1,49 @@
+import { BLOCKS, INLINES } from '@contentful/rich-text-types';
+import { isRtfDocument } from './utils.js';
+/**
+ * Returns true if the given entry ID is embedded in any rich text field
+ * across all entries in the current session. Used by the `remove` command
+ * to avoid deleting entries that are still referenced in rich text blocks
+ * even after being unlinked from a content array.
+ */
+export function isReferencedInSessionRichText(session, entryId) {
+    for (const entry of Object.values(session.entries)) {
+        const locale = session.defaultLocale;
+        for (const fieldData of Object.values(entry.fields)) {
+            const value = fieldData[locale] ?? fieldData['en-US'];
+            if (isRtfDocument(value) && scanNodeForEntry(value, entryId)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function scanNodeForEntry(node, entryId) {
+    if (typeof node !== 'object' || node === null)
+        return false;
+    const n = node;
+    if ((n.nodeType === BLOCKS.EMBEDDED_ENTRY || n.nodeType === INLINES.EMBEDDED_ENTRY) &&
+        getEmbeddedEntryId(n.data) === entryId) {
+        return true;
+    }
+    if (Array.isArray(n.content)) {
+        for (const child of n.content) {
+            if (scanNodeForEntry(child, entryId))
+                return true;
+        }
+    }
+    return false;
+}
+function getEmbeddedEntryId(data) {
+    if (typeof data !== 'object' || data === null)
+        return null;
+    const target = data.target;
+    if (typeof target !== 'object' || target === null)
+        return null;
+    const sys = target.sys;
+    if (typeof sys !== 'object' || sys === null)
+        return null;
+    const id = sys.id;
+    return typeof id === 'string' ? id : null;
+}
+//# sourceMappingURL=references.js.map

package/dist/rtf/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/rtf/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAqB,EAAE,OAAe;IAClF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;QACrC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa,EAAE,OAAe;IACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAE5D,MAAM,CAAC,GAAG,IAAkE,CAAC;IAE7E,IACE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC;QAC/E,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,EACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,MAAM,GAAI,IAA6B,CAAC,MAAM,CAAC;IACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,GAAG,GAAI,MAA4B,CAAC,GAAG,CAAC;IAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC"}

package/dist/rtf/replacePlainText.d.ts

@@ -0,0 +1,117 @@
+import type { Block, Document, Inline, Text } from '@contentful/rich-text-types';
+export declare class RichTextReplaceError extends Error {
+    constructor(message: string);
+}
+export type ReplaceRtfPlainTextMode = 'all' | 'exactlyOne';
+export interface ReplaceRtfPlainTextOptions {
+    find: string;
+    mode: ReplaceRtfPlainTextMode;
+    /**
+     * Inline-only Markdown (same as `cms-edit rtf` inline syntax: **bold**, links, etc.).
+     * Omit if {@link replacePlain} is set.
+     */
+    replaceMarkdown?: string;
+    /**
+     * Literal replacement text (no Markdown). Use for tokens containing `*` so
+     * `*` is not parsed as italic.
+     */
+    replacePlain?: string;
+    /**
+     * Inline HTML only (no block tags). Parsed to rich-text inline nodes.
+     */
+    replaceHtml?: string;
+    /**
+     * JSON array of inline rich-text nodes (e.g. `[{"nodeType":"text","value":"x","marks":[],"data":{}}]`).
+     */
+    replaceJson?: string;
+    /**
+     * When true, match `find` across adjacent sibling text nodes in the same block
+     * (e.g. `**Annual fee: **$95` split across bold + plain nodes). Replacement is
+     * inserted at the match site; surrounding text retains its original marks.
+     * Matches cannot cross inline node boundaries (e.g. hyperlinks).
+     */
+    ignoreMarks?: boolean;
+    /**
+     * Restrict search-and-replace to table cells in this column (1-indexed).
+     * Non-table content is always included. Omit to search all columns.
+     */
+    tableCol?: number;
+    /**
+     * Restrict search-and-replace to table cells in this row (1-indexed; row 1 = header row).
+     * Non-table content is always included. Omit to search all rows.
+     */
+    tableRow?: number;
+    /**
+     * Restrict search-and-replace to table rows where any cell contains this literal text.
+     * Case-sensitive substring match. Non-table content is always included.
+     */
+    inRowContaining?: string;
+    /**
+     * Restrict search-and-replace to the table column whose header cell (row 1) contains
+     * this literal text. Case-sensitive substring match. Resolved to a column index before
+     * searching; throws {@link RichTextReplaceError} if no header cell matches.
+     * If combined with an explicit {@link tableCol}, both must resolve to the same column or
+     * an error is thrown.
+     */
+    inColContaining?: string;
+    /**
+     * Scope replacements to blocks under the heading whose plain-text matches this string.
+     * Leading/trailing whitespace in headings is ignored during comparison.
+     * Blocks before the heading or after the next heading of equal/higher level are excluded.
+     * Throws {@link RichTextReplaceError} if no heading matches (error includes available headings).
+     */
+    section?: string;
+    /**
+     * When multiple headings share the same text, select which occurrence to use (1-indexed).
+     * Defaults to 1 (first match). Only meaningful when {@link section} is also set.
+     * Throws {@link RichTextReplaceError} if the Nth occurrence does not exist.
+     */
+    sectionNth?: number;
+    /**
+     * A regex string that defines "protected spans" in text nodes. Matches whose range falls
+     * strictly inside a protected span are skipped (the span itself can still be found/replaced).
+     * Example: `'\\{\\*[^{}]*\\*\\}'` to protect `{*...*}` tokens.
+     * When omitted, no span protection is applied.
+     */
+    protectPattern?: string;
+    /**
+     * When true, count matches and return positions but do not write replacements.
+     * The returned `document` is unchanged. `matchCount` and `matchPositions` are still populated.
+     */
+    dryRun?: boolean;
+}
+export interface ReplaceRtfPlainTextResult {
+    document: Document;
+    /** Number of non-overlapping occurrences of `find` that were replaced (0 if none). */
+    matchCount: number;
+    /**
+     * Block indices (into `document.content`) that contain at least one match.
+     * Populated for all modes; useful for dry-run previews and exactlyOne diagnostics.
+     */
+    matchPositions: number[];
+}
+export declare function isHeadingBlock(block: Block): boolean;
+export declare function getHeadingLevel(block: Block): number;
+export declare function extractBlockPlainText(block: Block): string;
+/**
+ * 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).
+ *
+ * **Protected spans:** Pass `protectPattern` (a regex string) to skip matches that fall inside
+ * an existing token matching that pattern. The token itself can still be found/replaced; only
+ * shorter matches landing strictly inside it are skipped.
+ *
+ * **Modes:** `all` replaces every non-overlapping occurrence. `exactlyOne` requires exactly
+ * one occurrence in the entire document or throws {@link RichTextReplaceError} with diagnostics.
+ *
+ * **Dry run:** Pass `dryRun: true` to count and locate matches without writing changes.
+ *
+ * @returns A deep-cloned document with replacements applied (input is not mutated),
+ *   plus `matchCount` and `matchPositions` (block indices where matches were found).
+ */
+export declare function replaceRtfPlainText(document: Document, options: ReplaceRtfPlainTextOptions): ReplaceRtfPlainTextResult;
+export declare function walkTextNodes(inlines: (Text | Inline)[], fn: (parent: (Text | Inline)[], index: number, text: Text) => void): void;
+//# sourceMappingURL=replacePlainText.d.ts.map

package/dist/rtf/replacePlainText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replacePlainText.d.ts","sourceRoot":"","sources":["../../src/rtf/replacePlainText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAOjF,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,YAAY,CAAC;AAE3D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,uBAAuB,CAAC;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAsGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEpD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAI1D;AAgED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CA+D3B;AAoHD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,EAC1B,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GACjE,IAAI,CAaN"}