@seedprotocol/mapping 0.5.3 → 0.6.1

package/dist/react/fieldMapperTypes.d.ts

@@ -0,0 +1,77 @@
+import type { FieldMapping, LookupEntry, MappingLookups, ResolveJob, SourceNode, TargetProperty } from '../types';
+/** Authoring surface. Prefer `'rows'`; `'wires'` is deprecated but still supported. */
+export type FieldMapperLayout = 'rows' | 'wires';
+export type FieldMapperRowKey = 'property' | 'source';
+export type FieldMapperDefaultRows = 'requiredAndMapped' | 'mapped' | 'all';
+export type FieldMapperOption = {
+    value: string;
+    label: string;
+    sample?: string;
+    kind?: string;
+    dataType?: string;
+};
+export type FieldMapperRowState = 'empty' | 'mapped' | 'needsResolve' | 'needsLookup' | 'conflict';
+export type FieldMapperRow = {
+    /** Property name in property mode; synthetic edge id in source mode. */
+    id: string;
+    target?: TargetProperty;
+    mapping?: FieldMapping;
+    source?: SourceNode;
+    /** Normalized origin sample string for the current source. */
+    sampleValue: string;
+    /** Sync preview, or a description of what the host resolver will produce. */
+    preview: string;
+    /** Transform this edge needs to yield a usable value, if any. */
+    requiredResolve: ResolveJob | null;
+    state: FieldMapperRowState;
+};
+export type FieldMapperLookupRow = FieldMapperRow & {
+    onLookupChange: (entries: LookupEntry[]) => void;
+};
+export type FieldMapperCoverage = {
+    mapped: number;
+    total: number;
+    missingRequired: string[];
+};
+export type UseFieldMapperArgs = {
+    sources: SourceNode[];
+    targets: TargetProperty[];
+    mappings: FieldMapping[];
+    onChange: (mappings: FieldMapping[]) => void;
+    /**
+     * @deprecated Prefer `FieldMapping.lookup.entries`. Read as a fallback for preview.
+     */
+    lookups?: MappingLookups;
+    /**
+     * @deprecated Prefer `setLookupEntries` / `renderLookup`. Still clears the
+     * document-level table when a lookup edge is removed.
+     */
+    onLookupsChange?: (lookups: MappingLookups) => void;
+    rowKey?: FieldMapperRowKey;
+    onAutoMap?: () => FieldMapping[];
+};
+export type UseFieldMapperResult = {
+    rows: FieldMapperRow[];
+    sourceOptions: FieldMapperOption[];
+    propertyOptions: FieldMapperOption[];
+    addableProperties: TargetProperty[];
+    coverage: FieldMapperCoverage;
+    /** Row ids whose property is already filled by an earlier row. Empty in property mode. */
+    conflicts: Set<string>;
+    setSource: (rowId: string, sourceId: string | null) => void;
+    setProperty: (rowId: string, propertyName: string) => void;
+    setTransform: (rowId: string, resolve: ResolveJob | null) => void;
+    /** Write `lookup.entries` on the edge for this row. Empty list omits `lookup`. */
+    setLookupEntries: (rowId: string, entries: LookupEntry[]) => void;
+    addRow: (propertyName?: string) => void;
+    removeRow: (rowId: string) => void;
+    autoMap: () => void;
+    /**
+     * Wires-layout helper: property-exclusive connect from a (possibly derived)
+     * source id. Normalizes `@extract`/`@file` and auto-attaches lookup.
+     */
+    connect: (sourceId: string, propertyName: string) => void;
+    /** Remove every edge for a source (including derived resolve ids). */
+    removeBySource: (sourceId: string) => void;
+};
+//# sourceMappingURL=fieldMapperTypes.d.ts.map

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

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

package/dist/react/useFieldMapper.d.ts

@@ -0,0 +1,8 @@
+import type { TargetProperty } from '../types';
+import { filterPropertyNames } from './fieldMapperCore';
+import type { UseFieldMapperArgs, UseFieldMapperResult } from './fieldMapperTypes';
+export declare function useFieldMapper({ sources, targets, mappings, onChange, lookups, onLookupsChange, rowKey, onAutoMap, }: UseFieldMapperArgs): UseFieldMapperResult;
+/** Re-export filter helper for row renderers. */
+export { filterPropertyNames };
+export type { TargetProperty };
+//# sourceMappingURL=useFieldMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldMapper.d.ts","sourceRoot":"","sources":["../../src/react/useFieldMapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,UAAU,CAAA;AACjB,OAAO,EAWL,mBAAmB,EAOpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,oBAAoB,CAAA;AAE3B,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,OAAY,EACZ,eAAe,EACf,MAAmB,EACnB,SAAS,GACV,EAAE,kBAAkB,GAAG,oBAAoB,CAod3C;AAED,iDAAiD;AACjD,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAC9B,YAAY,EAAE,cAAc,EAAE,CAAA"}

package/dist/react.d.ts

@@ -0,0 +1,10 @@
+/**
+ * React UI entry for `@seedprotocol/mapping/react`.
+ * Import FieldMapper from here — not from `@seedprotocol/mapping` — so Node
+ * consumers of the headless API never resolve the React peer.
+ */
+export { FieldMapper, connectionStrokeForIndex, FIELD_MAPPER_PAIR_SLOTS, resolveTheme, ensureThemeInjected, buildThemeCss, wrapInThemeLayer, DEFAULT_THEME_CSS, STRUCTURAL_THEME_CSS, PAINT_THEME_CSS, THEME_STYLE_ID, resetThemeInjectionForTests, slotClass, resolveSlots, showRowPreview, showJsonPreview, SLOT_BASE_CLASS, type FieldMapperProps, type FieldMapperTheme, type ResolvedFieldMapperTheme, type FieldMapperLayout, type FieldMapperRowKey, type FieldMapperDefaultRows, type FieldMapperSlot, type FieldMapperSlots, type ResolvedFieldMapperSlots, type FieldMapperComponents, type ResolvedFieldMapperComponents, type FieldMapperSelectProps, type FieldMapperButtonProps, type FieldMapperPillProps, } from './react/FieldMapper';
+export { useFieldMapper, filterPropertyNames, } from './react/useFieldMapper';
+export type { FieldMapperOption, FieldMapperRow, FieldMapperLookupRow, FieldMapperRowState, FieldMapperCoverage, UseFieldMapperArgs, UseFieldMapperResult, } from './react/fieldMapperTypes';
+export { computeRequiredResolve, computeCoverage, buildSourceOptions, buildPropertyModeRows, buildSyncPreviewBag, previewForEdge, findConflicts, connectSourceToProperty, } from './react/fieldMapperCore';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,cAAc,EACd,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,uBAAuB,GACxB,MAAM,yBAAyB,CAAA"}