@seedprotocol/mapping 0.7.4 → 0.7.5-next.871.g8788c94

package/CHANGELOG.md

@@ -1,6 +1,28 @@
 # Changelog
 
-## 0.8.0
+## 0.6.10 (2026-10-04)
+
+### Commits
+
+#### Other
+
+- Fixing gas estimation. v0.6.10 (d5b161a1)
+
+## 0.6.7 (2026-10-01)
+
+_Also covers 0.6.4, 0.6.5, 0.6.6, published from commits in this range._
+
+### Commits
+
+#### Other
+
+- Final edits (687d320b)
+
+## 0.6.3 (2026-09-25)
+
+_Also covers 0.6.1, 0.6.2, published from commits in this range._
+
+_Derive and assemble. This file used to list them under `0.8.0`, a mapping version that was never published. They first shipped in 0.6.3._
 
 - `ResolveJob` adds `'derive' | 'assemble'`. `FieldMapping.sourceId` is optional so a derive-only edge is legal.
 - Persist `derive?: { from: string; fallback?: boolean }` and `assemble?: { blocks: string[] }` on the edge. Mutators pass them through, including copy + `derive` fallback. Empty `sourceId` is omitted.
@@ -11,7 +33,7 @@
 - `resolvedSourceId` only suffixes `extract` / `file`.
 - Package `autoMap` is unchanged: it does not inject derive-only slug or default html to assemble.
 
-## 0.7.0
+_Relation lookup, listed in this file under `0.7.0` before the monorepo reached that number. It first shipped in 0.6.2._
 
 - Relation lookup is an edge-local stored intent: `FieldMapping.lookup.entries` as `{ value, ref }[]`. `ref` is opaque (`seedLocalId` or `seedUid`). Empty entries are a valid unassigned map.
 - `applyMapping` (sync) applies lookup entries and emits refs. Unmatched values are omitted. `applyMappingAsync` reports unmatched on `errors[]` and no longer calls the host `resolve` callback for lookup.
@@ -22,12 +44,22 @@
 - `MappingDocument.lookups` / `lookups` + `onLookupsChange` are deprecated read/write fallbacks for 0.6.0 documents.
 - `_pendingResolve` is extract/file only; lookup hits appear in the preview bag.
 
-## 0.6.1
+### Commits
+
+#### Other
+
+- Fix Item proxy descriptors and FieldMapper stale mapping writes. (e26a927f)
+- Add derive and assemble as FieldMapper resolve words. (31c5753b)
+- Fixing bug so uid doesn't depend on CreatedAttestation (5e64192b)
+- Improved field mapping relation handling (76c6b18c)
+
+## 0.6.0 (2026-09-22)
+
+_Written as mapping 0.6.1._
 
 - `FieldMapper` `renderRowAccessory?: (row: FieldMapperRow) => ReactNode` — host chrome slot on each rows-layout row (`.fm-row-accessory` / `classNames.rowAccessory`), after the transform control and before remove. Package does not fetch or preview; hosts return `null` when idle (e.g. show **Preview** only for `resolve: 'extract' | 'file'`).
 - Optional `SourceNode.subtitle` for a secondary display line (inspector, wires card, source option labels). Prefer this over stuffing origin into `label`. Display-only — not part of `MappingDocument`.
-
-## 0.6.0
+_Written as mapping 0.6.0._
 
 - `FieldMapper` Phase 5: `layout` defaults to `'rows'`; `'wires'` is deprecated but still supported.
 - `FieldMapper` Phase 4: per-row lookup editors (`slots.lookups: 'row'`), row/JSON preview parity with sync `applyMapping` (+ `_pendingResolve`), JSON behind a `<details>` disclosure. Rows layout defaults `lookups` to `'row'`; wires keep `'section'`.
@@ -51,6 +83,33 @@
 - `autoMap` fans `link` / `url` sources out to matching URL-ish targets (`importUrl`, `canonicalUrl`, `url`, `link`, `permalink`).
 - `FieldMapper` supports attaching multiple properties from an active source without clearing prior edges; normalizes `@extract`/`@file` nodes to `resolve` on persist.
 
-## 0.5.1
+### Commits
+
+#### Features
+
+- add FieldMapper row layout and useFieldMapper hook (32290d70)
+- add resolve:lookup for relation value maps (c7a11b64)
+- add resolve jobs, URL classifier, and AV media roles (ac9ef29c)
+- allow one source to fan out to multiple properties (2f5b4840)
+
+#### Other
+
+- Responding to app developer requests (907b8cdf)
+- Field mapper phase 5 work (61e7a518)
+- Adding phase 4 work of mapping redesign (e3603ffa)
+- Adding cursor rule. More theme work. (9a5b31fc)
+- Additional improvements to address developer requests (1e6820ff)
+
+## 0.5.3 (2026-09-17)
+
+_Also covers 0.5.2, published from commits in this range._
+
+_Written as mapping 0.5.1._
 
 - Initial Phase 1 release: headless mapping core, markdown + RSS adapters, `FieldMapper` UI.
+
+### Commits
+
+#### Features
+
+- add @seedprotocol/mapping Phase 1 package (d97020cd)

package/README.md

@@ -1,6 +1,8 @@
 # @seedprotocol/mapping
 
-Source → Seed model property mapping helpers and a props-driven React UI.
+[![npm](https://img.shields.io/npm/v/@seedprotocol/mapping.svg)](https://www.npmjs.com/package/@seedprotocol/mapping)
+
+Source → Seed model property mapping helpers and a props-driven React UI. Part of [Seed Protocol](https://seedprotocol.io); the mapped property bag is what you write to items with [`@seedprotocol/sdk`](https://www.npmjs.com/package/@seedprotocol/sdk).
 
 Use this package to:
 
@@ -18,14 +20,18 @@ fetches, runs Readability, or loads Seed Identity items.
 (`derive.from` is a property name; `assemble.blocks` is a host-owned string list).
 A derive-only edge may omit `sourceId`. Sync and async `applyMapping` skip these jobs.
 
-## Install
+## Installation
 
 ```bash
-bun add @seedprotocol/mapping
+npm install @seedprotocol/mapping
 ```
 
 The default entry (`@seedprotocol/mapping`) is headless — no React peer required.
-For `FieldMapper`, also install React peers and import from `@seedprotocol/mapping/react`.
+For `FieldMapper`, also install the optional React peers (`react` and `react-dom`, 18 or 19) and import from `@seedprotocol/mapping/react`:
+
+```bash
+npm install 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).
@@ -88,11 +94,12 @@ const { properties, errors } = await applyMappingAsync(
   {
     resolve: async ({ job, url, contentType, rawValue }) => {
       if (job === 'extract') return await hostExtractHtml(url!)
-      if (job === 'lookup') return await hostLookupIdentity(rawValue!)
       return await hostFetchAndStoreFile(url!, contentType)
     },
   },
 )
+// `resolve` is only called for extract/file edges; lookup edges apply their
+// stored `lookup.entries` (see below).
 ```
 
 ### Relation lookup (`resolve: 'lookup'`)
@@ -281,7 +288,7 @@ default html to assemble.
 
 Sync `applyMapping` preview lists pending **extract/file/derive/assemble** edges under `_pendingResolve`. Lookup refs from stored entries appear in the bag.
 
-See [FIELD_MAPPER_REDESIGN.md](../../docs/FIELD_MAPPER_REDESIGN.md) for the row-layout design study (Phases 1–5 shipped). PermaPress: [FIELD_MAPPER_PERMAPRESS_HANDOFF.md](../../docs/FIELD_MAPPER_PERMAPRESS_HANDOFF.md).
+See [FIELD_MAPPER_REDESIGN.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/FIELD_MAPPER_REDESIGN.md) for the row-layout design study (Phases 1–5 shipped).
 
 ## Relationship to `FeedFieldManifest`
 
@@ -298,4 +305,8 @@ Compose them: map + resolve into a plain item, then optionally normalize roles f
 - RSS: top-level item fields via `parseRssString` (no general XPath); structured enclosure / media:content
 - UI: self-contained dark theme (or `theme="none"` / `"structural"` for host paint); `layout` defaults to `rows` (`wires` deprecated); no desktop/Tailwind coupling; no media preview player
 
-See [MAPPING_PHASE2.md](../../docs/MAPPING_PHASE2.md) for remaining consumer work (desktop migration, npm publish), [FIELD_MAPPER_REDESIGN.md](../../docs/FIELD_MAPPER_REDESIGN.md) for the row-layout study, and [FIELD_MAPPER_PERMAPRESS_HANDOFF.md](../../docs/FIELD_MAPPER_PERMAPRESS_HANDOFF.md) for PermaPress.
+See [MAPPING_PHASE2.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/MAPPING_PHASE2.md) for remaining consumer work and [FIELD_MAPPER_REDESIGN.md](https://github.com/JournoLabs/seed-protocol-sdk/blob/main/docs/FIELD_MAPPER_REDESIGN.md) for the row-layout study.
+
+## License
+
+MIT

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@seedprotocol/mapping",
-  "version": "0.7.4",
-  "description": "Source-to-model-property field mapping helpers and UI for Seed Protocol",
+  "version": "0.7.5-next.871.g8788c94",
+  "description": "Map markdown and RSS/Atom sources onto Seed Protocol model properties: headless mapping helpers plus an optional React FieldMapper UI",
+  "keywords": [
+    "seed-protocol",
+    "mapping",
+    "field-mapping",
+    "rss",
+    "markdown",
+    "import",
+    "react"
+  ],
   "type": "module",
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "import": {
@@ -68,6 +78,10 @@
     "url": "git+https://github.com/JournoLabs/seed-protocol-sdk.git",
     "directory": "packages/mapping"
   },
+  "homepage": "https://github.com/JournoLabs/seed-protocol-sdk/tree/main/packages/mapping#readme",
+  "bugs": {
+    "url": "https://github.com/JournoLabs/seed-protocol-sdk/issues"
+  },
   "publishConfig": {
     "access": "public"
   }