@seedprotocol/mapping 0.6.2 → 0.6.3

package/dist/resolvedSources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvedSources.d.ts","sourceRoot":"","sources":["../src/resolvedSources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EAEX,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,sBAAsB,aAAa,CAAA;AAChD,eAAO,MAAM,mBAAmB,UAAU,CAAA;AAuC1C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAclD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,YAAY,CAUd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CAI1E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAoD5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,YAAY,GACpB,UAAU,GAAG,SAAS,CASxB"}
+{"version":3,"file":"resolvedSources.d.ts","sourceRoot":"","sources":["../src/resolvedSources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EAEX,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,sBAAsB,aAAa,CAAA;AAChD,eAAO,MAAM,mBAAmB,UAAU,CAAA;AAuC1C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAclD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,YAAY,CAUd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CAI1E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAoD5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,YAAY,GACpB,UAAU,GAAG,SAAS,CAUxB"}

package/dist/types.d.ts

@@ -3,7 +3,18 @@ export type SourceKind = 'frontmatter' | 'section' | 'full' | 'rssField' | 'xmlP
 /** Media class from pure URL / content-type classification (import-time). */
 export type UrlMediaClass = 'html' | 'image' | 'audio' | 'video' | 'unknown';
 /** Host-resolved transform applied before coerce. */
-export type ResolveJob = 'extract' | 'file' | 'lookup';
+export type ResolveJob = 'extract' | 'file' | 'lookup' | 'derive' | 'assemble';
+/** Write this property from another mapped property. Host owns apply. */
+export type DeriveSpec = {
+    /** Source property name (e.g. `title`). Package does not interpret it. */
+    from: string;
+    /** When a mapped origin is empty, still derive. */
+    fallback?: boolean;
+};
+/** Include named blocks when assembling stored HTML. Host owns apply and names. */
+export type AssembleSpec = {
+    blocks: string[];
+};
 /** A mappable value from markdown, RSS, or XML. */
 export type SourceNode = {
     id: string;
@@ -44,15 +55,21 @@ export type LookupEntry = {
  * A source may map to multiple properties; each property appears at most once.
  * `resolve: 'extract' | 'file'` is applied by `applyMappingAsync` via a host callback.
  * `resolve: 'lookup'` is applied from `lookup.entries` (sync and async).
+ * `resolve: 'derive' | 'assemble'` are host-applied; sync/async apply skip them.
+ * Derive-only edges omit `sourceId`.
  */
 export type FieldMapping = {
-    sourceId: string;
+    sourceId?: string;
     propertyName: string;
     resolve?: ResolveJob;
     /** Stored string → ref assignments for `resolve: 'lookup'`. Omit or empty = unassigned. */
     lookup?: {
         entries: LookupEntry[];
     };
+    /** Optional derive spec. Legal on `resolve: 'derive'` or as copy fallback. */
+    derive?: DeriveSpec;
+    /** Named blocks for `resolve: 'assemble'`. Host-owned names. */
+    assemble?: AssembleSpec;
 };
 /**
  * Per-property string → seed uid (or uid list) dictionary for `resolve: 'lookup'`.
@@ -89,7 +106,7 @@ export type ResolveContext = {
 /** Host-provided resolver; package never fetches or loads Seed items. */
 export type ResolveCallback = (ctx: ResolveContext) => Promise<unknown>;
 export type ApplyMappingError = {
-    sourceId: string;
+    sourceId?: string;
     propertyName: string;
     resolve?: ResolveJob;
     message: string;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedprotocol/mapping",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Source-to-model-property field mapping helpers and UI for Seed Protocol",
   "type": "module",
   "main": "./dist/index.js",