@proveanything/smartlinks-utils-ui 0.9.12 → 0.10.0

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

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType } from 'react';
+import { ComponentType, ReactNode } from 'react';
 import { FacetRule, MatchedAt, RecordTarget, AppRecord, MatchResult, ResolveAllEntry } from '@proveanything/smartlinks/dist/types/appObjects';
 import { LucideIcon } from 'lucide-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
@@ -295,6 +295,13 @@ type TelemetryEvent = {
     sourceRef: string;
     destinationRef: string;
     replaced: boolean;
+}
+/** Host-defined `recordActions` menu item invoked from a row / card / item-table row. */
+ | {
+    type: 'recordAction.invoke';
+    recordType?: string;
+    key: string;
+    ref: string;
 };
 
 interface RecordsAdminI18n {
@@ -396,6 +403,15 @@ interface RecordsAdminI18n {
     clipboardEmpty: string;
     copyToast: string;
     pasteToast: string;
+    /**
+     * Row-menu label for the one-shot Duplicate action — copies the row's
+     * value (through the host's `clipboard.onCopy` if any) and immediately
+     * seeds a fresh draft with it. Apps can rebrand for their domain
+     * (e.g. "Run this vote again", "Clone competition", "Duplicate FAQ").
+     */
+    duplicateAction: string;
+    /** Toast shown after a successful Duplicate. `{name}` = source label. */
+    duplicateToast: string;
     /** Confirm dialog when pasting onto a destination with an existing saved value. */
     pasteConfirmTitle: string;
     pasteConfirmBody: string;
@@ -636,6 +652,33 @@ type RecordsAdminActionKey = 'save' | 'discard' | 'delete' | 'saveAll' | 'revert
 type RecordsAdminActionIcon = ComponentType<{
     className?: string;
 }>;
+/**
+ * Host-defined action that appears in the row / card / table-row context
+ * menu (the `…` kebab) for a single record. Use this to surface domain
+ * actions like "Run again", "Archive", "Publish" without forking the
+ * default row renderers.
+ *
+ * Visibility / disable is computed by the host in the
+ * `recordActions(record, scope)` callback — return only the actions that
+ * apply to this record. Returning `[]` (or omitting the prop) leaves the
+ * menu showing only the built-in Copy / Duplicate items.
+ */
+interface RecordAction {
+    /** Stable key — used for React keys and telemetry. */
+    key: string;
+    /** Visible menu label. */
+    label: string;
+    /** Optional Lucide-style icon component rendered before the label. */
+    icon?: RecordsAdminActionIcon;
+    /** Visual tone. `'danger'` paints the item with the destructive colour. */
+    variant?: 'default' | 'danger';
+    /** Disable the menu item. Combine with `disabledReason` for a tooltip. */
+    disabled?: boolean;
+    /** Tooltip shown when the item is disabled. */
+    disabledReason?: string;
+    /** Invoked when the user clicks the item. */
+    onAction: () => void | Promise<void>;
+}
 /** Minimal SDK shape consumed by the shell. */
 type SmartLinksSDK = any;
 /** Slot context passed to renderCard / renderListRow. */
@@ -657,6 +700,14 @@ interface RecordSlotContext {
      * clipboard. Wired by the shell — apps don't need to implement it.
      */
     onCopy?: () => void;
+    /**
+     * One-shot Duplicate — copies this row's value (running through
+     * `clipboard.onCopy` if the host supplied one) and immediately seeds a
+     * fresh draft with it. Only present in collection cardinality where
+     * "create another item" makes sense. Apps rebrand the menu label via
+     * `i18n.duplicateAction` (e.g. "Run this vote again").
+     */
+    onDuplicate?: () => void;
     /**
      * Paste the current clipboard entry onto this row. Disabled when there is
      * nothing to paste, when the source ref equals this row, or when the
@@ -673,6 +724,13 @@ interface RecordSlotContext {
     canPaste?: boolean;
     /** Friendly label for "Paste from {sourceLabel}" in row menus. */
     clipboardSourceLabel?: string;
+    /**
+     * Host-supplied custom actions for this row's `…` menu. Rendered after
+     * the built-in Copy / Duplicate items, separated by a divider. Wired by
+     * the shell from the top-level `recordActions` prop — apps don't need
+     * to populate this directly.
+     */
+    actions?: RecordAction[];
 }
 /**
  * Declarative column definition for the built-in default item table.
@@ -720,6 +778,12 @@ interface ItemSlotContext extends ItemViewContext {
      * without having to remember the item id or fight click-bubbling.
      */
     onSelect: () => void;
+    /**
+     * Host-supplied custom actions for this item — same shape as the rail's
+     * `RecordSlotContext.actions`. Wired by the shell from `recordActions`.
+     * The built-in card / table renderers expose them in a `…` menu.
+     */
+    actions?: RecordAction[];
 }
 interface RecordsAdminShellProps<TData = unknown> {
     SL: SmartLinksSDK;
@@ -784,6 +848,25 @@ interface RecordsAdminShellProps<TData = unknown> {
     unsaved?: UnsavedConfig<TData>;
     clipboard?: ClipboardConfig<TData>;
     actions?: ActionsConfig;
+    /**
+     * Return host-defined custom actions for a given record. Rendered in
+     * the `…` context menu on the rail row, the rail card, the item-table
+     * row, and the item card — after the built-in Copy / Duplicate items.
+     *
+     * Use the host's own predicate to gate per-record visibility — e.g.
+     * only return a `"Run again"` action for ended competitions:
+     *
+     * ```ts
+     * recordActions: (record) =>
+     *   record.data?.endedAt
+     *     ? [{ key: 'rerun', label: 'Run this vote again', icon: RotateCcw,
+     *          onAction: () => duplicateAndOpen(record) }]
+     *     : []
+     * ```
+     *
+     * Return `null` / `undefined` / `[]` to add no extra items.
+     */
+    recordActions?: (record: RecordSummary<TData>, scope: ParsedRef) => RecordAction[] | null | undefined;
     /**
      * Opt-in awaited callbacks fired around record save/delete. See
      * {@link RecordsAdminShellHooks} for the contract.
@@ -1138,19 +1221,22 @@ interface Props$c {
      */
     rowClipboard?: (record: RecordSummary) => {
         onCopy?: () => void;
-        onPaste?: () => void;
-        canPaste?: boolean;
-        pasteWillReplace?: boolean;
-        clipboardSourceLabel?: string;
+        onDuplicate?: () => void;
     } | null;
+    /**
+     * Optional host-supplied per-record action lookup. Returned actions are
+     * appended to each row's `…` menu after Copy / Duplicate. The shell
+     * wires this from its top-level `recordActions` prop.
+     */
+    rowActions?: (record: RecordSummary) => RecordAction[] | null | undefined;
     /** Resolved i18n strings — used by default row/card renderers. */
     i18n?: RecordsAdminI18n;
 }
-declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
-declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const RecordList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const ProductList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const FacetList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const VariantList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
+declare const BatchList: ({ items, selectedId, selectedAnchorKey, onSelect, dirtyId, dirtyAnchorKey, dirtyKeys, errorKeys, presentation, renderListRow, groupBy, renderGroupActions, rowClipboard, rowActions, i18n, }: Props$c) => react_jsx_runtime.JSX.Element;
 
 interface DefaultRecordRowProps {
     record: RecordSummary;
@@ -2256,9 +2342,20 @@ interface Props$5<T> {
     itemColumns?: ItemColumn<T>[];
     /** Card density for cards/gallery views. */
     cardSize?: 'sm' | 'md' | 'lg';
+    /** Per-record host actions for the `…` menu in cards / table rows. */
+    rowActions?: (record: RecordSummary<T>) => RecordAction[] | null | undefined;
+    /**
+     * Per-record clipboard wiring. When supplied, the built-in card / table
+     * row `…` menu also offers Copy / Duplicate next to host actions. Wired
+     * by the shell from `enableClipboard`.
+     */
+    rowClipboard?: (record: RecordSummary<T>) => {
+        onCopy?: () => void;
+        onDuplicate?: () => void;
+    } | null;
     i18n: RecordsAdminI18n;
 }
-declare function ItemListView<T>({ items, isLoading, error, ctx, itemNoun, ruleSummary, view, views, onViewChange, renderItemList, renderItemCard, renderItemEmpty, itemColumns, cardSize, i18n, }: Props$5<T>): react_jsx_runtime.JSX.Element;
+declare function ItemListView<T>({ items, isLoading, error, ctx, itemNoun, ruleSummary, view, views, onViewChange, renderItemList, renderItemCard, renderItemEmpty, itemColumns, cardSize, rowActions, rowClipboard, i18n, }: Props$5<T>): react_jsx_runtime.JSX.Element;
 
 interface Props$4 {
     options: ItemView[];
@@ -2274,9 +2371,16 @@ interface Props$3<T> {
     selectedId?: string;
     onOpen: (itemId: string) => void;
     onDelete: (itemId: string) => void;
+    /** Host-supplied per-record menu actions for each row's `…` kebab. */
+    rowActions?: (record: RecordSummary<T>) => RecordAction[] | null | undefined;
+    /** Per-record Copy / Duplicate wiring from the shell clipboard. */
+    rowClipboard?: (record: RecordSummary<T>) => {
+        onCopy?: () => void;
+        onDuplicate?: () => void;
+    } | null;
     i18n: Pick<RecordsAdminI18n, 'itemColumnLabel' | 'itemColumnUpdated' | 'itemActions' | 'delete'>;
 }
-declare function DefaultItemTable<T>({ items, columns, selectedId, onOpen, onDelete, i18n, }: Props$3<T>): react_jsx_runtime.JSX.Element;
+declare function DefaultItemTable<T>({ items, columns, selectedId, onOpen, onDelete, rowActions, rowClipboard, i18n, }: Props$3<T>): react_jsx_runtime.JSX.Element;
 
 interface Props$2<T> {
     items: RecordSummary<T>[];
@@ -2285,9 +2389,16 @@ interface Props$2<T> {
     ctx: ItemViewContext;
     renderCard?: (record: RecordSummary<T>, slotCtx: ItemSlotContext) => ReactNode;
     cardSize?: 'sm' | 'md' | 'lg';
+    /** Host-supplied per-record menu actions appended to each card's `…`. */
+    rowActions?: (record: RecordSummary<T>) => RecordAction[] | null | undefined;
+    /** Per-record Copy / Duplicate wiring from the shell clipboard. */
+    rowClipboard?: (record: RecordSummary<T>) => {
+        onCopy?: () => void;
+        onDuplicate?: () => void;
+    } | null;
     i18n: Pick<RecordsAdminI18n, 'delete'>;
 }
-declare function DefaultItemCards<T>({ items, variant, selectedId, ctx, renderCard, cardSize, i18n, }: Props$2<T>): react_jsx_runtime.JSX.Element;
+declare function DefaultItemCards<T>({ items, variant, selectedId, ctx, renderCard, cardSize, rowActions, rowClipboard, i18n, }: Props$2<T>): react_jsx_runtime.JSX.Element;
 
 interface Props$1 {
     /** Friendly name of the item being edited (mostly for screen readers). */
@@ -2487,4 +2598,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 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 NormalisedRule, 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, type RouterParamsGetter, type RouterParamsSetter, ScopeBreadcrumb, type ScopeCounts, 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, type UseScopeCountsArgs, type UseScopeCountsResult, UtilityRow, VariantList, buildDraftKey, buildRef, bulkDelete, bulkUpsert, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, createRecord, createRouterDeepLinkAdapter, downloadBlob, exportCsv, getRecordById, importCsv, isInSmartLinksIframe, listRecords, matchRecords, mergeIcons, normaliseRule, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, removeRecord, resolutionChain, resolveRecord, restoreRecord, ruleHash, rulesEqual, scopeCountsQueryKey, scopesEqual, statusToneLabel, summariseRule, upsertRecord, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, 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 NormalisedRule, type ParsedRef, type PasteCompatibility, type PasteCompatibilityResult, PresentationSwitcher, type PreviewMode, PreviewScopePicker, PreviewToggleButton, type ProductBrowseItem, type ProductChildItem, ProductDrillDown, ProductList, type RecordAction, type RecordBadge, RecordBrowser, type RecordCardinality, RecordEditor, RecordList, type RecordPresentation, type RecordSlotContext, type RecordSource, type RecordStatus, type RecordSummary, type RecordsAdminActionIcon, type RecordsAdminActionKey, type RecordsAdminI18n, type RecordsAdminIcons, RecordsAdminShell, type RecordsAdminShellProps, type ResolvedDeepLinkParamNames, ResolvedPreview, type ResolvedRecord, type RouterParamsGetter, type RouterParamsSetter, ScopeBreadcrumb, type ScopeCounts, 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, type UseScopeCountsArgs, type UseScopeCountsResult, UtilityRow, VariantList, buildDraftKey, buildRef, bulkDelete, bulkUpsert, checkPasteCompatibility, cloneValue, createDefaultDeepLinkAdapter, createPostMessageDeepLinkAdapter, createRecord, createRouterDeepLinkAdapter, downloadBlob, exportCsv, getRecordById, importCsv, isInSmartLinksIframe, listRecords, matchRecords, mergeIcons, normaliseRule, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, removeRecord, resolutionChain, resolveRecord, restoreRecord, ruleHash, rulesEqual, scopeCountsQueryKey, scopesEqual, statusToneLabel, summariseRule, upsertRecord, useCollectedRecords, useCollectionItems, useDeepLinkState, useDirtyDraft, useDirtyDraftActions, useDirtyDraftStore, useDirtyDrafts, useDirtyNavigation, useFacetBrowse, useIntroDismissed, useItemViewPref, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordClipboard, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeCounts, useScopeProbe, useUnsavedGuard };