@refrakt-md/editor 0.8.3 → 0.8.5

package/app/dist/assets/{index-BBljOYQu.js → index-n8MtxI3L.js}

@@ -1 +1 @@
-import{a as O,L as b,b as r,l as s,f as a,m as t,s as P,t as e,g as n}from"./index-ogrpJNou.js";const S={__proto__:null,anyref:34,dataref:34,eqref:34,externref:34,i31ref:34,funcref:34,i8:34,i16:34,i32:34,i64:34,f32:34,f64:34},Q=n.deserialize({version:14,states:"!^Q]QPOOOqQPO'#CbOOQO'#Cd'#CdOOQO'#Cl'#ClOOQO'#Ch'#ChQ]QPOOOOQO,58|,58|OxQPO,58|OOQO-E6f-E6fOOQO1G.h1G.h",stateData:"!P~O_OSPOSQOS~OTPOVROXROYROZROaQO~OSUO~P]OSXO~P]O",goto:"xaPPPPPPbPbPPPhPPPrXROPTVQTOQVPTWTVXSOPTV",nodeNames:"⚠ LineComment BlockComment Module ) ( App Identifier Type Keyword Number String",maxTerm:17,nodeProps:[["isolate",-3,1,2,11,""],["openedBy",4,"("],["closedBy",5,")"],["group",-6,6,7,8,9,10,11,"Expression"]],skippedNodes:[0,1,2],repeatNodeCount:1,tokenData:"0o~R^XY}YZ}]^}pq}rs!Stu#pxy'Uyz(e{|(j}!O(j!Q!R(s!R![*p!]!^.^#T#o.{~!SO_~~!VVOr!Srs!ls#O!S#O#P!q#P;'S!S;'S;=`#j<%lO!S~!qOZ~~!tRO;'S!S;'S;=`!};=`O!S~#QWOr!Srs!ls#O!S#O#P!q#P;'S!S;'S;=`#j;=`<%l!S<%lO!S~#mP;=`<%l!S~#siqr%bst%btu%buv%bvw%bwx%bz{%b{|%b}!O%b!O!P%b!P!Q%b!Q![%b![!]%b!^!_%b!_!`%b!`!a%b!a!b%b!b!c%b!c!}%b#Q#R%b#R#S%b#S#T%b#T#o%b#p#q%b#r#s%b~%giV~qr%bst%btu%buv%bvw%bwx%bz{%b{|%b}!O%b!O!P%b!P!Q%b!Q![%b![!]%b!^!_%b!_!`%b!`!a%b!a!b%b!b!c%b!c!}%b#Q#R%b#R#S%b#S#T%b#T#o%b#p#q%b#r#s%b~'ZPT~!]!^'^~'aTO!]'^!]!^'p!^;'S'^;'S;=`(_<%lO'^~'sVOy'^yz(Yz!]'^!]!^'p!^;'S'^;'S;=`(_<%lO'^~(_OQ~~(bP;=`<%l'^~(jOS~~(mQ!Q!R(s!R![*p~(xUY~!O!P)[!Q![*p!g!h){#R#S+U#X#Y){#l#m+[~)aRY~!Q![)j!g!h){#X#Y){~)oSY~!Q![)j!g!h){#R#S*j#X#Y){~*OR{|*X}!O*X!Q![*_~*[P!Q![*_~*dQY~!Q![*_#R#S*X~*mP!Q![)j~*uTY~!O!P)[!Q![*p!g!h){#R#S+U#X#Y){~+XP!Q![*p~+_R!Q![+h!c!i+h#T#Z+h~+mVY~!O!P,S!Q![+h!c!i+h!r!s-P#R#S+[#T#Z+h#d#e-P~,XTY~!Q![,h!c!i,h!r!s-P#T#Z,h#d#e-P~,mUY~!Q![,h!c!i,h!r!s-P#R#S.Q#T#Z,h#d#e-P~-ST{|-c}!O-c!Q![-o!c!i-o#T#Z-o~-fR!Q![-o!c!i-o#T#Z-o~-tSY~!Q![-o!c!i-o#R#S-c#T#Z-o~.TR!Q![,h!c!i,h#T#Z,h~.aP!]!^.d~.iSP~OY.dZ;'S.d;'S;=`.u<%lO.d~.xP;=`<%l.d~/QiX~qr.{st.{tu.{uv.{vw.{wx.{z{.{{|.{}!O.{!O!P.{!P!Q.{!Q![.{![!].{!^!_.{!_!`.{!`!a.{!a!b.{!b!c.{!c!}.{#Q#R.{#R#S.{#S#T.{#T#o.{#p#q.{#r#s.{",tokenizers:[0],topRules:{Module:[0,3]},specialized:[{term:9,get:o=>S[o]||-1}],tokenPrec:0}),i=b.define({name:"wast",parser:Q.configure({props:[r.add({App:s({closing:")",align:!1})}),a.add({App:t,BlockComment(o){return{from:o.from+2,to:o.to-2}}}),P({Keyword:e.keyword,Type:e.typeName,Number:e.number,String:e.string,Identifier:e.variableName,LineComment:e.lineComment,BlockComment:e.blockComment,"( )":e.paren})]}),languageData:{commentTokens:{line:";;",block:{open:"(;",close:";)"}},closeBrackets:{brackets:["(",'"']}}});function d(){return new O(i)}export{d as wast,i as wastLanguage};
+import{a as O,L as b,b as r,l as s,f as a,m as t,s as P,t as e,g as n}from"./index-Y1_ZkrfC.js";const S={__proto__:null,anyref:34,dataref:34,eqref:34,externref:34,i31ref:34,funcref:34,i8:34,i16:34,i32:34,i64:34,f32:34,f64:34},Q=n.deserialize({version:14,states:"!^Q]QPOOOqQPO'#CbOOQO'#Cd'#CdOOQO'#Cl'#ClOOQO'#Ch'#ChQ]QPOOOOQO,58|,58|OxQPO,58|OOQO-E6f-E6fOOQO1G.h1G.h",stateData:"!P~O_OSPOSQOS~OTPOVROXROYROZROaQO~OSUO~P]OSXO~P]O",goto:"xaPPPPPPbPbPPPhPPPrXROPTVQTOQVPTWTVXSOPTV",nodeNames:"⚠ LineComment BlockComment Module ) ( App Identifier Type Keyword Number String",maxTerm:17,nodeProps:[["isolate",-3,1,2,11,""],["openedBy",4,"("],["closedBy",5,")"],["group",-6,6,7,8,9,10,11,"Expression"]],skippedNodes:[0,1,2],repeatNodeCount:1,tokenData:"0o~R^XY}YZ}]^}pq}rs!Stu#pxy'Uyz(e{|(j}!O(j!Q!R(s!R![*p!]!^.^#T#o.{~!SO_~~!VVOr!Srs!ls#O!S#O#P!q#P;'S!S;'S;=`#j<%lO!S~!qOZ~~!tRO;'S!S;'S;=`!};=`O!S~#QWOr!Srs!ls#O!S#O#P!q#P;'S!S;'S;=`#j;=`<%l!S<%lO!S~#mP;=`<%l!S~#siqr%bst%btu%buv%bvw%bwx%bz{%b{|%b}!O%b!O!P%b!P!Q%b!Q![%b![!]%b!^!_%b!_!`%b!`!a%b!a!b%b!b!c%b!c!}%b#Q#R%b#R#S%b#S#T%b#T#o%b#p#q%b#r#s%b~%giV~qr%bst%btu%buv%bvw%bwx%bz{%b{|%b}!O%b!O!P%b!P!Q%b!Q![%b![!]%b!^!_%b!_!`%b!`!a%b!a!b%b!b!c%b!c!}%b#Q#R%b#R#S%b#S#T%b#T#o%b#p#q%b#r#s%b~'ZPT~!]!^'^~'aTO!]'^!]!^'p!^;'S'^;'S;=`(_<%lO'^~'sVOy'^yz(Yz!]'^!]!^'p!^;'S'^;'S;=`(_<%lO'^~(_OQ~~(bP;=`<%l'^~(jOS~~(mQ!Q!R(s!R![*p~(xUY~!O!P)[!Q![*p!g!h){#R#S+U#X#Y){#l#m+[~)aRY~!Q![)j!g!h){#X#Y){~)oSY~!Q![)j!g!h){#R#S*j#X#Y){~*OR{|*X}!O*X!Q![*_~*[P!Q![*_~*dQY~!Q![*_#R#S*X~*mP!Q![)j~*uTY~!O!P)[!Q![*p!g!h){#R#S+U#X#Y){~+XP!Q![*p~+_R!Q![+h!c!i+h#T#Z+h~+mVY~!O!P,S!Q![+h!c!i+h!r!s-P#R#S+[#T#Z+h#d#e-P~,XTY~!Q![,h!c!i,h!r!s-P#T#Z,h#d#e-P~,mUY~!Q![,h!c!i,h!r!s-P#R#S.Q#T#Z,h#d#e-P~-ST{|-c}!O-c!Q![-o!c!i-o#T#Z-o~-fR!Q![-o!c!i-o#T#Z-o~-tSY~!Q![-o!c!i-o#R#S-c#T#Z-o~.TR!Q![,h!c!i,h#T#Z,h~.aP!]!^.d~.iSP~OY.dZ;'S.d;'S;=`.u<%lO.d~.xP;=`<%l.d~/QiX~qr.{st.{tu.{uv.{vw.{wx.{z{.{{|.{}!O.{!O!P.{!P!Q.{!Q![.{![!].{!^!_.{!_!`.{!`!a.{!a!b.{!b!c.{!c!}.{#Q#R.{#R#S.{#S#T.{#T#o.{#p#q.{#r#s.{",tokenizers:[0],topRules:{Module:[0,3]},specialized:[{term:9,get:o=>S[o]||-1}],tokenPrec:0}),i=b.define({name:"wast",parser:Q.configure({props:[r.add({App:s({closing:")",align:!1})}),a.add({App:t,BlockComment(o){return{from:o.from+2,to:o.to-2}}}),P({Keyword:e.keyword,Type:e.typeName,Number:e.number,String:e.string,Identifier:e.variableName,LineComment:e.lineComment,BlockComment:e.blockComment,"( )":e.paren})]}),languageData:{commentTokens:{line:";;",block:{open:"(;",close:";)"}},closeBrackets:{brackets:["(",'"']}}});function d(){return new O(i)}export{d as wast,i as wastLanguage};

package/app/dist/index.html

@@ -4,7 +4,7 @@
 		<meta charset="utf-8" />
 		<meta name="viewport" content="width=device-width, initial-scale=1" />
 		<title>refrakt editor</title>
-		<script type="module" crossorigin src="/assets/index-ogrpJNou.js"></script>
+		<script type="module" crossorigin src="/assets/index-Y1_ZkrfC.js"></script>
 		<link rel="stylesheet" crossorigin href="/assets/index-CzvG5PZT.css">
 	</head>
 	<body>

package/app/src/lib/api/client.ts

@@ -288,6 +288,7 @@ export interface RuneInfo {
 	category: string;
 	attributes: Record<string, RuneAttributeInfo>;
 	example?: string;
+	snippet?: string[];
 	contentModel?: SerializedContentModel;
 }
 

package/app/src/lib/editor/attribute-completion.ts

@@ -0,0 +1,159 @@
+import {
+	type CompletionContext,
+	type CompletionResult,
+	type CompletionSource,
+} from '@codemirror/autocomplete';
+import type { RuneInfo } from '../api/client.js';
+
+type AggregatedData = Record<string, unknown>;
+
+/**
+ * Find the Markdoc tag context at the cursor position.
+ * Returns the tag name and whether we're completing an attribute value.
+ */
+function findTagContext(
+	doc: string,
+	pos: number,
+): { tagName: string; attrName?: string; valueStart?: number } | null {
+	const before = doc.slice(Math.max(0, pos - 500), pos);
+
+	const lastClose = before.lastIndexOf('%}');
+	const lastOpen = before.lastIndexOf('{%');
+
+	if (lastOpen === -1 || (lastClose !== -1 && lastClose > lastOpen)) {
+		return null;
+	}
+
+	const tagContent = before.slice(lastOpen + 2).trimStart();
+
+	if (tagContent.startsWith('/')) return null;
+
+	const nameMatch = tagContent.match(/^(\w[\w-]*)/);
+	if (!nameMatch) return null;
+	const tagName = nameMatch[1];
+
+	const afterName = tagContent.slice(nameMatch[0].length);
+
+	// Check if we're inside an attribute value: attr="...
+	const valueMatch = afterName.match(/(\w[\w-]*)="[^"]*$/);
+	if (valueMatch) {
+		const quoteIdx = before.lastIndexOf('="');
+		return {
+			tagName,
+			attrName: valueMatch[1],
+			valueStart: Math.max(0, pos - 500) + quoteIdx + 2,
+		};
+	}
+
+	return { tagName };
+}
+
+/**
+ * Returns dynamic completion values for a given rune + attribute combination.
+ * Currently supports:
+ *   - sandbox.context  → design-context scope names
+ *   - design-context.scope → existing scope names (to warn of collisions)
+ */
+function getDynamicValues(tagName: string, attrName: string, aggregated: AggregatedData): string[] {
+	const design = aggregated['design'] as { contexts?: Record<string, unknown> } | undefined;
+	if (!design?.contexts) return [];
+	const scopes = Object.keys(design.contexts);
+	if ((tagName === 'sandbox' && attrName === 'context') ||
+		(tagName === 'design-context' && attrName === 'scope')) {
+		return scopes;
+	}
+	return [];
+}
+
+/**
+ * Creates a CompletionSource for Markdoc tag attribute names and values.
+ * Accepts getter functions so runes and aggregated data are read at query time.
+ */
+export function attributeCompletionSource(
+	getRunes: () => RuneInfo[],
+	getAggregated?: () => AggregatedData,
+): CompletionSource {
+	return (context: CompletionContext): CompletionResult | null => {
+		const doc = context.state.doc.toString();
+		const pos = context.pos;
+
+		const tagCtx = findTagContext(doc, pos);
+		if (!tagCtx) return null;
+
+		const runes = getRunes();
+		const runeMap = new Map<string, RuneInfo>();
+		for (const r of runes) {
+			runeMap.set(r.name, r);
+			for (const alias of r.aliases) {
+				runeMap.set(alias, r);
+			}
+		}
+
+		const rune = runeMap.get(tagCtx.tagName);
+		if (!rune) return null;
+
+		// Completing attribute value
+		if (tagCtx.attrName && tagCtx.valueStart !== undefined) {
+			const attr = rune.attributes[tagCtx.attrName];
+
+			// Try static enum values first
+			if (attr?.values?.length) {
+				return {
+					from: tagCtx.valueStart,
+					options: attr.values.map((v) => ({
+						label: v,
+						type: 'enum',
+					})),
+					filter: true,
+				};
+			}
+
+			// Fall back to dynamic values from aggregated data
+			const dynamic = getAggregated
+				? getDynamicValues(tagCtx.tagName, tagCtx.attrName, getAggregated())
+				: [];
+			if (dynamic.length) {
+				return {
+					from: tagCtx.valueStart,
+					options: dynamic.map((v) => ({
+						label: v,
+						type: 'variable',
+					})),
+					filter: true,
+				};
+			}
+
+			return null;
+		}
+
+		// Completing attribute name
+		const word = context.matchBefore(/\w*/);
+		if (!word) return null;
+
+		if (!context.explicit && word.from === word.to) return null;
+
+		// Get already-used attributes
+		const before = doc.slice(Math.max(0, pos - 500), pos);
+		const usedAttrs = new Set(
+			[...before.matchAll(/(\w[\w-]*)="/g)].map((m) => m[1]),
+		);
+
+		const options = Object.entries(rune.attributes)
+			.filter(([name]) => !usedAttrs.has(name))
+			.map(([name, attr]) => ({
+				label: name,
+				detail: attr.required ? 'required' : undefined,
+				type: 'property' as const,
+				apply: `${name}="`,
+				boost: attr.required ? 1 : 0,
+			}));
+
+		if (options.length === 0) return null;
+
+		return {
+			from: word.from,
+			options,
+			filter: true,
+		};
+	};
+}

package/app/src/lib/editor/codemirror-theme.ts

@@ -0,0 +1,115 @@
+import { EditorView } from '@codemirror/view';
+import { HighlightStyle } from '@codemirror/language';
+import { tags } from '@lezer/highlight';
+
+export const lightTheme = EditorView.theme(
+	{
+		'&': {
+			backgroundColor: '#f8fafc',
+			color: '#1a1a2e',
+			fontSize: '13px',
+			height: '100%',
+		},
+		'.cm-scroller': {
+			overflow: 'auto',
+			fontFamily: "'SF Mono', 'Fira Code', ui-monospace, monospace",
+			lineHeight: '1.6',
+		},
+		'.cm-content': {
+			padding: '1rem 0',
+			caretColor: '#1e293b',
+		},
+		'.cm-gutters': {
+			backgroundColor: '#f8fafc',
+			color: '#94a3b8',
+			border: 'none',
+			paddingRight: '0.5rem',
+		},
+		'.cm-activeLineGutter': {
+			backgroundColor: '#e2e8f0',
+			color: '#64748b',
+		},
+		'.cm-activeLine': {
+			backgroundColor: 'rgba(0, 0, 0, 0.03)',
+		},
+		'.cm-cursor': {
+			borderLeftColor: '#1e293b',
+		},
+		'&.cm-focused .cm-selectionBackground, ::selection': {
+			backgroundColor: 'rgba(14, 165, 233, 0.2)',
+		},
+		'.cm-selectionBackground': {
+			backgroundColor: 'rgba(14, 165, 233, 0.12)',
+		},
+		'&.cm-focused': {
+			outline: 'none',
+		},
+		// Autocomplete dropdown styling
+		'.cm-tooltip.cm-tooltip-autocomplete': {
+			border: '1px solid #e2e8f0',
+			borderRadius: '6px',
+			boxShadow: '0 8px 24px rgba(0, 0, 0, 0.12)',
+			backgroundColor: '#ffffff',
+			overflow: 'hidden',
+		},
+		'.cm-tooltip.cm-tooltip-autocomplete ul': {
+			fontFamily: 'system-ui, -apple-system, sans-serif',
+			fontSize: '12px',
+			maxHeight: '280px',
+		},
+		'.cm-tooltip.cm-tooltip-autocomplete ul li': {
+			padding: '4px 8px',
+			borderBottom: '1px solid #f1f5f9',
+		},
+		'.cm-tooltip.cm-tooltip-autocomplete ul li[aria-selected]': {
+			backgroundColor: '#f0f9ff',
+			color: '#0369a1',
+		},
+		'.cm-tooltip.cm-completionInfo': {
+			border: '1px solid #e2e8f0',
+			borderRadius: '6px',
+			boxShadow: '0 4px 12px rgba(0, 0, 0, 0.08)',
+			backgroundColor: '#ffffff',
+			padding: '6px 10px',
+			fontFamily: 'system-ui, -apple-system, sans-serif',
+			fontSize: '12px',
+			color: '#475569',
+			maxWidth: '300px',
+		},
+		'.cm-completionDetail': {
+			color: '#94a3b8',
+			fontStyle: 'normal',
+			marginLeft: '0.5em',
+		},
+		// Markdoc tag highlighting
+		'.cm-markdoc-tag': {
+			backgroundColor: 'rgba(217, 119, 6, 0.06)',
+			borderRadius: '2px',
+		},
+		'.cm-markdoc-bracket': {
+			color: '#94a3b8',
+		},
+		'.cm-markdoc-name': {
+			color: '#d97706',
+			fontWeight: '600',
+		},
+	},
+	{ dark: false },
+);
+
+export const highlightTheme = HighlightStyle.define([
+	{ tag: tags.heading1, color: '#0369a1', fontWeight: 'bold', fontSize: '1.4em' },
+	{ tag: tags.heading2, color: '#0369a1', fontWeight: 'bold', fontSize: '1.2em' },
+	{ tag: tags.heading3, color: '#0369a1', fontWeight: 'bold', fontSize: '1.1em' },
+	{ tag: tags.heading, color: '#0369a1', fontWeight: 'bold' },
+	{ tag: tags.emphasis, color: '#9333ea', fontStyle: 'italic' },
+	{ tag: tags.strong, color: '#9333ea', fontWeight: 'bold' },
+	{ tag: tags.link, color: '#0ea5e9', textDecoration: 'underline' },
+	{ tag: tags.url, color: '#0ea5e9' },
+	{ tag: tags.quote, color: '#64748b' },
+	{ tag: tags.monospace, color: '#16a34a' },
+	{ tag: tags.processingInstruction, color: '#d97706' },
+	{ tag: tags.meta, color: '#94a3b8' },
+	{ tag: tags.comment, color: '#94a3b8' },
+	{ tag: tags.punctuation, color: '#94a3b8' },
+]);

package/app/src/lib/editor/content-model-resolver.ts

@@ -0,0 +1,196 @@
+/**
+ * Client-side content model resolver.
+ *
+ * Matches parsed ContentNodes (from parseContentTree) against a serialized
+ * content model to determine which fields are filled and which are empty.
+ */
+
+import type { ContentNode } from './block-parser.js';
+import type {
+	SerializedContentModel,
+	SerializedFieldDef,
+	SerializedSequenceModel,
+	SerializedDelimitedZone,
+} from '../api/client.js';
+
+// ---------------------------------------------------------------------------
+// Output types
+// ---------------------------------------------------------------------------
+
+export interface ResolvedField {
+	/** Field name from the content model */
+	name: string;
+	/** Expected node type pattern (e.g. 'paragraph', 'heading', 'list|fence') */
+	match: string;
+	/** Whether the field can be absent */
+	optional: boolean;
+	/** Whether the field consumes multiple consecutive matches */
+	greedy: boolean;
+	/** Whether content was matched to this field */
+	filled: boolean;
+	/** Matched content nodes (empty if unfilled) */
+	nodes: ContentNode[];
+	/** Human-readable description from field definition */
+	description?: string;
+	/** Markdoc template for inserting content */
+	template?: string;
+	/** If field emits child rune tags */
+	emitTag?: string;
+}
+
+export interface ResolvedZone {
+	name: string;
+	fields: ResolvedField[];
+}
+
+export type ResolvedStructure =
+	| { type: 'sequence'; fields: ResolvedField[] }
+	| { type: 'delimited'; delimiter: string; zones: ResolvedZone[] }
+	| { type: 'sections'; description: string }
+	| { type: 'custom'; description: string };
+
+// ---------------------------------------------------------------------------
+// Node matching
+// ---------------------------------------------------------------------------
+
+/** Check if a ContentNode matches a field's match pattern */
+function nodeMatchesType(node: ContentNode, match: string): boolean {
+	if (match === 'any') return true;
+
+	// Pipe-separated alternatives: 'list|fence'
+	if (match.includes('|')) {
+		return match.split('|').some(m => nodeMatchesType(node, m));
+	}
+
+	// heading:N
+	if (match.startsWith('heading:')) {
+		const level = parseInt(match.slice(8), 10);
+		return node.type === 'heading' && node.headingLevel === level;
+	}
+
+	// list:ordered / list:unordered
+	if (match === 'list:ordered') {
+		return node.type === 'list' && node.listOrdered === true;
+	}
+	if (match === 'list:unordered') {
+		return node.type === 'list' && node.listOrdered !== true;
+	}
+
+	// tag:NAME — ContentNodes use 'rune' type
+	if (match.startsWith('tag:')) {
+		const tagName = match.slice(4);
+		return node.type === 'rune' && node.runeName === tagName;
+	}
+
+	// Simple type match (ContentNode types: rune, heading, paragraph, fence, list, quote, hr, image)
+	// Map content model match names to ContentNode type names
+	if (match === 'blockquote') return node.type === 'quote';
+
+	return node.type === match;
+}
+
+// ---------------------------------------------------------------------------
+// Sequence resolver
+// ---------------------------------------------------------------------------
+
+function resolveSequence(nodes: ContentNode[], fields: SerializedFieldDef[]): ResolvedField[] {
+	const result: ResolvedField[] = [];
+	let cursor = 0;
+
+	for (const field of fields) {
+		const resolved: ResolvedField = {
+			name: field.name,
+			match: field.match,
+			optional: field.optional ?? false,
+			greedy: field.greedy ?? false,
+			filled: false,
+			nodes: [],
+			description: field.description,
+			template: field.template,
+			emitTag: field.emitTag,
+		};
+
+		if (field.greedy) {
+			// Consume all consecutive matching nodes
+			while (cursor < nodes.length && nodeMatchesType(nodes[cursor], field.match)) {
+				resolved.nodes.push(nodes[cursor]);
+				cursor++;
+			}
+			resolved.filled = resolved.nodes.length > 0;
+		} else {
+			// Match the next node if it fits
+			if (cursor < nodes.length && nodeMatchesType(nodes[cursor], field.match)) {
+				resolved.nodes.push(nodes[cursor]);
+				resolved.filled = true;
+				cursor++;
+			}
+		}
+
+		result.push(resolved);
+	}
+
+	return result;
+}
+
+// ---------------------------------------------------------------------------
+// Main resolver
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve a content tree against a serialized content model.
+ * Returns a structure describing which fields are filled and which are empty.
+ */
+export function resolveContentStructure(
+	nodes: ContentNode[],
+	model: SerializedContentModel,
+): ResolvedStructure {
+	switch (model.type) {
+		case 'sequence':
+			return {
+				type: 'sequence',
+				fields: resolveSequence(nodes, model.fields),
+			};
+
+		case 'delimited': {
+			// Split nodes at delimiter (hr) boundaries
+			const zones: ResolvedZone[] = [];
+			const chunks: ContentNode[][] = [[]];
+			for (const node of nodes) {
+				if (node.type === 'hr') {
+					chunks.push([]);
+				} else {
+					chunks[chunks.length - 1].push(node);
+				}
+			}
+
+			if (model.zones) {
+				for (let i = 0; i < model.zones.length; i++) {
+					const zone = model.zones[i];
+					const chunk = chunks[i] ?? [];
+					zones.push({
+						name: zone.name,
+						fields: resolveSequence(chunk, zone.fields),
+					});
+				}
+			} else if (model.dynamicZones && model.zoneModel) {
+				for (let i = 0; i < chunks.length; i++) {
+					zones.push({
+						name: `zone-${i + 1}`,
+						fields: resolveSequence(chunks[i], model.zoneModel.fields),
+					});
+				}
+			}
+
+			return { type: 'delimited', delimiter: model.delimiter, zones };
+		}
+
+		case 'sections':
+			return {
+				type: 'sections',
+				description: `Sections split by ${model.sectionHeading}${model.emitTag ? `, each emits ${model.emitTag}` : ''}`,
+			};
+
+		case 'custom':
+			return { type: 'custom', description: model.description };
+	}
+}