@se-studio/contentful-cms 1.0.1

package/dist/rtf/fromMarkdown.d.ts

@@ -0,0 +1,19 @@
+import type { Document } from '@contentful/rich-text-types';
+/**
+ * Converts a Markdown string to a Contentful Rich Text Document.
+ *
+ * Supports (basic):
+ *   - Headings: # to ######
+ *   - Paragraphs
+ *   - Bold: **text** or __text__
+ *   - Italic: *text* or _text_
+ *   - Bold+italic: ***text***
+ *   - Inline code: `code`
+ *   - Links: [text](url)
+ *   - Unordered lists: - item or * item
+ *   - Ordered lists: 1. item
+ *   - Blockquotes: > text
+ *   - Horizontal rules: ---
+ */
+export declare function markdownToRtf(markdown: string): Document;
+//# sourceMappingURL=fromMarkdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fromMarkdown.d.ts","sourceRoot":"","sources":["../../src/rtf/fromMarkdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,QAAQ,EAA+B,MAAM,6BAA6B,CAAC;AAGhG;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAQxD"}

package/dist/rtf/fromMarkdown.js

@@ -0,0 +1,230 @@
+import { BLOCKS, INLINES, MARKS } from '@contentful/rich-text-types';
+/**
+ * Converts a Markdown string to a Contentful Rich Text Document.
+ *
+ * Supports (basic):
+ *   - Headings: # to ######
+ *   - Paragraphs
+ *   - Bold: **text** or __text__
+ *   - Italic: *text* or _text_
+ *   - Bold+italic: ***text***
+ *   - Inline code: `code`
+ *   - Links: [text](url)
+ *   - Unordered lists: - item or * item
+ *   - Ordered lists: 1. item
+ *   - Blockquotes: > text
+ *   - Horizontal rules: ---
+ */
+export function markdownToRtf(markdown) {
+    const lines = markdown.split('\n');
+    const blocks = parseBlocks(lines);
+    return {
+        nodeType: BLOCKS.DOCUMENT,
+        data: {},
+        content: blocks,
+    };
+}
+function parseLine(line) {
+    // Headings
+    const headingMatch = /^(#{1,6})\s+(.+)$/.exec(line);
+    if (headingMatch?.[1] && headingMatch[2] !== undefined) {
+        const level = Math.min(headingMatch[1].length, 6);
+        return { type: 'heading', level, text: headingMatch[2] };
+    }
+    // HR
+    if (/^---+$/.test(line.trim()) || /^\*\*\*+$/.test(line.trim())) {
+        return { type: 'hr' };
+    }
+    // Unordered list items
+    const ulMatch = /^[-*+]\s+(.*)$/.exec(line);
+    if (ulMatch?.[1] !== undefined) {
+        return { type: 'ul-item', text: ulMatch[1] };
+    }
+    // Ordered list items
+    const olMatch = /^(\d+)\.\s+(.*)$/.exec(line);
+    if (olMatch?.[1] !== undefined && olMatch[2] !== undefined) {
+        return { type: 'ol-item', text: olMatch[2], index: Number.parseInt(olMatch[1], 10) };
+    }
+    // Blockquote
+    const bqMatch = /^>\s?(.*)$/.exec(line);
+    if (bqMatch?.[1] !== undefined) {
+        return { type: 'blockquote', text: bqMatch[1] };
+    }
+    // Blank line
+    if (line.trim() === '')
+        return { type: 'blank' };
+    // Normal text
+    return { type: 'text', text: line };
+}
+function parseBlocks(lines) {
+    const blocks = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i] ?? '';
+        const parsed = parseLine(line);
+        if (parsed.type === 'blank') {
+            i++;
+            continue;
+        }
+        if (parsed.type === 'hr') {
+            blocks.push({ nodeType: BLOCKS.HR, data: {}, content: [] });
+            i++;
+            continue;
+        }
+        if (parsed.type === 'heading') {
+            const nodeType = [
+                BLOCKS.HEADING_1,
+                BLOCKS.HEADING_2,
+                BLOCKS.HEADING_3,
+                BLOCKS.HEADING_4,
+                BLOCKS.HEADING_5,
+                BLOCKS.HEADING_6,
+            ][parsed.level - 1];
+            blocks.push({ nodeType, data: {}, content: parseInline(parsed.text) });
+            i++;
+            continue;
+        }
+        if (parsed.type === 'ul-item') {
+            const items = [];
+            while (i < lines.length) {
+                const l = lines[i] ?? '';
+                const p = parseLine(l);
+                if (p.type !== 'ul-item')
+                    break;
+                items.push({
+                    nodeType: BLOCKS.LIST_ITEM,
+                    data: {},
+                    content: [makeParagraph(parseInline(p.text))],
+                });
+                i++;
+            }
+            blocks.push({ nodeType: BLOCKS.UL_LIST, data: {}, content: items });
+            continue;
+        }
+        if (parsed.type === 'ol-item') {
+            const items = [];
+            while (i < lines.length) {
+                const l = lines[i] ?? '';
+                const p = parseLine(l);
+                if (p.type !== 'ol-item')
+                    break;
+                items.push({
+                    nodeType: BLOCKS.LIST_ITEM,
+                    data: {},
+                    content: [makeParagraph(parseInline(p.text))],
+                });
+                i++;
+            }
+            blocks.push({ nodeType: BLOCKS.OL_LIST, data: {}, content: items });
+            continue;
+        }
+        if (parsed.type === 'blockquote') {
+            const quoteLines = [];
+            while (i < lines.length) {
+                const l = lines[i] ?? '';
+                const p = parseLine(l);
+                if (p.type !== 'blockquote' && p.type !== 'blank')
+                    break;
+                if (p.type === 'blockquote')
+                    quoteLines.push(p.text);
+                i++;
+            }
+            blocks.push({
+                nodeType: BLOCKS.QUOTE,
+                data: {},
+                content: [makeParagraph(parseInline(quoteLines.join(' ')))],
+            });
+            continue;
+        }
+        // Accumulate text lines into a paragraph
+        const paraLines = [];
+        while (i < lines.length) {
+            const l = lines[i] ?? '';
+            const p = parseLine(l);
+            if (p.type === 'blank')
+                break;
+            if (p.type !== 'text')
+                break;
+            paraLines.push(p.text);
+            i++;
+        }
+        if (paraLines.length > 0) {
+            blocks.push(makeParagraph(parseInline(paraLines.join(' '))));
+        }
+    }
+    // Contentful requires at least one block
+    if (blocks.length === 0) {
+        blocks.push(makeParagraph([makeText('')]));
+    }
+    return blocks;
+}
+function makeParagraph(content) {
+    return { nodeType: BLOCKS.PARAGRAPH, data: {}, content };
+}
+function makeText(value, marks = []) {
+    return { nodeType: 'text', value, marks, data: {} };
+}
+function parseInline(text) {
+    const nodes = [];
+    let i = 0;
+    while (i < text.length) {
+        // Bold+italic: ***text*** or ___text___
+        const boldItalicMatch = /^\*{3}(.+?)\*{3}|^_{3}(.+?)_{3}/.exec(text.slice(i));
+        if (boldItalicMatch) {
+            const content = boldItalicMatch[1] ?? boldItalicMatch[2] ?? '';
+            nodes.push(makeText(content, [{ type: MARKS.BOLD }, { type: MARKS.ITALIC }]));
+            i += boldItalicMatch[0].length;
+            continue;
+        }
+        // Bold: **text** or __text__
+        const boldMatch = /^\*{2}(.+?)\*{2}|^_{2}(.+?)_{2}/.exec(text.slice(i));
+        if (boldMatch) {
+            const content = boldMatch[1] ?? boldMatch[2] ?? '';
+            nodes.push(makeText(content, [{ type: MARKS.BOLD }]));
+            i += boldMatch[0].length;
+            continue;
+        }
+        // Italic: *text* or _text_
+        const italicMatch = /^\*([^*]+?)\*|^_([^_]+?)_/.exec(text.slice(i));
+        if (italicMatch) {
+            const content = italicMatch[1] ?? italicMatch[2] ?? '';
+            nodes.push(makeText(content, [{ type: MARKS.ITALIC }]));
+            i += italicMatch[0].length;
+            continue;
+        }
+        // Inline code: `code`
+        const codeMatch = /^`([^`]+?)`/.exec(text.slice(i));
+        if (codeMatch?.[1] !== undefined) {
+            nodes.push(makeText(codeMatch[1], [{ type: MARKS.CODE }]));
+            i += codeMatch[0].length;
+            continue;
+        }
+        // Link: [text](url)
+        const linkMatch = /^\[([^\]]+)\]\(([^)]+)\)/.exec(text.slice(i));
+        if (linkMatch?.[1] !== undefined && linkMatch[2] !== undefined) {
+            const linkText = linkMatch[1];
+            const href = linkMatch[2];
+            const inline = {
+                nodeType: INLINES.HYPERLINK,
+                data: { uri: href },
+                content: [makeText(linkText)],
+            };
+            nodes.push(inline);
+            i += linkMatch[0].length;
+            continue;
+        }
+        // Regular character — accumulate into a text run
+        let j = i + 1;
+        const stopChars = new Set(['*', '_', '`', '[']);
+        while (j < text.length) {
+            const ch = text[j];
+            if (ch && stopChars.has(ch))
+                break;
+            j++;
+        }
+        nodes.push(makeText(text.slice(i, j)));
+        i = j;
+    }
+    return nodes.length > 0 ? nodes : [makeText('')];
+}
+//# sourceMappingURL=fromMarkdown.js.map

package/dist/rtf/fromMarkdown.js.map

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

package/dist/rtf/toMarkdown.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a Contentful Rich Text Document to a Markdown string for display.
+ * This is used by the `read` command to display rich text fields.
+ */
+export declare function rtfToMarkdown(doc: unknown): string;
+//# sourceMappingURL=toMarkdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toMarkdown.d.ts","sourceRoot":"","sources":["../../src/rtf/toMarkdown.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGlD"}

package/dist/rtf/toMarkdown.js

@@ -0,0 +1,105 @@
+import { BLOCKS, INLINES, MARKS } from '@contentful/rich-text-types';
+/**
+ * Converts a Contentful Rich Text Document to a Markdown string for display.
+ * This is used by the `read` command to display rich text fields.
+ */
+export function rtfToMarkdown(doc) {
+    if (!isDocument(doc))
+        return '[invalid rich text]';
+    return renderNodes(doc.content).trim();
+}
+function renderNodes(nodes) {
+    return nodes.map(renderNode).join('');
+}
+function renderNode(node) {
+    if (isText(node)) {
+        return renderText(node);
+    }
+    const block = node;
+    switch (block.nodeType) {
+        case BLOCKS.PARAGRAPH: {
+            const content = renderNodes(block.content);
+            return content.trim() ? `${content.trim()}\n\n` : '';
+        }
+        case BLOCKS.HEADING_1:
+            return `# ${renderNodes(block.content).trim()}\n\n`;
+        case BLOCKS.HEADING_2:
+            return `## ${renderNodes(block.content).trim()}\n\n`;
+        case BLOCKS.HEADING_3:
+            return `### ${renderNodes(block.content).trim()}\n\n`;
+        case BLOCKS.HEADING_4:
+            return `#### ${renderNodes(block.content).trim()}\n\n`;
+        case BLOCKS.HEADING_5:
+            return `##### ${renderNodes(block.content).trim()}\n\n`;
+        case BLOCKS.HEADING_6:
+            return `###### ${renderNodes(block.content).trim()}\n\n`;
+        case BLOCKS.UL_LIST:
+            return `${renderList(block.content, false)}\n`;
+        case BLOCKS.OL_LIST:
+            return `${renderList(block.content, true)}\n`;
+        case BLOCKS.LIST_ITEM:
+            return renderNodes(block.content).trim();
+        case BLOCKS.QUOTE:
+            return `${renderNodes(block.content)
+                .trim()
+                .split('\n')
+                .map((line) => `> ${line}`)
+                .join('\n')}\n\n`;
+        case BLOCKS.HR:
+            return '---\n\n';
+        case BLOCKS.EMBEDDED_ENTRY:
+        case BLOCKS.EMBEDDED_ASSET:
+            return '[embedded content]\n\n';
+        case INLINES.HYPERLINK: {
+            const href = block.data.uri ?? '#';
+            return `[${renderNodes(block.content).trim()}](${href})`;
+        }
+        case INLINES.ENTRY_HYPERLINK:
+        case INLINES.ASSET_HYPERLINK:
+            return `[${renderNodes(block.content).trim()}](#)`;
+        case INLINES.EMBEDDED_ENTRY:
+            return '[inline]';
+        default:
+            if ('content' in block && Array.isArray(block.content)) {
+                return renderNodes(block.content);
+            }
+            return '';
+    }
+}
+function renderText(node) {
+    let text = node.value;
+    const markTypes = node.marks.map((m) => m.type);
+    if (markTypes.includes(MARKS.CODE))
+        return `\`${text}\``;
+    if (markTypes.includes(MARKS.BOLD) && markTypes.includes(MARKS.ITALIC)) {
+        text = `***${text}***`;
+    }
+    else if (markTypes.includes(MARKS.BOLD)) {
+        text = `**${text}**`;
+    }
+    else if (markTypes.includes(MARKS.ITALIC)) {
+        text = `_${text}_`;
+    }
+    else if (markTypes.includes(MARKS.UNDERLINE)) {
+        text = `__${text}__`;
+    }
+    return text;
+}
+function renderList(items, ordered) {
+    return items
+        .map((item, index) => {
+        const prefix = ordered ? `${index + 1}. ` : '- ';
+        const content = renderNode(item).trim();
+        return `${prefix}${content}`;
+    })
+        .join('\n');
+}
+function isDocument(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.nodeType === BLOCKS.DOCUMENT);
+}
+function isText(node) {
+    return node.nodeType === 'text';
+}
+//# sourceMappingURL=toMarkdown.js.map

package/dist/rtf/toMarkdown.js.map

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

package/dist/session/refs.d.ts

@@ -0,0 +1,35 @@
+import type { SerializedEntry, SessionState, TreeNode } from './state.js';
+/**
+ * Resolves a ref string (@c0, @c1, ...) to a serialized entry.
+ * Throws a descriptive error if the ref is not found.
+ */
+export declare function resolveRef(session: SessionState, ref: string): SerializedEntry;
+/**
+ * Resolves a ref string to its entry ID.
+ */
+export declare function resolveRefToId(session: SessionState, ref: string): string;
+/**
+ * Finds the TreeNode for a given ref.
+ */
+export declare function findTreeNode(session: SessionState, ref: string): TreeNode | null;
+/**
+ * Builds a depth-first ordered tree from an entry map, assigning @c0, @c1... refs.
+ * Returns updated refs, refsByEntry, and treeNodes arrays.
+ */
+export declare function buildTree(rootEntryId: string, entries: Record<string, SerializedEntry>, locale: string): Pick<SessionState, 'refs' | 'refsByEntry' | 'treeNodes'>;
+/**
+ * Returns the field name for a navigation's item array ('items' or 'navigationItems').
+ * Prefers 'items' if both exist. Returns 'items' if neither exists (for new navigations).
+ */
+export declare function getNavigationItemsFieldName(entry: SerializedEntry, locale: string): string;
+/**
+ * Creates a Contentful entry link object for inserting into content arrays.
+ */
+export declare function makeEntryLink(entryId: string): {
+    sys: {
+        type: 'Link';
+        linkType: 'Entry';
+        id: string;
+    };
+};
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/session/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAY9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGhF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACxC,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,CAAC,CA0D1D;AAWD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS1F;AAYD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAC9C,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAEA"}

package/dist/session/refs.js

@@ -0,0 +1,128 @@
+/**
+ * Resolves a ref string (@c0, @c1, ...) to a serialized entry.
+ * Throws a descriptive error if the ref is not found.
+ */
+export function resolveRef(session, ref) {
+    const normalizedRef = ref.startsWith('@') ? ref : `@${ref}`;
+    const entryId = session.refs[normalizedRef];
+    if (!entryId) {
+        const available = Object.keys(session.refs).join(', ');
+        throw new Error(`Ref "${normalizedRef}" not found. Available refs: ${available}`);
+    }
+    const entry = session.entries[entryId];
+    if (!entry) {
+        throw new Error(`Entry "${entryId}" not found in session. Try re-running "cms-edit open".`);
+    }
+    return entry;
+}
+/**
+ * Resolves a ref string to its entry ID.
+ */
+export function resolveRefToId(session, ref) {
+    const normalizedRef = ref.startsWith('@') ? ref : `@${ref}`;
+    const entryId = session.refs[normalizedRef];
+    if (!entryId) {
+        const available = Object.keys(session.refs).join(', ');
+        throw new Error(`Ref "${normalizedRef}" not found. Available refs: ${available}`);
+    }
+    return entryId;
+}
+/**
+ * Finds the TreeNode for a given ref.
+ */
+export function findTreeNode(session, ref) {
+    const normalizedRef = ref.startsWith('@') ? ref : `@${ref}`;
+    return session.treeNodes.find((n) => n.ref === normalizedRef) ?? null;
+}
+/**
+ * Builds a depth-first ordered tree from an entry map, assigning @c0, @c1... refs.
+ * Returns updated refs, refsByEntry, and treeNodes arrays.
+ */
+export function buildTree(rootEntryId, entries, locale) {
+    const refs = {};
+    const refsByEntry = {};
+    const treeNodes = [];
+    let counter = 0;
+    function assignRef(entryId) {
+        const existing = refsByEntry[entryId];
+        if (existing)
+            return existing;
+        const ref = `@c${counter++}`;
+        refs[ref] = entryId;
+        refsByEntry[entryId] = ref;
+        return ref;
+    }
+    function traverse(entryId, parentId, parentField, depth) {
+        const entry = entries[entryId];
+        if (!entry)
+            return;
+        const ref = assignRef(entryId);
+        treeNodes.push({ entryId, ref, parentId, parentField, depth });
+        const ctId = entry.sys.contentType.sys.id;
+        const fieldsToExpand = ctId === 'collection'
+            ? ['contents']
+            : ctId === 'page' || ctId === 'article'
+                ? ['topContent', 'content', 'bottomContent']
+                : ctId === 'template'
+                    ? ['preContent', 'postContent']
+                    : ctId === 'navigation'
+                        ? getNavigationItemsField(entry, locale)
+                        : [];
+        for (const fieldId of fieldsToExpand) {
+            const fieldData = entry.fields[fieldId];
+            if (!fieldData)
+                continue;
+            const items = fieldData[locale] ?? fieldData['en-US'];
+            if (!Array.isArray(items))
+                continue;
+            for (const item of items) {
+                if (isEntryLink(item)) {
+                    const childId = item.sys.id;
+                    if (entries[childId]) {
+                        traverse(childId, entryId, fieldId, depth + 1);
+                    }
+                }
+            }
+        }
+    }
+    traverse(rootEntryId, null, null, 0);
+    return { refs, refsByEntry, treeNodes };
+}
+/**
+ * For navigation entries, returns the single array field to expand (items or navigationItems).
+ * Prefers 'items' if both exist and are arrays.
+ */
+function getNavigationItemsField(entry, locale) {
+    const name = getNavigationItemsFieldName(entry, locale);
+    return name ? [name] : [];
+}
+/**
+ * Returns the field name for a navigation's item array ('items' or 'navigationItems').
+ * Prefers 'items' if both exist. Returns 'items' if neither exists (for new navigations).
+ */
+export function getNavigationItemsFieldName(entry, locale) {
+    const fallback = 'en-US';
+    for (const fieldId of ['items', 'navigationItems']) {
+        const fieldData = entry.fields[fieldId];
+        if (!fieldData || typeof fieldData !== 'object')
+            continue;
+        const items = fieldData[locale] ?? fieldData[fallback];
+        if (Array.isArray(items))
+            return fieldId;
+    }
+    return 'items';
+}
+function isEntryLink(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'sys' in item &&
+        typeof item.sys === 'object' &&
+        item.sys.linkType === 'Entry');
+}
+/**
+ * Creates a Contentful entry link object for inserting into content arrays.
+ */
+export function makeEntryLink(entryId) {
+    return { sys: { type: 'Link', linkType: 'Entry', id: entryId } };
+}
+//# sourceMappingURL=refs.js.map

package/dist/session/refs.js.map

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

package/dist/session/state.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Serialized representation of a Contentful CMA entry for session storage.
+ * Fields use the CMA locale-keyed format: { fieldId: { locale: value } }
+ */
+export interface SerializedEntry {
+    sys: {
+        id: string;
+        version: number;
+        publishedVersion?: number;
+        publishedAt?: string;
+        contentType: {
+            sys: {
+                id: string;
+            };
+        };
+        createdAt: string;
+        updatedAt: string;
+    };
+    fields: Record<string, Record<string, unknown>>;
+}
+/**
+ * A node in the content tree representing a single entry's position within a page.
+ * Stored depth-first so iteration order matches visual display order.
+ */
+export interface TreeNode {
+    entryId: string;
+    ref: string;
+    parentId: string | null;
+    parentField: string | null;
+    depth: number;
+}
+/**
+ * A single field change to be applied on save.
+ */
+export interface FieldPatch {
+    fieldId: string;
+    locale: string;
+    value: unknown;
+    appliedAt: string;
+}
+/**
+ * The full session state persisted between CLI commands.
+ */
+export interface SessionState {
+    version: 1;
+    spaceKey: string;
+    spaceId: string;
+    environment: string;
+    defaultLocale: string;
+    rootEntryId: string;
+    rootEntryType: 'page' | 'article' | 'navigation' | 'template';
+    fetchedAt: string;
+    /** All fetched entries keyed by entry ID */
+    entries: Record<string, SerializedEntry>;
+    /** Original entry state at open time (for diff) */
+    originalEntries: Record<string, SerializedEntry>;
+    /** @c0 → entryId */
+    refs: Record<string, string>;
+    /** entryId → @c0 */
+    refsByEntry: Record<string, string>;
+    /** Depth-first ordered tree nodes */
+    treeNodes: TreeNode[];
+    /** Entry IDs that have been locally modified */
+    modifiedEntryIds: string[];
+    /** Draft-only entry IDs to delete on save (from remove operations) */
+    pendingDeletions: string[];
+}
+export type EntryStatus = 'published' | 'draft' | 'pending' | 'changed';
+/**
+ * Derives the display status of an entry.
+ *
+ * - changed: has unsaved local patches
+ * - draft: never published
+ * - pending: published but has newer draft on Contentful
+ * - published: published and no pending changes
+ */
+export declare function getEntryStatus(entry: SerializedEntry, isLocallyModified: boolean): EntryStatus;
+/**
+ * Returns the display type label for any content type.
+ * Looks for a ${ctId}Type discriminator field (e.g. componentType, collectionType,
+ * externalComponentType) and renders as TypeName[value] when present.
+ * Falls back to the capitalised content type ID for types without a discriminator.
+ */
+export declare function getEntryTypeLabel(entry: SerializedEntry, locale: string): string;
+/**
+ * Returns the best display label (cmsLabel or heading or entry ID).
+ */
+export declare function getEntryLabel(entry: SerializedEntry, locale: string): string;
+/** The content array fields that can contain linked entries. */
+export declare const CONTENT_ARRAY_FIELDS: readonly ["topContent", "content", "bottomContent", "contents"];
+//# sourceMappingURL=state.d.ts.map