@proveanything/smartlinks-utils-ui 0.7.2 → 0.7.4

package/dist/components/RecordsAdmin/index.d.ts

@@ -329,6 +329,21 @@ interface RecordsAdminI18n {
      * `{name}` is replaced with the friendly label of the dirty record.
      */
     unsavedBannerBody: string;
+    /**
+     * Shell-level "Save all" tray strings (multi-record dirty workflow).
+     * `{n}` placeholders interpolate the count.
+     */
+    unsavedTrayCount: string;
+    unsavedTrayErrors: string;
+    saveAll: string;
+    discardAll: string;
+    saveAllInProgress: string;
+    saveAllSuccess: string;
+    saveAllErrorTitle: string;
+    saveAllStop: string;
+    saveAllClose: string;
+    saveAllRetryFailed: string;
+    saveAllJumpToError: string;
     /** Presentation mode switcher labels. */
     presentationList: string;
     presentationCompact: string;
@@ -541,6 +556,8 @@ interface RecordSlotContext {
     selected: boolean;
     onSelect: () => void;
     isDirty?: boolean;
+    /** True when the row has a draft whose last save attempt failed. */
+    hasError?: boolean;
     /**
      * Resolved i18n strings for the shell. Default row/card renderers use this
      * for fallback subtitles ("Not set", "Configured", "Inherited") so apps
@@ -1033,6 +1050,15 @@ interface Props$c {
     dirtyId?: string;
     /** Anchor-key equivalent of `dirtyId` for non-record-backed tabs. */
     dirtyAnchorKey?: string;
+    /**
+     * Optional set of record IDs (or anchor refs) that have unsaved changes
+     * registered with the shell-level dirty-draft store. Used by the shell to
+     * paint dirty/error pips on rows the user has edited but isn't currently
+     * looking at. `dirtyId`/`dirtyAnchorKey` remain for the active editor.
+     */
+    dirtyKeys?: ReadonlySet<string>;
+    /** Subset of `dirtyKeys` whose last save attempt failed. */
+    errorKeys?: ReadonlySet<string>;
     /** Rail row density. Defaults to `list`. */
     presentation?: RecordPresentation;
     /** Optional custom row renderer (still dense — applied to both densities). */
@@ -1058,11 +1084,11 @@ interface Props$c {
     /** Resolved i18n strings — used by default row/card renderers. */
     i18n?: RecordsAdminI18n;
 }
-declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
 
 interface DefaultRecordRowProps {
     record: RecordSummary;
@@ -1952,6 +1978,83 @@ declare const useDirtyNavigation: ({ strategy, isDirty, save, reset, confirm, i1
     runWithGuard: (action: () => void) => Promise<boolean>;
 };
 
+type DirtyDraftStatus = 'dirty' | 'saving' | 'saved' | 'error';
+interface DirtyDraft {
+    /** Stable key — recordId for saved rows, `draft:{kind}:{scope.raw}` otherwise. */
+    key: string;
+    /** Friendly label for the tray + per-record progress rows. */
+    label: string;
+    /** Optional secondary descriptor (e.g. scope kind / facet). */
+    context?: string;
+    /** ParsedRef.raw — used to re-select the record from the tray. */
+    scopeRaw: string;
+    /** When set, selecting this draft from the tray loads a saved row by id. */
+    recordId?: string;
+    /** Insertion order — drives the visual order in the tray + overlay. */
+    order: number;
+    /** Current value being edited. */
+    value: unknown;
+    /** Optional facet rule attached to the value. */
+    facetRule: FacetRule | null;
+    /** Last-saved baseline for the same record (for diff/discard). */
+    baseline: unknown;
+    baselineFacetRule: FacetRule | null;
+    /** Whether this draft must be inserted (collection-cardinality items). */
+    createMode: boolean;
+    /** Anchor IDs for the save call. */
+    scopeAnchors: RecordAnchors;
+    /** Optional external ref (rule:{id}) to send with the save. */
+    ref?: string;
+    /** Save kind decided at draft creation time. */
+    saveKind: 'update' | 'create' | 'upsert';
+    status: DirtyDraftStatus;
+    error?: unknown;
+    /**
+     * Performs the save against the SDK. Captured at draft creation time so
+     * the overlay doesn't need access to the editor's resolver/ctx — keeps
+     * the registry self-contained.
+     */
+    save: () => Promise<void>;
+}
+type Listener = () => void;
+interface DirtyDraftStore {
+    list(): DirtyDraft[];
+    get(key: string): DirtyDraft | undefined;
+    has(key: string): boolean;
+    upsertDraft(input: Omit<DirtyDraft, 'order' | 'status'> & {
+        order?: number;
+        status?: DirtyDraftStatus;
+    }): void;
+    setStatus(key: string, status: DirtyDraftStatus, error?: unknown): void;
+    clearDraft(key: string): void;
+    clearAll(): void;
+    subscribe(listener: Listener): () => void;
+}
+declare const DirtyDraftProvider: ({ children }: {
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+/** Always returns a store — falls back to a noop when no provider is mounted
+ *  so the hook can be called from inside `useRecordEditor` without forcing
+ *  every host of the editor to wrap themselves in a provider. */
+declare const useDirtyDraftStore: () => DirtyDraftStore;
+/** Subscribe to the store and re-render on any change. */
+declare const useDirtyDrafts: () => DirtyDraft[];
+/** Subscribe to a single draft (or undefined) by key. */
+declare const useDirtyDraft: (key: string | undefined) => DirtyDraft | undefined;
+/** Build the canonical key for a draft. */
+declare const buildDraftKey: (opts: {
+    recordId?: string;
+    scopeRaw: string;
+    draftKind?: string;
+}) => string;
+/** Hook used by the shell tray to count + bulk-save. */
+declare const useDirtyDraftActions: () => {
+    drafts: DirtyDraft[];
+    count: number;
+    errorCount: number;
+    store: DirtyDraftStore;
+};
+
 declare function usePresentationPref(args: {
     appId: string;
     recordType?: string;
@@ -2037,9 +2140,18 @@ interface Props<T> {
     error: Error | null;
     onBack: () => void;
     onSelect: (itemId: string) => void;
+    /**
+     * Set of keys (recordIds + scope refs) currently dirty in the shell-level
+     * draft store. Used to paint a per-row pip on items the user has edited
+     * but isn't currently looking at — mirrors the affordance the scope rail
+     * gets via `RecordList.dirtyKeys`.
+     */
+    dirtyKeys?: ReadonlySet<string>;
+    /** Subset of `dirtyKeys` whose last save attempt failed. */
+    errorKeys?: ReadonlySet<string>;
     i18n: Pick<RecordsAdminI18n, 'backToScopes' | 'siblingsHeading' | 'noItemsTitle' | 'noItemsBody'>;
 }
-declare function SiblingRail<T>({ items, selectedItemId, isLoading, error, onBack, onSelect, i18n, }: Props<T>): react_jsx_runtime.JSX.Element;
+declare function SiblingRail<T>({ items, selectedItemId, isLoading, error, onBack, onSelect, dirtyKeys, errorKeys, i18n, }: Props<T>): react_jsx_runtime.JSX.Element;
 
 interface ClipboardEntry<T = unknown> {
     value: T;
@@ -2158,4 +2270,4 @@ declare const exportCsv: <T>(records: RecordSummary<T>[], schema: CsvSchema<T>)
 declare const importCsv: <T>(file: File, schema: CsvSchema<T>, ctx: RecordsCtx) => Promise<ImportReport>;
 declare const downloadBlob: (blob: Blob, filename: string) => void;
 
-export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, type ClipboardEntry, type CollectedRecord, type CollectedSort, type CollectionRailMode, type CsvSchema, type CsvSchemaColumn, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, type DeepLinkAdapter, type DeepLinkChangeKind, type DeepLinkHistoryMode, type DeepLinkOptions, type DeepLinkParamNames, type DeepLinkState, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, type DirtyStrategy, DrawerPreview, type EditorContext, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, type ItemColumn, ItemListView, type ItemSlotContext, type ItemView, type ItemViewContext, ItemViewSwitcher, LoadingState, type MergeStrategy, type MergedRecord, type NavConfirmI18n, type ParsedRef, type PasteCompatibility, type PasteCompatibilityResult, PresentationSwitcher, type PreviewMode, PreviewScopePicker, PreviewToggleButton, type ProductBrowseItem, type ProductChildItem, ProductDrillDown, ProductList, type RecordBadge, RecordBrowser, type RecordCardinality, RecordEditor, RecordList, type RecordPresentation, type RecordSlotContext, type RecordSource, type RecordStatus, type RecordSummary, type RecordsAdminI18n, type RecordsAdminIcons, RecordsAdminShell, type RecordsAdminShellProps, type ResolvedDeepLinkParamNames, ResolvedPreview, type ResolvedRecord, ScopeBreadcrumb, type ScopeKind, ScopeTabs, SiblingRail, SidePreview, type SmartLinksSDK, StatusDot, StatusFilterPills, StatusIcon, type StatusTone, TabbedPreview, type TelemetryEvent, type UseCollectionItemsArgs, type UseRecordClipboardArgs, type UseRecordClipboardReturn, type UseResolveAllRecordsArgs, type UseResolveAllResult, type UseRulePreviewArgs, type UseRulePreviewResult, UtilityRow, VariantList, buildRef, bulkDelete, bulkUpsert, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createRecord, downloadBlob, exportCsv, getRecordById, importCsv, listRecords, matchRecords, mergeIcons, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, removeRecord, resolutionChain, resolveRecord, restoreRecord, scopesEqual, statusToneLabel, upsertRecord, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeProbe, useUnsavedGuard };
+export { ALL_ITEM_VIEWS, ALL_PRESENTATIONS, BatchList, BulkActionsMenu, type ClipboardEntry, type CollectedRecord, type CollectedSort, type CollectionRailMode, type CsvSchema, type CsvSchemaColumn, DEFAULT_DEEP_LINK_PARAM_NAMES, DEFAULT_I18N, DEFAULT_ICONS, type DeepLinkAdapter, type DeepLinkChangeKind, type DeepLinkHistoryMode, type DeepLinkOptions, type DeepLinkParamNames, type DeepLinkState, DefaultItemCards, DefaultItemTable, DefaultRecordCard, DefaultRecordRow, DeleteButton, type DirtyDraft, DirtyDraftProvider, type DirtyDraftStatus, type DirtyDraftStore, type DirtyStrategy, DrawerPreview, type EditorContext, EditorItemNav, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, type ItemColumn, ItemListView, type ItemSlotContext, type ItemView, type ItemViewContext, ItemViewSwitcher, LoadingState, type MergeStrategy, type MergedRecord, type NavConfirmI18n, type ParsedRef, type PasteCompatibility, type PasteCompatibilityResult, PresentationSwitcher, type PreviewMode, PreviewScopePicker, PreviewToggleButton, type ProductBrowseItem, type ProductChildItem, ProductDrillDown, ProductList, type RecordBadge, RecordBrowser, type RecordCardinality, RecordEditor, RecordList, type RecordPresentation, type RecordSlotContext, type RecordSource, type RecordStatus, type RecordSummary, type RecordsAdminI18n, type RecordsAdminIcons, RecordsAdminShell, type RecordsAdminShellProps, type ResolvedDeepLinkParamNames, ResolvedPreview, type ResolvedRecord, ScopeBreadcrumb, type ScopeKind, ScopeTabs, SiblingRail, SidePreview, type SmartLinksSDK, StatusDot, StatusFilterPills, StatusIcon, type StatusTone, TabbedPreview, type TelemetryEvent, type UseCollectionItemsArgs, type UseRecordClipboardArgs, type UseRecordClipboardReturn, type UseResolveAllRecordsArgs, type UseResolveAllResult, type UseRulePreviewArgs, type UseRulePreviewResult, UtilityRow, VariantList, buildDraftKey, buildRef, bulkDelete, bulkUpsert, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createRecord, downloadBlob, exportCsv, getRecordById, importCsv, listRecords, matchRecords, mergeIcons, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, removeRecord, resolutionChain, resolveRecord, restoreRecord, scopesEqual, statusToneLabel, upsertRecord, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeProbe, useUnsavedGuard };