@seedprotocol/mapping 0.5.3

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.5.1
+
+- Initial Phase 1 release: headless mapping core, markdown + RSS adapters, `FieldMapper` UI.

package/README.md

@@ -0,0 +1,105 @@
+# @seedprotocol/mapping
+
+Source → Seed model property mapping helpers and a props-driven React UI.
+
+Use this package to:
+
+1. Parse markdown or RSS/Atom into `SourceNode[]`
+2. Author 1:1 `FieldMapping`s (manually, via `autoMap`, or via `FieldMapper`)
+3. `applyMapping` to a coerced property bag for `createItem` / publish
+
+## Install
+
+```bash
+bun add @seedprotocol/mapping
+```
+
+Peers: `react`, `react-dom`. RSS parsing uses `rss-parser` with the same custom fields as `@seedprotocol/feed` `parseRssString` (aligned, no hard dependency on the feed package barrel).
+
+## Headless API
+
+```ts
+import {
+  markdownToSources,
+  rssXmlToSources,
+  autoMap,
+  applyMapping,
+  type TargetProperty,
+  type MappingDocument,
+} from '@seedprotocol/mapping'
+
+const sources = markdownToSources(markdown)
+const targets: TargetProperty[] = [
+  { name: 'title', dataType: 'String' },
+  { name: 'body', dataType: 'Text' },
+]
+const mappings = autoMap(sources, targets)
+const properties = applyMapping(sources, mappings, targets)
+
+const doc: MappingDocument = {
+  version: 1,
+  sourceKind: 'markdown',
+  mappings,
+}
+```
+
+RSS:
+
+```ts
+const { channel, items } = await rssXmlToSources(xml)
+const itemSources = items[0]!
+const mappings = autoMap(itemSources, postTargets)
+const properties = applyMapping(itemSources, mappings, postTargets)
+```
+
+## FieldMapper UI
+
+Props-driven only — no Seed hooks or routing. The host app supplies sources/targets and handles create/navigate.
+
+```tsx
+import { useState } from 'react'
+import {
+  FieldMapper,
+  markdownToSources,
+  applyMapping,
+  type FieldMapping,
+} from '@seedprotocol/mapping'
+
+function ImportMap({ markdown, targets, onSubmit }) {
+  const sources = markdownToSources(markdown)
+  const [mappings, setMappings] = useState<FieldMapping[]>([])
+
+  return (
+    <>
+      <FieldMapper
+        sources={sources}
+        targets={targets}
+        mappings={mappings}
+        onChange={setMappings}
+      />
+      <button
+        onClick={() => onSubmit(applyMapping(sources, mappings, targets))}
+      >
+        Create
+      </button>
+    </>
+  )
+}
+```
+
+## Relationship to `FeedFieldManifest`
+
+| Type | Package | Meaning |
+|------|---------|---------|
+| `FieldMapping` / `MappingDocument` | `@seedprotocol/mapping` | Source id → **model property name** |
+| `FeedFieldManifest` | `@seedprotocol/sdk` | Property/key → **role** (`image` / `html` / `text`) for `normalizeFeedItemFields` |
+
+Compose them: map external fields into a plain item, then optionally normalize roles for media/HTML display.
+
+## Phase 1 limits
+
+- Markdown: flat YAML frontmatter; `#` / `##` sections only
+- RSS: top-level item fields via `parseRssString` (no general XPath)
+- UI: self-contained dark theme; no desktop/Tailwind coupling
+
+See [MAPPING_PHASE2.md](../../docs/MAPPING_PHASE2.md) for consumer migration and hardening.

package/dist/adapters/markdown.d.ts

@@ -0,0 +1,34 @@
+import type { SourceNode } from '../types';
+export declare const SECTION_FULL_ID = "section-full";
+type FrontmatterField = {
+    id: string;
+    key: string;
+    value: string;
+    valueType: 'string' | 'boolean' | 'array';
+};
+type ParsedMarkdown = {
+    frontmatter: FrontmatterField[];
+    body: string;
+};
+type MarkdownSection = {
+    id: string;
+    heading: string;
+    level: number;
+    content: string;
+};
+/**
+ * Parse YAML-like frontmatter (flat keys only) and body.
+ * Mirrors desktop MarkdownMapper limits: no nested YAML.
+ */
+export declare function parseMarkdownWithFrontmatter(markdownContent: string): ParsedMarkdown;
+/**
+ * Split markdown body into H1/H2 sections (###+ ignored as section breaks).
+ */
+export declare function parseMarkdownSections(md: string): MarkdownSection[];
+/**
+ * Convert markdown into SourceNodes for FieldMapper / applyMapping.
+ * Order: frontmatter fields, full document body, then H1/H2 sections.
+ */
+export declare function markdownToSources(markdown: string): SourceNode[];
+export {};
+//# sourceMappingURL=markdown.d.ts.map

package/dist/adapters/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/adapters/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;CAC1C,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,GACtB,cAAc,CAqEhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,EAAE,CA+BnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAmChE"}

package/dist/adapters/rss.d.ts

@@ -0,0 +1,28 @@
+import type { SourceNode } from '../types';
+export type ParsedRssChannel = {
+    title?: string;
+    link?: string;
+    description?: string;
+    /** Plain serializable item records (dates become ISO strings). */
+    items: Record<string, unknown>[];
+};
+/**
+ * Flatten a parsed RSS/Atom item into SourceNodes (one per string-coercible key).
+ * Stable ids: `rss-{key}`.
+ */
+export declare function rssItemToSources(item: Record<string, unknown>): SourceNode[];
+export type RssXmlSourcesResult = {
+    channel: {
+        title?: string;
+        link?: string;
+        description?: string;
+    };
+    /** Source nodes for each feed item, in document order. */
+    items: SourceNode[][];
+};
+/**
+ * Parse RSS/Atom XML and map each item to SourceNodes via rssItemToSources.
+ * Compatible with @seedprotocol/feed `parseRssString` field set.
+ */
+export declare function rssXmlToSources(xml: string): Promise<RssXmlSourcesResult>;
+//# sourceMappingURL=rss.d.ts.map

package/dist/adapters/rss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss.d.ts","sourceRoot":"","sources":["../../src/adapters/rss.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CACjC,CAAA;AAiED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,EAAE,CAoB5E;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,0DAA0D;IAC1D,KAAK,EAAE,UAAU,EAAE,EAAE,CAAA;CACtB,CAAA;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,CAU9B"}

package/dist/applyMapping.d.ts

@@ -0,0 +1,11 @@
+import type { FieldMapping, PropertyBag, SourceNode, TargetProperty } from './types';
+/**
+ * Coerce a raw string value to the Seed model property dataType.
+ */
+export declare function coerceValue(rawValue: string, dataType: string): unknown;
+/**
+ * Apply field mappings to produce a property bag for createItem / publish.
+ * Missing sources or unknown target properties are skipped (no throw).
+ */
+export declare function applyMapping(sources: SourceNode[], mappings: FieldMapping[], targets: TargetProperty[]): PropertyBag;
+//# sourceMappingURL=applyMapping.d.ts.map

package/dist/applyMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyMapping.d.ts","sourceRoot":"","sources":["../src/applyMapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuBvE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,UAAU,EAAE,EACrB,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,cAAc,EAAE,GACxB,WAAW,CAeb"}

package/dist/autoMap.d.ts

@@ -0,0 +1,8 @@
+import type { FieldMapping, SourceNode, TargetProperty } from './types';
+/**
+ * Heuristic auto-map: full-document sources to body-like props,
+ * then fuzzy name match for remaining sources ↔ targets.
+ * Returns 1:1 mappings (each source and property used at most once).
+ */
+export declare function autoMap(sources: SourceNode[], targets: TargetProperty[]): FieldMapping[];
+//# sourceMappingURL=autoMap.d.ts.map

package/dist/autoMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoMap.d.ts","sourceRoot":"","sources":["../src/autoMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAcvE;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,cAAc,EAAE,GACxB,YAAY,EAAE,CAsEhB"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { SourceKind, SourceNode, TargetProperty, FieldMapping, MappingDocument, PropertyBag, } from './types';
+export { applyMapping, coerceValue } from './applyMapping';
+export { autoMap } from './autoMap';
+export { markdownToSources, parseMarkdownWithFrontmatter, parseMarkdownSections, SECTION_FULL_ID, } from './adapters/markdown';
+export { rssItemToSources, rssXmlToSources, type RssXmlSourcesResult, } from './adapters/rss';
+export { FieldMapper, type FieldMapperProps } from './react/FieldMapper';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,544 @@
+import e from "rss-parser";
+import { useCallback as t, useEffect as n, useMemo as r, useRef as i, useState as a } from "react";
+import { jsx as o, jsxs as s } from "react/jsx-runtime";
+//#region src/applyMapping.ts
+function c(e, t) {
+	if (t === "Number") return parseFloat(String(e)) || 0;
+	if (t === "Boolean") return e === "true" || e === "1" || String(e).toLowerCase() === "yes";
+	if (t === "Json") try {
+		return JSON.parse(e);
+	} catch {
+		return e;
+	}
+	if (t === "Date") {
+		let t = new Date(String(e));
+		return Number.isNaN(t.getTime()) ? e : t.getTime();
+	}
+	return String(e ?? "");
+}
+function l(e, t, n) {
+	let r = new Map(e.map((e) => [e.id, e])), i = new Map(n.map((e) => [e.name, e])), a = {};
+	for (let e of t) {
+		let t = r.get(e.sourceId), n = i.get(e.propertyName);
+		if (!t || !n) continue;
+		let o = t.value || t.label;
+		a[e.propertyName] = c(o, n.dataType);
+	}
+	return a;
+}
+//#endregion
+//#region src/autoMap.ts
+var u = [
+	"text",
+	"content",
+	"body",
+	"fulltext",
+	"markdown"
+];
+function d(e) {
+	return e.toLowerCase().replace(/\s+/g, "").replace(/[:_-]/g, "");
+}
+function f(e, t) {
+	let n = d(e), r = d(t);
+	return n === r || n.includes(r) || r.includes(n);
+}
+function p(e, t) {
+	let n = [], r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), a = e.find((e) => e.kind === "full");
+	if (a) {
+		let e = t.find((e) => u.includes(e.name.toLowerCase()));
+		e && (n.push({
+			sourceId: a.id,
+			propertyName: e.name
+		}), r.add(e.name), i.add(a.id));
+	}
+	let o = {
+		title: [
+			"title",
+			"name",
+			"headline"
+		],
+		"content:encoded": [
+			"html",
+			"content",
+			"body",
+			"text"
+		],
+		content: [
+			"html",
+			"content",
+			"body",
+			"text"
+		],
+		description: [
+			"summary",
+			"description",
+			"excerpt"
+		],
+		summary: [
+			"summary",
+			"description",
+			"excerpt"
+		],
+		featureimage: [
+			"featureimage",
+			"feature_image",
+			"image",
+			"cover"
+		],
+		feature_image: [
+			"featureimage",
+			"feature_image",
+			"image",
+			"cover"
+		],
+		link: [
+			"url",
+			"link",
+			"permalink",
+			"slug"
+		],
+		creator: [
+			"author",
+			"authors",
+			"creator",
+			"byline"
+		],
+		author: [
+			"author",
+			"authors",
+			"creator",
+			"byline"
+		]
+	};
+	for (let a of e) {
+		if (i.has(a.id)) continue;
+		let e = d(a.label), s = a.id.replace(/^rss-/, "").replace(/^fm-/, ""), c = [
+			...o[a.label] ?? [],
+			...o[s] ?? [],
+			...o[e] ?? []
+		], l;
+		for (let e of c) if (l = t.find((t) => !r.has(t.name) && f(t.name, e)), l) break;
+		l ||= t.find((e) => !r.has(e.name) && (f(e.name, a.label) || f(e.name, s))), l && (n.push({
+			sourceId: a.id,
+			propertyName: l.name
+		}), r.add(l.name), i.add(a.id));
+	}
+	return n;
+}
+//#endregion
+//#region src/adapters/markdown.ts
+var m = "section-full";
+function h(e) {
+	try {
+		let t = e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+		if (!t) return {
+			frontmatter: [],
+			body: e
+		};
+		let n = t[1] ?? "", r = (t[2] ?? "").trimStart(), i = [], a = {};
+		for (let e of n.split("\n")) {
+			let t = e.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*)$/);
+			if (!t) continue;
+			let n = t[1], r = t[2].trim(), i = r;
+			if (r === "true") i = !0;
+			else if (r === "false") i = !1;
+			else if (r === "null" || r === "") i = null;
+			else if (r.startsWith("[") && r.endsWith("]")) try {
+				i = JSON.parse(r.replace(/'/g, "\""));
+			} catch {
+				i = r.slice(1, -1).split(",").map((e) => e.trim().replace(/^['"]|['"]$/g, ""));
+			}
+			else (r.startsWith("\"") || r.startsWith("'")) && (i = r.slice(1, -1).replace(/\\"/g, "\""));
+			a[n] = i;
+		}
+		for (let [e, t] of Object.entries(a)) {
+			let n = "string", r;
+			Array.isArray(t) ? (n = "array", r = t.map((e) => typeof e == "object" ? JSON.stringify(e) : String(e)).join(", ")) : typeof t == "boolean" ? (n = "boolean", r = String(t)) : r = typeof t == "object" && t ? JSON.stringify(t) : t == null ? "" : String(t), i.push({
+				id: `fm-${e}`,
+				key: e,
+				value: r,
+				valueType: n
+			});
+		}
+		return {
+			frontmatter: i,
+			body: r
+		};
+	} catch {
+		return {
+			frontmatter: [],
+			body: e
+		};
+	}
+}
+function g(e) {
+	let t = e.split("\n"), n = [], r = null;
+	for (let e of t) {
+		let t = e.match(/^## (.+)/), i = e.match(/^# (.+)/);
+		i ? (r && n.push(r), r = {
+			id: `section-${n.length}`,
+			heading: i[1],
+			level: 1,
+			content: ""
+		}) : t ? (r && n.push(r), r = {
+			id: `section-${n.length}`,
+			heading: t[1],
+			level: 2,
+			content: ""
+		}) : r && (r.content += (r.content ? "\n" : "") + e);
+	}
+	return r && n.push(r), n;
+}
+function _(e) {
+	let t = h(e), n = g(t.body), r = [];
+	for (let e of t.frontmatter) r.push({
+		id: e.id,
+		label: e.key,
+		kind: "frontmatter",
+		value: e.value,
+		meta: { valueType: e.valueType }
+	});
+	r.push({
+		id: m,
+		label: "Full document",
+		kind: "full",
+		value: t.body
+	});
+	for (let e of n) {
+		let t = e.content.trim().length > 0 ? e.content.trim() : e.heading;
+		r.push({
+			id: e.id,
+			label: e.heading,
+			kind: "section",
+			value: t,
+			meta: { level: e.level }
+		});
+	}
+	return r;
+}
+//#endregion
+//#region src/adapters/rss.ts
+function v(e) {
+	try {
+		return JSON.parse(JSON.stringify(e));
+	} catch {
+		return { ...e };
+	}
+}
+var y = new e({ customFields: { item: [
+	"featureImage",
+	"feature_image",
+	"content:encoded",
+	"seedUid",
+	"SeedUid"
+] } });
+async function b(e) {
+	let t = await y.parseString(e);
+	return {
+		title: t.title,
+		link: t.link,
+		description: t.description,
+		items: (t.items ?? []).map(v)
+	};
+}
+function x(e) {
+	if (e == null) return null;
+	if (typeof e == "string") {
+		let t = e.trim();
+		return t.length > 0 ? t : null;
+	}
+	if (typeof e == "number" || typeof e == "boolean") return String(e);
+	if (Array.isArray(e)) try {
+		return JSON.stringify(e);
+	} catch {
+		return null;
+	}
+	if (typeof e == "object") {
+		let t = e;
+		if (typeof t._ == "string" && t._.trim()) return t._.trim();
+		if (typeof t.value == "string" && t.value.trim()) return t.value.trim();
+		try {
+			return JSON.stringify(e);
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+function S(e) {
+	let t = [], n = /* @__PURE__ */ new Set();
+	for (let [r, i] of Object.entries(e)) {
+		if (r === "items" || r.startsWith("$")) continue;
+		let e = x(i);
+		e != null && (n.has(r) || (n.add(r), t.push({
+			id: `rss-${r}`,
+			label: r,
+			kind: "rssField",
+			value: e
+		})));
+	}
+	return t;
+}
+async function C(e) {
+	let t = await b(e);
+	return {
+		channel: {
+			title: t.title,
+			link: t.link,
+			description: t.description
+		},
+		items: t.items.map((e) => S(e))
+	};
+}
+//#endregion
+//#region src/react/FieldMapper.tsx
+var w = [
+	"#3b82f6",
+	"#8b5cf6",
+	"#ec4899",
+	"#f59e0b",
+	"#10b981",
+	"#06b6d4",
+	"#f97316",
+	"#14b8a6"
+], T = {
+	String: {
+		bg: "rgba(59,130,246,0.12)",
+		border: "#3b82f6",
+		text: "#93c5fd"
+	},
+	Text: {
+		bg: "rgba(59,130,246,0.12)",
+		border: "#3b82f6",
+		text: "#93c5fd"
+	},
+	Number: {
+		bg: "rgba(16,185,129,0.12)",
+		border: "#10b981",
+		text: "#6ee7b7"
+	},
+	Boolean: {
+		bg: "rgba(167,139,250,0.12)",
+		border: "#a78bfa",
+		text: "#c4b5fd"
+	},
+	Json: {
+		bg: "rgba(251,191,36,0.12)",
+		border: "#fbbf24",
+		text: "#fcd34d"
+	},
+	Date: {
+		bg: "rgba(244,114,182,0.12)",
+		border: "#f472b6",
+		text: "#f9a8d4"
+	},
+	Relation: {
+		bg: "rgba(34,211,238,0.12)",
+		border: "#22d3ee",
+		text: "#67e8f9"
+	}
+};
+function E(e) {
+	return T[e] ?? {
+		bg: "rgba(148,163,184,0.12)",
+		border: "#94a3b8",
+		text: "#cbd5e1"
+	};
+}
+function D(e, t) {
+	let n = e.replace(/\s+/g, " ").trim();
+	return n.length <= t ? n : `${n.slice(0, t)}…`;
+}
+function O({ sources: e, targets: c, mappings: u, onChange: d, onAutoMap: f, className: m, showPreview: h = !0 }) {
+	let [g, _] = a(null), [v, y] = a(null), [b, x] = a(null), [S, C] = a(!1), [T, O] = a({
+		width: 0,
+		height: 0
+	}), [k, A] = a([]), j = i(null), M = i({}), N = i({}), P = t((e) => w[e % w.length], []), F = t(() => {
+		if (!j.current) return [];
+		let e = j.current.getBoundingClientRect();
+		return u.map((t, n) => {
+			let r = M.current[t.sourceId], i = N.current[t.propertyName];
+			if (!r || !i) return null;
+			let a = r.getBoundingClientRect(), o = i.getBoundingClientRect();
+			return {
+				x1: a.right - e.left,
+				y1: a.top + a.height / 2 - e.top,
+				x2: o.left - e.left,
+				y2: o.top + o.height / 2 - e.top,
+				color: P(n),
+				mapping: t
+			};
+		}).filter((e) => e !== null);
+	}, [u, P]);
+	n(() => {
+		let e = () => {
+			if (j.current) {
+				let e = j.current.getBoundingClientRect();
+				O({
+					width: e.width,
+					height: e.height
+				});
+			}
+			A(F());
+		};
+		e(), window.addEventListener("resize", e);
+		let t = setInterval(e, 200);
+		return () => {
+			window.removeEventListener("resize", e), clearInterval(t);
+		};
+	}, [
+		F,
+		u,
+		e,
+		c
+	]);
+	let I = (e) => {
+		_((t) => t === e ? null : e);
+	}, L = (e) => {
+		if (!g) return;
+		let t = [...u];
+		t = t.filter((t) => t.sourceId !== g && t.propertyName !== e), t.push({
+			sourceId: g,
+			propertyName: e
+		}), d(t), _(null);
+	}, R = (e) => {
+		d(u.filter((t) => t.sourceId !== e));
+	}, z = (e) => u.find((t) => t.sourceId === e), B = (e) => u.find((t) => t.propertyName === e), V = v ? u.find((e) => e.propertyName === v) : b ? u.find((e) => e.sourceId === b) : null, H = r(() => l(e, u, c), [
+		e,
+		u,
+		c
+	]);
+	return /* @__PURE__ */ s("div", {
+		className: `seed-field-mapper ${m ?? ""}`.trim(),
+		children: [
+			/* @__PURE__ */ o("style", { children: "\n        .seed-field-mapper {\n          font-family: 'DM Sans', system-ui, sans-serif;\n          color: #e2e8f0;\n          background: #0f172a;\n          border-radius: 12px;\n          padding: 16px;\n        }\n        .seed-field-mapper * { box-sizing: border-box; }\n        .seed-field-mapper .fm-toolbar {\n          display: flex;\n          gap: 8px;\n          align-items: center;\n          margin-bottom: 12px;\n          flex-wrap: wrap;\n        }\n        .seed-field-mapper .fm-btn {\n          background: #1e293b;\n          border: 1px solid #334155;\n          color: #e2e8f0;\n          border-radius: 8px;\n          padding: 6px 12px;\n          cursor: pointer;\n          font-size: 13px;\n        }\n        .seed-field-mapper .fm-btn:hover { border-color: #64748b; }\n        .seed-field-mapper .fm-btn-primary {\n          background: #2563eb;\n          border-color: #3b82f6;\n        }\n        .seed-field-mapper .fm-meta {\n          font-size: 12px;\n          color: #94a3b8;\n          margin-left: auto;\n        }\n        .seed-field-mapper .fm-grid {\n          position: relative;\n          display: grid;\n          grid-template-columns: 1fr 1fr;\n          gap: 48px;\n          min-height: 240px;\n        }\n        .seed-field-mapper .fm-col-title {\n          font-size: 11px;\n          text-transform: uppercase;\n          letter-spacing: 0.06em;\n          color: #64748b;\n          margin-bottom: 8px;\n        }\n        .seed-field-mapper .fm-card {\n          border: 1px solid #334155;\n          border-radius: 8px;\n          padding: 10px 12px;\n          margin-bottom: 8px;\n          background: #1e293b;\n          cursor: pointer;\n          transition: border-color 0.15s, box-shadow 0.15s;\n        }\n        .seed-field-mapper .fm-card.active {\n          border-color: #3b82f6;\n          box-shadow: 0 0 0 1px #3b82f6;\n        }\n        .seed-field-mapper .fm-card.mapped {\n          border-color: #475569;\n        }\n        .seed-field-mapper .fm-card.highlight {\n          border-color: #f59e0b;\n        }\n        .seed-field-mapper .fm-label {\n          font-weight: 600;\n          font-size: 13px;\n          margin-bottom: 4px;\n        }\n        .seed-field-mapper .fm-value {\n          font-family: 'JetBrains Mono', ui-monospace, monospace;\n          font-size: 11px;\n          color: #94a3b8;\n          white-space: nowrap;\n          overflow: hidden;\n          text-overflow: ellipsis;\n        }\n        .seed-field-mapper .fm-kind {\n          font-size: 10px;\n          color: #64748b;\n          margin-left: 6px;\n        }\n        .seed-field-mapper .fm-prop-row {\n          display: flex;\n          align-items: center;\n          justify-content: space-between;\n          gap: 8px;\n        }\n        .seed-field-mapper .fm-dtype {\n          font-size: 10px;\n          padding: 2px 6px;\n          border-radius: 4px;\n          border: 1px solid;\n        }\n        .seed-field-mapper .fm-remove {\n          background: transparent;\n          border: none;\n          color: #94a3b8;\n          cursor: pointer;\n          font-size: 14px;\n          padding: 0 4px;\n        }\n        .seed-field-mapper .fm-remove:hover { color: #f87171; }\n        .seed-field-mapper .fm-svg {\n          position: absolute;\n          inset: 0;\n          pointer-events: none;\n          overflow: visible;\n        }\n        .seed-field-mapper .fm-preview {\n          margin-top: 12px;\n          background: #020617;\n          border: 1px solid #334155;\n          border-radius: 8px;\n          padding: 12px;\n          font-family: 'JetBrains Mono', ui-monospace, monospace;\n          font-size: 11px;\n          white-space: pre-wrap;\n          color: #cbd5e1;\n          max-height: 200px;\n          overflow: auto;\n        }\n      " }),
+			/* @__PURE__ */ s("div", {
+				className: "fm-toolbar",
+				children: [
+					/* @__PURE__ */ o("button", {
+						type: "button",
+						className: "fm-btn fm-btn-primary",
+						onClick: () => {
+							d(f ? f() : p(e, c));
+						},
+						children: "Auto-map"
+					}),
+					h && /* @__PURE__ */ o("button", {
+						type: "button",
+						className: "fm-btn",
+						onClick: () => C((e) => !e),
+						children: S ? "Hide preview" : "Preview JSON"
+					}),
+					/* @__PURE__ */ s("span", {
+						className: "fm-meta",
+						children: [
+							u.length,
+							" / ",
+							c.length,
+							" mapped",
+							g ? " · click a property" : " · click a source"
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ s("div", {
+				className: "fm-grid",
+				ref: j,
+				children: [
+					/* @__PURE__ */ o("svg", {
+						className: "fm-svg",
+						width: T.width,
+						height: T.height,
+						children: k.map((e) => {
+							let t = V?.sourceId === e.mapping.sourceId && V?.propertyName === e.mapping.propertyName, n = (e.x1 + e.x2) / 2;
+							return /* @__PURE__ */ o("path", {
+								d: `M ${e.x1} ${e.y1} C ${n} ${e.y1}, ${n} ${e.y2}, ${e.x2} ${e.y2}`,
+								stroke: e.color,
+								strokeWidth: t ? 3 : 2,
+								fill: "none",
+								opacity: V && !t ? .25 : .85
+							}, `${e.mapping.sourceId}-${e.mapping.propertyName}`);
+						})
+					}),
+					/* @__PURE__ */ s("div", { children: [/* @__PURE__ */ o("div", {
+						className: "fm-col-title",
+						children: "Sources"
+					}), e.map((e) => {
+						let t = z(e.id), n = g === e.id, r = V?.sourceId === e.id;
+						return /* @__PURE__ */ s("div", {
+							ref: (t) => {
+								M.current[e.id] = t;
+							},
+							className: `fm-card${n ? " active" : ""}${t ? " mapped" : ""}${r ? " highlight" : ""}`,
+							onClick: () => I(e.id),
+							onMouseEnter: () => x(e.id),
+							onMouseLeave: () => x(null),
+							children: [/* @__PURE__ */ s("div", {
+								className: "fm-prop-row",
+								children: [/* @__PURE__ */ s("div", {
+									className: "fm-label",
+									children: [e.label, /* @__PURE__ */ o("span", {
+										className: "fm-kind",
+										children: e.kind
+									})]
+								}), t && /* @__PURE__ */ o("button", {
+									type: "button",
+									className: "fm-remove",
+									"aria-label": "Remove mapping",
+									onClick: (t) => {
+										t.stopPropagation(), R(e.id);
+									},
+									children: "×"
+								})]
+							}), /* @__PURE__ */ o("div", {
+								className: "fm-value",
+								children: D(e.value, 80)
+							})]
+						}, e.id);
+					})] }),
+					/* @__PURE__ */ s("div", { children: [/* @__PURE__ */ o("div", {
+						className: "fm-col-title",
+						children: "Model properties"
+					}), c.map((e) => {
+						let t = B(e.name), n = E(e.dataType), r = V?.propertyName === e.name;
+						return /* @__PURE__ */ s("div", {
+							ref: (t) => {
+								N.current[e.name] = t;
+							},
+							className: `fm-card${t ? " mapped" : ""}${r ? " highlight" : ""}${g ? " active" : ""}`,
+							onClick: () => L(e.name),
+							onMouseEnter: () => y(e.name),
+							onMouseLeave: () => y(null),
+							children: [/* @__PURE__ */ s("div", {
+								className: "fm-prop-row",
+								children: [/* @__PURE__ */ o("div", {
+									className: "fm-label",
+									children: e.name
+								}), /* @__PURE__ */ o("span", {
+									className: "fm-dtype",
+									style: {
+										background: n.bg,
+										borderColor: n.border,
+										color: n.text
+									},
+									children: e.dataType
+								})]
+							}), t && /* @__PURE__ */ s("div", {
+								className: "fm-value",
+								children: ["← ", t.sourceId]
+							})]
+						}, e.name);
+					})] })
+				]
+			}),
+			h && S && /* @__PURE__ */ o("pre", {
+				className: "fm-preview",
+				children: JSON.stringify(H, null, 2)
+			})
+		]
+	});
+}
+//#endregion
+export { O as FieldMapper, m as SECTION_FULL_ID, l as applyMapping, p as autoMap, c as coerceValue, _ as markdownToSources, g as parseMarkdownSections, h as parseMarkdownWithFrontmatter, S as rssItemToSources, C as rssXmlToSources };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/applyMapping.ts","../src/autoMap.ts","../src/adapters/markdown.ts","../src/adapters/rss.ts","../src/react/FieldMapper.tsx"],"sourcesContent":["import type {\n  FieldMapping,\n  PropertyBag,\n  SourceNode,\n  TargetProperty,\n} from './types'\n\n/**\n * Coerce a raw string value to the Seed model property dataType.\n */\nexport function coerceValue(rawValue: string, dataType: string): unknown {\n  if (dataType === 'Number') {\n    return parseFloat(String(rawValue)) || 0\n  }\n  if (dataType === 'Boolean') {\n    return (\n      rawValue === 'true' ||\n      rawValue === '1' ||\n      String(rawValue).toLowerCase() === 'yes'\n    )\n  }\n  if (dataType === 'Json') {\n    try {\n      return JSON.parse(rawValue)\n    } catch {\n      return rawValue\n    }\n  }\n  if (dataType === 'Date') {\n    const d = new Date(String(rawValue))\n    return Number.isNaN(d.getTime()) ? rawValue : d.getTime()\n  }\n  return String(rawValue ?? '')\n}\n\n/**\n * Apply field mappings to produce a property bag for createItem / publish.\n * Missing sources or unknown target properties are skipped (no throw).\n */\nexport function applyMapping(\n  sources: SourceNode[],\n  mappings: FieldMapping[],\n  targets: TargetProperty[],\n): PropertyBag {\n  const byId = new Map(sources.map((s) => [s.id, s]))\n  const byName = new Map(targets.map((t) => [t.name, t]))\n  const properties: PropertyBag = {}\n\n  for (const mapping of mappings) {\n    const source = byId.get(mapping.sourceId)\n    const target = byName.get(mapping.propertyName)\n    if (!source || !target) continue\n\n    const raw = source.value || source.label\n    properties[mapping.propertyName] = coerceValue(raw, target.dataType)\n  }\n\n  return properties\n}\n","import type { FieldMapping, SourceNode, TargetProperty } from './types'\n\nconst FULL_DOC_PROP_NAMES = ['text', 'content', 'body', 'fulltext', 'markdown']\n\nfunction normalizeName(name: string): string {\n  return name.toLowerCase().replace(/\\s+/g, '').replace(/[:_-]/g, '')\n}\n\nfunction namesMatch(a: string, b: string): boolean {\n  const na = normalizeName(a)\n  const nb = normalizeName(b)\n  return na === nb || na.includes(nb) || nb.includes(na)\n}\n\n/**\n * Heuristic auto-map: full-document sources to body-like props,\n * then fuzzy name match for remaining sources ↔ targets.\n * Returns 1:1 mappings (each source and property used at most once).\n */\nexport function autoMap(\n  sources: SourceNode[],\n  targets: TargetProperty[],\n): FieldMapping[] {\n  const mappings: FieldMapping[] = []\n  const usedProps = new Set<string>()\n  const usedSources = new Set<string>()\n\n  const fullSource = sources.find((s) => s.kind === 'full')\n  if (fullSource) {\n    const fullDocMatch = targets.find((p) =>\n      FULL_DOC_PROP_NAMES.includes(p.name.toLowerCase()),\n    )\n    if (fullDocMatch) {\n      mappings.push({\n        sourceId: fullSource.id,\n        propertyName: fullDocMatch.name,\n      })\n      usedProps.add(fullDocMatch.name)\n      usedSources.add(fullSource.id)\n    }\n  }\n\n  // Prefer common RSS aliases before generic fuzzy match\n  const rssAliases: Record<string, string[]> = {\n    title: ['title', 'name', 'headline'],\n    'content:encoded': ['html', 'content', 'body', 'text'],\n    content: ['html', 'content', 'body', 'text'],\n    description: ['summary', 'description', 'excerpt'],\n    summary: ['summary', 'description', 'excerpt'],\n    featureimage: ['featureimage', 'feature_image', 'image', 'cover'],\n    feature_image: ['featureimage', 'feature_image', 'image', 'cover'],\n    link: ['url', 'link', 'permalink', 'slug'],\n    creator: ['author', 'authors', 'creator', 'byline'],\n    author: ['author', 'authors', 'creator', 'byline'],\n  }\n\n  for (const source of sources) {\n    if (usedSources.has(source.id)) continue\n\n    const labelKey = normalizeName(source.label)\n    const idKey = source.id.replace(/^rss-/, '').replace(/^fm-/, '')\n    const aliasKeys = [\n      ...(rssAliases[source.label] ?? []),\n      ...(rssAliases[idKey] ?? []),\n      ...(rssAliases[labelKey] ?? []),\n    ]\n\n    let match: TargetProperty | undefined\n\n    for (const alias of aliasKeys) {\n      match = targets.find(\n        (p) => !usedProps.has(p.name) && namesMatch(p.name, alias),\n      )\n      if (match) break\n    }\n\n    if (!match) {\n      match = targets.find(\n        (p) =>\n          !usedProps.has(p.name) &&\n          (namesMatch(p.name, source.label) || namesMatch(p.name, idKey)),\n      )\n    }\n\n    if (match) {\n      mappings.push({ sourceId: source.id, propertyName: match.name })\n      usedProps.add(match.name)\n      usedSources.add(source.id)\n    }\n  }\n\n  return mappings\n}\n","import type { SourceNode } from '../types'\n\nexport const SECTION_FULL_ID = 'section-full'\n\ntype FrontmatterField = {\n  id: string\n  key: string\n  value: string\n  valueType: 'string' | 'boolean' | 'array'\n}\n\ntype ParsedMarkdown = {\n  frontmatter: FrontmatterField[]\n  body: string\n}\n\ntype MarkdownSection = {\n  id: string\n  heading: string\n  level: number\n  content: string\n}\n\n/**\n * Parse YAML-like frontmatter (flat keys only) and body.\n * Mirrors desktop MarkdownMapper limits: no nested YAML.\n */\nexport function parseMarkdownWithFrontmatter(\n  markdownContent: string,\n): ParsedMarkdown {\n  try {\n    const match = markdownContent.match(\n      /^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?([\\s\\S]*)$/,\n    )\n    if (!match) return { frontmatter: [], body: markdownContent }\n\n    const yamlBlock = match[1] ?? ''\n    const body = (match[2] ?? '').trimStart()\n    const frontmatter: FrontmatterField[] = []\n    const data: Record<string, unknown> = {}\n\n    for (const line of yamlBlock.split('\\n')) {\n      const keyMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\\s*(.*)$/)\n      if (!keyMatch) continue\n\n      const key = keyMatch[1]!\n      const raw = keyMatch[2]!.trim()\n      let val: unknown = raw\n\n      if (raw === 'true') val = true\n      else if (raw === 'false') val = false\n      else if (raw === 'null' || raw === '') val = null\n      else if (raw.startsWith('[') && raw.endsWith(']')) {\n        try {\n          val = JSON.parse(raw.replace(/'/g, '\"'))\n        } catch {\n          val = raw\n            .slice(1, -1)\n            .split(',')\n            .map((s: string) => s.trim().replace(/^['\"]|['\"]$/g, ''))\n        }\n      } else if (raw.startsWith('\"') || raw.startsWith(\"'\")) {\n        val = raw.slice(1, -1).replace(/\\\\\"/g, '\"')\n      }\n\n      data[key] = val\n    }\n\n    for (const [key, val] of Object.entries(data)) {\n      let valueType: 'string' | 'boolean' | 'array' = 'string'\n      let value: string\n\n      if (Array.isArray(val)) {\n        valueType = 'array'\n        value = val\n          .map((v) => (typeof v === 'object' ? JSON.stringify(v) : String(v)))\n          .join(', ')\n      } else if (typeof val === 'boolean') {\n        valueType = 'boolean'\n        value = String(val)\n      } else if (val != null && typeof val === 'object') {\n        value = JSON.stringify(val)\n      } else {\n        value = val != null ? String(val) : ''\n      }\n\n      frontmatter.push({\n        id: `fm-${key}`,\n        key,\n        value,\n        valueType,\n      })\n    }\n\n    return { frontmatter, body }\n  } catch {\n    return { frontmatter: [], body: markdownContent }\n  }\n}\n\n/**\n * Split markdown body into H1/H2 sections (###+ ignored as section breaks).\n */\nexport function parseMarkdownSections(md: string): MarkdownSection[] {\n  const lines = md.split('\\n')\n  const sections: MarkdownSection[] = []\n  let current: MarkdownSection | null = null\n\n  for (const line of lines) {\n    const h2Match = line.match(/^## (.+)/)\n    const h1Match = line.match(/^# (.+)/)\n\n    if (h1Match) {\n      if (current) sections.push(current)\n      current = {\n        id: `section-${sections.length}`,\n        heading: h1Match[1]!,\n        level: 1,\n        content: '',\n      }\n    } else if (h2Match) {\n      if (current) sections.push(current)\n      current = {\n        id: `section-${sections.length}`,\n        heading: h2Match[1]!,\n        level: 2,\n        content: '',\n      }\n    } else if (current) {\n      current.content += (current.content ? '\\n' : '') + line\n    }\n  }\n  if (current) sections.push(current)\n  return sections\n}\n\n/**\n * Convert markdown into SourceNodes for FieldMapper / applyMapping.\n * Order: frontmatter fields, full document body, then H1/H2 sections.\n */\nexport function markdownToSources(markdown: string): SourceNode[] {\n  const parsed = parseMarkdownWithFrontmatter(markdown)\n  const sections = parseMarkdownSections(parsed.body)\n  const sources: SourceNode[] = []\n\n  for (const fm of parsed.frontmatter) {\n    sources.push({\n      id: fm.id,\n      label: fm.key,\n      kind: 'frontmatter',\n      value: fm.value,\n      meta: { valueType: fm.valueType },\n    })\n  }\n\n  sources.push({\n    id: SECTION_FULL_ID,\n    label: 'Full document',\n    kind: 'full',\n    value: parsed.body,\n  })\n\n  for (const section of sections) {\n    const value =\n      section.content.trim().length > 0 ? section.content.trim() : section.heading\n    sources.push({\n      id: section.id,\n      label: section.heading,\n      kind: 'section',\n      value,\n      meta: { level: section.level },\n    })\n  }\n\n  return sources\n}\n","import Parser from 'rss-parser'\nimport type { SourceNode } from '../types'\n\nexport type ParsedRssChannel = {\n  title?: string\n  link?: string\n  description?: string\n  /** Plain serializable item records (dates become ISO strings). */\n  items: Record<string, unknown>[]\n}\n\nfunction toPlainItem(item: unknown): Record<string, unknown> {\n  try {\n    return JSON.parse(JSON.stringify(item)) as Record<string, unknown>\n  } catch {\n    return { ...(item as Record<string, unknown>) }\n  }\n}\n\n/**\n * Same shape and customFields as @seedprotocol/feed `parseRssString`\n * so RSS mapping stays aligned without importing feed's heavy barrel.\n */\nconst parser = new Parser({\n  customFields: {\n    item: [\n      'featureImage',\n      'feature_image',\n      'content:encoded',\n      'seedUid',\n      'SeedUid',\n    ],\n  },\n})\n\nasync function parseRssString(xml: string): Promise<ParsedRssChannel> {\n  const feed = await parser.parseString(xml)\n  return {\n    title: feed.title,\n    link: feed.link,\n    description: feed.description,\n    items: (feed.items ?? []).map(toPlainItem),\n  }\n}\n\nfunction coerceFieldValue(val: unknown): string | null {\n  if (val == null) return null\n  if (typeof val === 'string') {\n    const t = val.trim()\n    return t.length > 0 ? t : null\n  }\n  if (typeof val === 'number' || typeof val === 'boolean') {\n    return String(val)\n  }\n  if (Array.isArray(val)) {\n    try {\n      return JSON.stringify(val)\n    } catch {\n      return null\n    }\n  }\n  if (typeof val === 'object') {\n    const obj = val as Record<string, unknown>\n    if (typeof obj._ === 'string' && obj._.trim()) return obj._.trim()\n    if (typeof obj.value === 'string' && obj.value.trim()) return obj.value.trim()\n    try {\n      return JSON.stringify(val)\n    } catch {\n      return null\n    }\n  }\n  return null\n}\n\n/**\n * Flatten a parsed RSS/Atom item into SourceNodes (one per string-coercible key).\n * Stable ids: `rss-{key}`.\n */\nexport function rssItemToSources(item: Record<string, unknown>): SourceNode[] {\n  const sources: SourceNode[] = []\n  const seen = new Set<string>()\n\n  for (const [key, raw] of Object.entries(item)) {\n    if (key === 'items' || key.startsWith('$')) continue\n    const value = coerceFieldValue(raw)\n    if (value == null) continue\n    if (seen.has(key)) continue\n    seen.add(key)\n\n    sources.push({\n      id: `rss-${key}`,\n      label: key,\n      kind: 'rssField',\n      value,\n    })\n  }\n\n  return sources\n}\n\nexport type RssXmlSourcesResult = {\n  channel: {\n    title?: string\n    link?: string\n    description?: string\n  }\n  /** Source nodes for each feed item, in document order. */\n  items: SourceNode[][]\n}\n\n/**\n * Parse RSS/Atom XML and map each item to SourceNodes via rssItemToSources.\n * Compatible with @seedprotocol/feed `parseRssString` field set.\n */\nexport async function rssXmlToSources(\n  xml: string,\n): Promise<RssXmlSourcesResult> {\n  const parsed = await parseRssString(xml)\n  return {\n    channel: {\n      title: parsed.title,\n      link: parsed.link,\n      description: parsed.description,\n    },\n    items: parsed.items.map((item) => rssItemToSources(item)),\n  }\n}\n","import React, {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react'\nimport { applyMapping } from '../applyMapping'\nimport { autoMap as defaultAutoMap } from '../autoMap'\nimport type { FieldMapping, SourceNode, TargetProperty } from '../types'\n\nconst CONNECTION_COLORS = [\n  '#3b82f6',\n  '#8b5cf6',\n  '#ec4899',\n  '#f59e0b',\n  '#10b981',\n  '#06b6d4',\n  '#f97316',\n  '#14b8a6',\n]\n\ntype ConnectorPoint = {\n  x1: number\n  y1: number\n  x2: number\n  y2: number\n  color: string\n  mapping: FieldMapping\n}\n\nexport type FieldMapperProps = {\n  sources: SourceNode[]\n  targets: TargetProperty[]\n  mappings: FieldMapping[]\n  onChange: (mappings: FieldMapping[]) => void\n  /** Override default autoMap heuristics. */\n  onAutoMap?: () => FieldMapping[]\n  className?: string\n  /** Show JSON preview of applyMapping result. Default true. */\n  showPreview?: boolean\n}\n\nconst DATA_TYPE_COLORS: Record<\n  string,\n  { bg: string; border: string; text: string }\n> = {\n  String: { bg: 'rgba(59,130,246,0.12)', border: '#3b82f6', text: '#93c5fd' },\n  Text: { bg: 'rgba(59,130,246,0.12)', border: '#3b82f6', text: '#93c5fd' },\n  Number: { bg: 'rgba(16,185,129,0.12)', border: '#10b981', text: '#6ee7b7' },\n  Boolean: { bg: 'rgba(167,139,250,0.12)', border: '#a78bfa', text: '#c4b5fd' },\n  Json: { bg: 'rgba(251,191,36,0.12)', border: '#fbbf24', text: '#fcd34d' },\n  Date: { bg: 'rgba(244,114,182,0.12)', border: '#f472b6', text: '#f9a8d4' },\n  Relation: { bg: 'rgba(34,211,238,0.12)', border: '#22d3ee', text: '#67e8f9' },\n}\n\nfunction getDataTypeStyle(dataType: string) {\n  return (\n    DATA_TYPE_COLORS[dataType] ?? {\n      bg: 'rgba(148,163,184,0.12)',\n      border: '#94a3b8',\n      text: '#cbd5e1',\n    }\n  )\n}\n\nfunction truncate(s: string, n: number): string {\n  const t = s.replace(/\\s+/g, ' ').trim()\n  if (t.length <= n) return t\n  return `${t.slice(0, n)}…`\n}\n\n/**\n * Generic two-pane field mapper. Props-driven; no Seed hooks or routing.\n */\nexport function FieldMapper({\n  sources,\n  targets,\n  mappings,\n  onChange,\n  onAutoMap,\n  className,\n  showPreview = true,\n}: FieldMapperProps) {\n  const [activeSource, setActiveSource] = useState<string | null>(null)\n  const [hoveredProp, setHoveredProp] = useState<string | null>(null)\n  const [hoveredSource, setHoveredSource] = useState<string | null>(null)\n  const [previewOpen, setPreviewOpen] = useState(false)\n  const [svgDimensions, setSvgDimensions] = useState({ width: 0, height: 0 })\n  const [connectorPoints, setConnectorPoints] = useState<ConnectorPoint[]>([])\n\n  const containerRef = useRef<HTMLDivElement>(null)\n  const sourceRefs = useRef<Record<string, HTMLDivElement | null>>({})\n  const propRefs = useRef<Record<string, HTMLDivElement | null>>({})\n\n  const getConnectionColor = useCallback(\n    (index: number) => CONNECTION_COLORS[index % CONNECTION_COLORS.length]!,\n    [],\n  )\n\n  const getConnectorPoints = useCallback((): ConnectorPoint[] => {\n    if (!containerRef.current) return []\n    const containerRect = containerRef.current.getBoundingClientRect()\n    return mappings\n      .map((mapping, i) => {\n        const sourceEl = sourceRefs.current[mapping.sourceId]\n        const propEl = propRefs.current[mapping.propertyName]\n        if (!sourceEl || !propEl) return null\n\n        const sR = sourceEl.getBoundingClientRect()\n        const pR = propEl.getBoundingClientRect()\n\n        return {\n          x1: sR.right - containerRect.left,\n          y1: sR.top + sR.height / 2 - containerRect.top,\n          x2: pR.left - containerRect.left,\n          y2: pR.top + pR.height / 2 - containerRect.top,\n          color: getConnectionColor(i),\n          mapping,\n        }\n      })\n      .filter((pt): pt is ConnectorPoint => pt !== null)\n  }, [mappings, getConnectionColor])\n\n  useEffect(() => {\n    const update = () => {\n      if (containerRef.current) {\n        const rect = containerRef.current.getBoundingClientRect()\n        setSvgDimensions({ width: rect.width, height: rect.height })\n      }\n      setConnectorPoints(getConnectorPoints())\n    }\n    update()\n    window.addEventListener('resize', update)\n    const timer = setInterval(update, 200)\n    return () => {\n      window.removeEventListener('resize', update)\n      clearInterval(timer)\n    }\n  }, [getConnectorPoints, mappings, sources, targets])\n\n  const handleSourceClick = (sourceId: string) => {\n    setActiveSource((prev) => (prev === sourceId ? null : sourceId))\n  }\n\n  const handlePropClick = (propertyName: string) => {\n    if (!activeSource) return\n    let next = [...mappings]\n    next = next.filter(\n      (c) =>\n        c.sourceId !== activeSource && c.propertyName !== propertyName,\n    )\n    next.push({ sourceId: activeSource, propertyName })\n    onChange(next)\n    setActiveSource(null)\n  }\n\n  const removeMapping = (sourceId: string) => {\n    onChange(mappings.filter((c) => c.sourceId !== sourceId))\n  }\n\n  const mappingForSource = (sourceId: string) =>\n    mappings.find((c) => c.sourceId === sourceId)\n  const mappingForProp = (propName: string) =>\n    mappings.find((c) => c.propertyName === propName)\n\n  const highlightedPair = hoveredProp\n    ? mappings.find((c) => c.propertyName === hoveredProp)\n    : hoveredSource\n      ? mappings.find((c) => c.sourceId === hoveredSource)\n      : null\n\n  const preview = useMemo(\n    () => applyMapping(sources, mappings, targets),\n    [sources, mappings, targets],\n  )\n\n  const runAutoMap = () => {\n    const next = onAutoMap ? onAutoMap() : defaultAutoMap(sources, targets)\n    onChange(next)\n  }\n\n  return (\n    <div className={`seed-field-mapper ${className ?? ''}`.trim()}>\n      <style>{`\n        .seed-field-mapper {\n          font-family: 'DM Sans', system-ui, sans-serif;\n          color: #e2e8f0;\n          background: #0f172a;\n          border-radius: 12px;\n          padding: 16px;\n        }\n        .seed-field-mapper * { box-sizing: border-box; }\n        .seed-field-mapper .fm-toolbar {\n          display: flex;\n          gap: 8px;\n          align-items: center;\n          margin-bottom: 12px;\n          flex-wrap: wrap;\n        }\n        .seed-field-mapper .fm-btn {\n          background: #1e293b;\n          border: 1px solid #334155;\n          color: #e2e8f0;\n          border-radius: 8px;\n          padding: 6px 12px;\n          cursor: pointer;\n          font-size: 13px;\n        }\n        .seed-field-mapper .fm-btn:hover { border-color: #64748b; }\n        .seed-field-mapper .fm-btn-primary {\n          background: #2563eb;\n          border-color: #3b82f6;\n        }\n        .seed-field-mapper .fm-meta {\n          font-size: 12px;\n          color: #94a3b8;\n          margin-left: auto;\n        }\n        .seed-field-mapper .fm-grid {\n          position: relative;\n          display: grid;\n          grid-template-columns: 1fr 1fr;\n          gap: 48px;\n          min-height: 240px;\n        }\n        .seed-field-mapper .fm-col-title {\n          font-size: 11px;\n          text-transform: uppercase;\n          letter-spacing: 0.06em;\n          color: #64748b;\n          margin-bottom: 8px;\n        }\n        .seed-field-mapper .fm-card {\n          border: 1px solid #334155;\n          border-radius: 8px;\n          padding: 10px 12px;\n          margin-bottom: 8px;\n          background: #1e293b;\n          cursor: pointer;\n          transition: border-color 0.15s, box-shadow 0.15s;\n        }\n        .seed-field-mapper .fm-card.active {\n          border-color: #3b82f6;\n          box-shadow: 0 0 0 1px #3b82f6;\n        }\n        .seed-field-mapper .fm-card.mapped {\n          border-color: #475569;\n        }\n        .seed-field-mapper .fm-card.highlight {\n          border-color: #f59e0b;\n        }\n        .seed-field-mapper .fm-label {\n          font-weight: 600;\n          font-size: 13px;\n          margin-bottom: 4px;\n        }\n        .seed-field-mapper .fm-value {\n          font-family: 'JetBrains Mono', ui-monospace, monospace;\n          font-size: 11px;\n          color: #94a3b8;\n          white-space: nowrap;\n          overflow: hidden;\n          text-overflow: ellipsis;\n        }\n        .seed-field-mapper .fm-kind {\n          font-size: 10px;\n          color: #64748b;\n          margin-left: 6px;\n        }\n        .seed-field-mapper .fm-prop-row {\n          display: flex;\n          align-items: center;\n          justify-content: space-between;\n          gap: 8px;\n        }\n        .seed-field-mapper .fm-dtype {\n          font-size: 10px;\n          padding: 2px 6px;\n          border-radius: 4px;\n          border: 1px solid;\n        }\n        .seed-field-mapper .fm-remove {\n          background: transparent;\n          border: none;\n          color: #94a3b8;\n          cursor: pointer;\n          font-size: 14px;\n          padding: 0 4px;\n        }\n        .seed-field-mapper .fm-remove:hover { color: #f87171; }\n        .seed-field-mapper .fm-svg {\n          position: absolute;\n          inset: 0;\n          pointer-events: none;\n          overflow: visible;\n        }\n        .seed-field-mapper .fm-preview {\n          margin-top: 12px;\n          background: #020617;\n          border: 1px solid #334155;\n          border-radius: 8px;\n          padding: 12px;\n          font-family: 'JetBrains Mono', ui-monospace, monospace;\n          font-size: 11px;\n          white-space: pre-wrap;\n          color: #cbd5e1;\n          max-height: 200px;\n          overflow: auto;\n        }\n      `}</style>\n\n      <div className=\"fm-toolbar\">\n        <button type=\"button\" className=\"fm-btn fm-btn-primary\" onClick={runAutoMap}>\n          Auto-map\n        </button>\n        {showPreview && (\n          <button\n            type=\"button\"\n            className=\"fm-btn\"\n            onClick={() => setPreviewOpen((v) => !v)}\n          >\n            {previewOpen ? 'Hide preview' : 'Preview JSON'}\n          </button>\n        )}\n        <span className=\"fm-meta\">\n          {mappings.length} / {targets.length} mapped\n          {activeSource ? ' · click a property' : ' · click a source'}\n        </span>\n      </div>\n\n      <div className=\"fm-grid\" ref={containerRef}>\n        <svg\n          className=\"fm-svg\"\n          width={svgDimensions.width}\n          height={svgDimensions.height}\n        >\n          {connectorPoints.map((pt) => {\n            const isHi =\n              highlightedPair?.sourceId === pt.mapping.sourceId &&\n              highlightedPair?.propertyName === pt.mapping.propertyName\n            const midX = (pt.x1 + pt.x2) / 2\n            return (\n              <path\n                key={`${pt.mapping.sourceId}-${pt.mapping.propertyName}`}\n                d={`M ${pt.x1} ${pt.y1} C ${midX} ${pt.y1}, ${midX} ${pt.y2}, ${pt.x2} ${pt.y2}`}\n                stroke={pt.color}\n                strokeWidth={isHi ? 3 : 2}\n                fill=\"none\"\n                opacity={highlightedPair && !isHi ? 0.25 : 0.85}\n              />\n            )\n          })}\n        </svg>\n\n        <div>\n          <div className=\"fm-col-title\">Sources</div>\n          {sources.map((source) => {\n            const mapped = mappingForSource(source.id)\n            const isActive = activeSource === source.id\n            const isHi = highlightedPair?.sourceId === source.id\n            return (\n              <div\n                key={source.id}\n                ref={(el) => {\n                  sourceRefs.current[source.id] = el\n                }}\n                className={`fm-card${isActive ? ' active' : ''}${mapped ? ' mapped' : ''}${isHi ? ' highlight' : ''}`}\n                onClick={() => handleSourceClick(source.id)}\n                onMouseEnter={() => setHoveredSource(source.id)}\n                onMouseLeave={() => setHoveredSource(null)}\n              >\n                <div className=\"fm-prop-row\">\n                  <div className=\"fm-label\">\n                    {source.label}\n                    <span className=\"fm-kind\">{source.kind}</span>\n                  </div>\n                  {mapped && (\n                    <button\n                      type=\"button\"\n                      className=\"fm-remove\"\n                      aria-label=\"Remove mapping\"\n                      onClick={(e) => {\n                        e.stopPropagation()\n                        removeMapping(source.id)\n                      }}\n                    >\n                      ×\n                    </button>\n                  )}\n                </div>\n                <div className=\"fm-value\">{truncate(source.value, 80)}</div>\n              </div>\n            )\n          })}\n        </div>\n\n        <div>\n          <div className=\"fm-col-title\">Model properties</div>\n          {targets.map((prop) => {\n            const mapped = mappingForProp(prop.name)\n            const style = getDataTypeStyle(prop.dataType)\n            const isHi = highlightedPair?.propertyName === prop.name\n            return (\n              <div\n                key={prop.name}\n                ref={(el) => {\n                  propRefs.current[prop.name] = el\n                }}\n                className={`fm-card${mapped ? ' mapped' : ''}${isHi ? ' highlight' : ''}${activeSource ? ' active' : ''}`}\n                onClick={() => handlePropClick(prop.name)}\n                onMouseEnter={() => setHoveredProp(prop.name)}\n                onMouseLeave={() => setHoveredProp(null)}\n              >\n                <div className=\"fm-prop-row\">\n                  <div className=\"fm-label\">{prop.name}</div>\n                  <span\n                    className=\"fm-dtype\"\n                    style={{\n                      background: style.bg,\n                      borderColor: style.border,\n                      color: style.text,\n                    }}\n                  >\n                    {prop.dataType}\n                  </span>\n                </div>\n                {mapped && (\n                  <div className=\"fm-value\">← {mapped.sourceId}</div>\n                )}\n              </div>\n            )\n          })}\n        </div>\n      </div>\n\n      {showPreview && previewOpen && (\n        <pre className=\"fm-preview\">{JSON.stringify(preview, null, 2)}</pre>\n      )}\n    </div>\n  )\n}\n\nexport default FieldMapper\n"],"mappings":"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"}

package/dist/react/FieldMapper.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { FieldMapping, SourceNode, TargetProperty } from '../types';
+export type FieldMapperProps = {
+    sources: SourceNode[];
+    targets: TargetProperty[];
+    mappings: FieldMapping[];
+    onChange: (mappings: FieldMapping[]) => void;
+    /** Override default autoMap heuristics. */
+    onAutoMap?: () => FieldMapping[];
+    className?: string;
+    /** Show JSON preview of applyMapping result. Default true. */
+    showPreview?: boolean;
+};
+/**
+ * Generic two-pane field mapper. Props-driven; no Seed hooks or routing.
+ */
+export declare function FieldMapper({ sources, targets, mappings, onChange, onAutoMap, className, showPreview, }: FieldMapperProps): React.JSX.Element;
+export default FieldMapper;
+//# sourceMappingURL=FieldMapper.d.ts.map

package/dist/react/FieldMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldMapper.d.ts","sourceRoot":"","sources":["../../src/react/FieldMapper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAA;AAGd,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAsBxE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IAC5C,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,YAAY,EAAE,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AA+BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAkB,GACnB,EAAE,gBAAgB,qBAsWlB;AAED,eAAe,WAAW,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+/** Kind of a source field extracted from an external document. */
+export type SourceKind = 'frontmatter' | 'section' | 'full' | 'rssField' | 'xmlPath';
+/** A mappable value from markdown, RSS, or XML. */
+export type SourceNode = {
+    id: string;
+    label: string;
+    kind: SourceKind;
+    value: string;
+    meta?: Record<string, unknown>;
+};
+/** Target Seed model property. */
+export type TargetProperty = {
+    name: string;
+    dataType: string;
+};
+/** One-to-one connection from a source node to a model property. */
+export type FieldMapping = {
+    sourceId: string;
+    propertyName: string;
+};
+/** Persistable mapping authored in the UI (or programmatically). */
+export type MappingDocument = {
+    version: 1;
+    sourceKind: 'markdown' | 'rss' | 'xml';
+    mappings: FieldMapping[];
+};
+/** Result of applying mappings: property name → coerced value. */
+export type PropertyBag = Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,SAAS,GACT,MAAM,GACN,UAAU,GACV,SAAS,CAAA;AAEb,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAA;IACV,UAAU,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,CAAA;IACtC,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@seedprotocol/mapping",
+  "version": "0.5.3",
+  "description": "Source-to-model-property field mapping helpers and UI for Seed Protocol",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "prepublishOnly": "npm run build && node ../../scripts/sync-versions.js",
+    "test": "vitest run --config vitest.config.ts"
+  },
+  "dependencies": {
+    "rss-parser": "^3.13.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@vitejs/plugin-react": "^6.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "~5.9.3",
+    "vite": "^8.0.0",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19"
+  },
+  "author": "Keith Axline <keith@journodao.xyz>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}