@proveanything/smartlinks-utils-ui 0.3.0 → 0.3.2

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

@@ -1,2 +1,28 @@
-export { a as AssetItem, c as AssetPicker, d as AssetPickerMode, e as AssetPickerProps, f as AssetPickerSelection, g as AssetScope, h as AssetViewMode, u as useAssets } from '../../index-BmKyfKiK.js';
+export { a as AssetItem, c as AssetPicker, d as AssetPickerMode, e as AssetPickerProps, f as AssetPickerSelection, g as AssetScope, h as AssetViewMode, u as useAssets } from '../../useAssets-BM1bzzkq.js';
 import 'react';
+
+interface AppRegistryEntry {
+    /** Installed app instance id (matches the asset's `appId`). */
+    id: string;
+    /** Friendly display name (falls back to id if missing). */
+    name: string;
+    faIcon?: string;
+    hidden?: boolean;
+    category?: string;
+}
+interface UseAppRegistryReturn {
+    apps: AppRegistryEntry[];
+    loading: boolean;
+    /** Returns the friendly name for an appId, or the id itself when unknown. */
+    getAppName: (appId: string | undefined | null) => string;
+    /** Returns the full registry entry, or undefined if the id is unknown. */
+    getApp: (appId: string | undefined | null) => AppRegistryEntry | undefined;
+}
+/**
+ * Loads the app registry for a collection. When `collectionId` is falsy, returns
+ * an empty registry — callers can safely use `getAppName(id)` which falls back to
+ * the raw id in that case.
+ */
+declare function useAppRegistry(collectionId: string | undefined): UseAppRegistryReturn;
+
+export { type AppRegistryEntry, type UseAppRegistryReturn, useAppRegistry };

package/dist/components/AssetPicker/index.js

@@ -1,4 +1,5 @@
-export { AssetPicker, useAssets } from '../../chunk-XA5J6CZL.js';
+export { AssetPicker, useAppRegistry, useAssets } from '../../chunk-UDYVH7QF.js';
+import '../../chunk-WFNEZQCD.js';
 import '../../chunk-L7FQ52F5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -1,132 +1,7 @@
-import React$1 from 'react';
+import React from 'react';
+import { d as ConditionsEditorProps } from '../../types-a2DdgZ2H.js';
+export { C as Condition, a as ConditionGroup, b as ConditionType, c as ConditionTypeMeta, F as FacetOption, e as FacetValueOption, S as SelectOption, V as VersionOption } from '../../types-a2DdgZ2H.js';
 
-/** Condition type identifiers */
-type ConditionType = 'version' | 'country' | 'value' | 'user' | 'date' | 'device' | 'tag' | 'facet' | 'geofence' | 'product' | 'itemStatus' | 'condition';
-/** A single condition rule — shape varies by type */
-interface Condition {
-    type?: ConditionType | null;
-    contains?: boolean;
-    versions?: Array<{
-        title?: string;
-        value?: string | null;
-    } | string>;
-    countries?: string[];
-    useRegions?: boolean;
-    regions?: string[];
-    field?: string;
-    fieldType?: 'boolean' | 'integer' | 'text';
-    validationType?: 'equal' | 'not' | 'greater' | 'less';
-    value?: string | number | boolean;
-    userType?: 'valid' | 'invalid' | 'owner' | 'group' | 'admin';
-    groupIds?: string[];
-    dateTest?: 'before' | 'after' | 'between';
-    beforeDate?: string;
-    afterDate?: string;
-    rangeDate?: string;
-    displays?: string[];
-    tags?: string[];
-    facetKey?: string;
-    valueKeys?: string[];
-    lat1?: number;
-    lng1?: number;
-    lat2?: number;
-    lng2?: number;
-    productIds?: string[];
-    statusType?: 'hasProof' | 'noProof' | 'isClaimable' | 'notClaimable' | 'hasOwner' | 'isVirtual';
-    conditionId?: string;
-    passes?: boolean;
-}
-/** Top-level condition group */
-interface ConditionGroup {
-    type: 'and' | 'or';
-    conditions: Condition[];
-    /** Only for global/saved conditions */
-    title?: string;
-    disabled?: boolean;
-}
-/** Metadata for a condition type */
-interface ConditionTypeMeta {
-    value: ConditionType;
-    title: string;
-    description: string;
-    icon: string;
-    color: string;
-    helpText: string;
-}
-/** Version option provided to the editor */
-interface VersionOption {
-    title: string;
-    value: string | null;
-}
-/** A selectable option with label + value */
-interface SelectOption {
-    title: string;
-    value: string;
-    description?: string;
-}
-/** Props for the conditions editor */
-interface ConditionsEditorProps {
-    /** The current condition group (controlled) */
-    value: ConditionGroup;
-    /** Called when conditions change */
-    onChange: (value: ConditionGroup) => void;
-    /** Display mode: inline renders directly, dialog opens in a modal */
-    mode?: 'inline' | 'dialog';
-    /** Custom trigger element for dialog mode */
-    trigger?: React.ReactNode;
-    /** Controlled open state for dialog mode */
-    open?: boolean;
-    /** Called when dialog closes */
-    onClose?: () => void;
-    /** If true, shows title + disabled fields for saved/global conditions */
-    isGlobal?: boolean;
-    /** Available version options (from collection) */
-    versions?: VersionOption[];
-    /** Available tag/label options (from collection) */
-    tags?: string[];
-    /** Available product options for product condition */
-    products?: SelectOption[];
-    /** Available saved conditions for condition references */
-    savedConditions?: SelectOption[];
-    /** Available user groups */
-    userGroups?: SelectOption[];
-    /**
-     * Available facet definitions for the 'facet' condition. If omitted and
-     * `collectionId` is provided, the editor will lazy-fetch them via
-     * `SL.facets.publicList(collectionId, { includeValues: true })`.
-     */
-    facets?: FacetOption[];
-    /**
-     * Optional collection id used to auto-fetch facets (and any other
-     * collection-scoped lookups) when the corresponding prop is not supplied.
-     */
-    collectionId?: string;
-    /**
-     * Optional explicit facet fetcher. Called with the resolved `collectionId`
-     * and must return `FacetOption[]`. By default the editor calls
-     * `SL.facets.publicList(collectionId, { includeValues: true })` directly —
-     * only provide this if you need to override that data source.
-     */
-    getFacets?: (collectionId: string) => Promise<FacetOption[]>;
-    /** Whether the editor is read-only */
-    readOnly?: boolean;
-    /** Additional CSS class */
-    className?: string;
-}
-/** A facet definition + its selectable values, as exposed to the editor. */
-interface FacetOption {
-    key: string;
-    name: string;
-    cardinality?: 'single' | 'multi';
-    values: FacetValueOption[];
-}
-interface FacetValueOption {
-    key: string;
-    name: string;
-    color?: string | null;
-    description?: string | null;
-}
+declare const ConditionsEditor: React.FC<ConditionsEditorProps>;
 
-declare const ConditionsEditor: React$1.FC<ConditionsEditorProps>;
-
-export { type Condition, type ConditionGroup, type ConditionType, type ConditionTypeMeta, ConditionsEditor, type ConditionsEditorProps, type FacetOption, type FacetValueOption, type SelectOption, type VersionOption };
+export { ConditionsEditor, ConditionsEditorProps };

package/dist/components/ConditionsEditor/index.js

@@ -1,4 +1,6 @@
-export { ConditionsEditor } from '../../chunk-GN2P3MOG.js';
+export { ConditionsEditor } from '../../chunk-7UBXTFZQ.js';
+import '../../chunk-WFNEZQCD.js';
+import '../../chunk-4LHF5JB7.js';
 import '../../chunk-L7FQ52F5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,42 @@
+import React from 'react';
+import { FacetRule } from '@proveanything/smartlinks/dist/types/appObjects';
+export { FacetRule, FacetRuleClause } from '@proveanything/smartlinks/dist/types/appObjects';
+import { F as FacetOption } from '../../types-a2DdgZ2H.js';
+
+interface FacetRuleEditorProps {
+    /** The current rule (controlled). `null` ⇒ no rule yet. */
+    value: FacetRule | null;
+    /** Fires whenever the rule changes. */
+    onChange: (next: FacetRule | null) => void;
+    /**
+     * Known facets for the collection. If omitted **and** `collectionId` is set,
+     * the editor lazy-fetches them via `SL.facets.publicList`. Free-text entry
+     * is **not** supported — admins must pick from defined facets.
+     */
+    facets?: FacetOption[];
+    collectionId?: string;
+    getFacets?: (collectionId: string) => Promise<FacetOption[]>;
+    /**
+     * Live "matches N products" preview. Pass these to enable; omit to hide
+     * the preview chip. Typically wired through `useRulePreview`.
+     */
+    preview?: {
+        totalMatches: number | null;
+        sampleProductIds?: string[];
+        isLoading?: boolean;
+        isStale?: boolean;
+        error?: Error | null;
+    };
+    readOnly?: boolean;
+    /** Renders a "Remove rule" affordance. */
+    onClear?: () => void;
+    /** Optional label rendered above the editor. */
+    title?: string;
+    /** Optional helper text rendered below the title. */
+    description?: string;
+    className?: string;
+}
+
+declare const FacetRuleEditor: React.FC<FacetRuleEditorProps>;
+
+export { FacetOption, FacetRuleEditor, type FacetRuleEditorProps };

package/dist/components/FacetRuleEditor/index.js

@@ -0,0 +1,5 @@
+export { FacetRuleEditor } from '../../chunk-MZ6JSCXO.js';
+import '../../chunk-4LHF5JB7.js';
+import '../../chunk-L7FQ52F5.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/FacetRuleEditor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/components/FontPicker/index.js

@@ -1,4 +1,5 @@
-export { CATEGORY_FALLBACKS, CATEGORY_LABELS, FontPicker, GOOGLE_FONTS_CATALOG, getGoogleFontUrl } from '../../chunk-4Z46C4MJ.js';
+export { CATEGORY_FALLBACKS, CATEGORY_LABELS, FontPicker, GOOGLE_FONTS_CATALOG, getGoogleFontUrl } from '../../chunk-OTJV62XV.js';
+import '../../chunk-WFNEZQCD.js';
 import '../../chunk-L7FQ52F5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/components/IconPicker/index.js

@@ -1,4 +1,5 @@
-export { IconPicker, parseFaClass, toFaClass } from '../../chunk-S6KH3YV4.js';
+export { IconPicker, parseFaClass, toFaClass } from '../../chunk-JQPS5XPJ.js';
+import '../../chunk-WFNEZQCD.js';
 import '../../chunk-L7FQ52F5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import * as _proveanything_smartlinks_dist_types_appObjects from '@proveanything/smartlinks/dist/types/appObjects';
+import { MatchedAt, FacetRule, RecordScope, AppRecord, RecordTarget, MatchResult, MatchEntry } from '@proveanything/smartlinks/dist/types/appObjects';
+import { LucideIcon } from 'lucide-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
-import { RecordScope, AppRecord, RecordTarget, MatchResult } from '@proveanything/smartlinks/dist/types/appObjects';
 
 type ScopeKind = 'product' | 'facet' | 'variant' | 'batch';
 /** Parsed `ref` string — see `data/refs.ts`. Format: `kind:id` or chain. */
@@ -59,6 +61,14 @@ interface ResolvedRecord<TData = unknown> {
     sourceRef?: string;
     /** The parent value that would be inherited if this scope cleared its override. */
     parentValue?: TData | null;
+    /**
+     * Which resolution tier the SDK reported caused the match.
+     * Use this for badges like "Inherited from product" / "Matched by rule".
+     * Present when the resolver ran via SDK 1.10 `match()`/`resolveAll()`.
+     */
+    matchedAt?: MatchedAt;
+    /** The rule that fired. Present only when `matchedAt === 'rule'`. */
+    matchedRule?: FacetRule;
 }
 
 interface EditorContext<TData = unknown> {
@@ -123,42 +133,42 @@ type CollectedSort = {
 
 type TelemetryEvent = {
     type: 'record.save';
-    recordType: string;
+    recordType?: string;
     ref: string;
     isCreate: boolean;
 } | {
     type: 'record.delete';
-    recordType: string;
+    recordType?: string;
     ref: string;
 } | {
     type: 'scope.change';
-    recordType: string;
+    recordType?: string;
     from: ScopeKind;
     to: ScopeKind;
 } | {
     type: 'intro.dismiss';
-    recordType: string;
+    recordType?: string;
 } | {
     type: 'csv.import';
-    recordType: string;
+    recordType?: string;
     rows: number;
     errors: number;
 } | {
     type: 'csv.export';
-    recordType: string;
+    recordType?: string;
     rows: number;
 } | {
     type: 'bulk.apply';
-    recordType: string;
+    recordType?: string;
     targetCount: number;
 } | {
     type: 'presentation.change';
-    recordType: string;
+    recordType?: string;
     from: RecordPresentation;
     to: RecordPresentation;
 } | {
     type: 'item.create';
-    recordType: string;
+    recordType?: string;
     scopeRef: string;
 };
 
@@ -212,6 +222,52 @@ interface RecordsAdminI18n {
 }
 declare const DEFAULT_I18N: RecordsAdminI18n;
 
+interface RecordsAdminIcons {
+    scope: Record<ScopeKind | 'universal', LucideIcon>;
+    status: {
+        own: LucideIcon;
+        inherited: LucideIcon;
+        missing: LucideIcon;
+    };
+    action: {
+        add: LucideIcon;
+        edit: LucideIcon;
+        duplicate: LucideIcon;
+        delete: LucideIcon;
+        import: LucideIcon;
+        export: LucideIcon;
+        more: LucideIcon;
+    };
+    preview: {
+        eye: LucideIcon;
+        switch: LucideIcon;
+    };
+    empty: {
+        default: LucideIcon;
+        search: LucideIcon;
+    };
+    intro: {
+        info: LucideIcon;
+    };
+    /** Header — used when no `headerIcon` prop is passed. Apps can override
+     *  `byRecordType[recordType]` for a contextual icon, or `default` as the
+     *  catch-all. */
+    header: {
+        default: LucideIcon;
+        byRecordType: Record<string, LucideIcon>;
+    };
+    group: {
+        chevron: LucideIcon;
+    };
+}
+/** Library defaults — every consumer gets these unless `icons` is overridden. */
+declare const DEFAULT_ICONS: RecordsAdminIcons;
+/** Deep-merge an `icons` prop onto the defaults. */
+declare function mergeIcons(override?: Partial<RecordsAdminIcons>): RecordsAdminIcons;
+/** Look up the right header icon based on prop precedence:
+ *  explicit `headerIcon` > `icons.header.byRecordType[type]` > `icons.header.default`. */
+declare function pickHeaderIcon(icons: RecordsAdminIcons, recordType?: string): LucideIcon;
+
 /** Minimal SDK shape consumed by the shell. */
 type SmartLinksSDK = any;
 /** Slot context passed to renderCard / renderListRow. */
@@ -224,7 +280,10 @@ interface RecordsAdminShellProps<TData = unknown> {
     SL: SmartLinksSDK;
     appId: string;
     collectionId: string;
-    recordType: string;
+    /** Logical record type for this app. Optional — when omitted, records are
+     *  saved against the app id alone (no type qualifier). Set this only when an
+     *  app stores multiple distinct record types and needs to query by type. */
+    recordType?: string;
     label: string;
     scopes: ScopeKind[];
     defaultScope?: ScopeKind;
@@ -332,6 +391,45 @@ interface RecordsAdminShellProps<TData = unknown> {
      * timestamp+random string.
      */
     generateItemId?: () => string;
+    /** Display title shown in the header card. Falls back to `label`, then `recordType`. */
+    title?: string;
+    /** Single-line muted subtitle under the header title. */
+    subtitle?: string;
+    /** Icon shown in the header card. Falls back to `icons.header.byRecordType[recordType]`
+     *  or `icons.header.default`. Pass a Lucide icon component or any ReactNode. */
+    headerIcon?: ReactNode;
+    /** Right-aligned header content — typically a primary "+ New" button + secondary controls. */
+    headerActions?: ReactNode;
+    /** Show a counts strip in the header (e.g. Shared · Products). Off by default —
+     *  most apps don't need it. When `true`, the shell renders built-in counts unless
+     *  `statsItems` is also provided. */
+    showStats?: boolean;
+    /** Show the contextual icon to the left of the header title. Default true.
+     *  Set to `false` if the recordType icon (database, etc.) feels off-brand. */
+    showHeaderIcon?: boolean;
+    /** Fully custom stats strip content. When provided, replaces the built-in
+     *  Shared/Products counts. Each item renders as a value + uppercase label. */
+    statsItems?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    /** Override the default Lucide icons used by the shell (scope tabs, statuses,
+     *  empty states, action menus, etc.). Deep-merged onto `DEFAULT_ICONS`. */
+    icons?: Partial<RecordsAdminIcons>;
+    /** When supplied, the records list is rendered as accordion-style groups.
+     *  Return `null` to put a record in the default "Other" bucket. */
+    groupBy?: (record: RecordSummary) => {
+        key: string;
+        label: string;
+        icon?: ReactNode;
+    } | null;
+    /** Custom empty-state renderer for the records rail. Falls back to the styled
+     *  built-in empty state (icon + title + body + optional CTAs). */
+    renderEmptyState?: (ctx: {
+        scope: ScopeKind;
+    }) => ReactNode;
+    /** Visual density. Default `comfortable`. */
+    density?: 'comfortable' | 'compact';
     i18n?: Partial<RecordsAdminI18n>;
     onTelemetry?: (event: TelemetryEvent) => void;
     className?: string;
@@ -372,8 +470,12 @@ interface Props$9 {
     onChange: (s: ScopeKind) => void;
     /** When true, tabs render disabled (used while collection flags are loading). */
     loading?: boolean;
+    /** Optional per-scope counts displayed as tiny badges. */
+    counts?: Partial<Record<ScopeKind, number>>;
+    /** Override icons used per scope. Falls back to DEFAULT_ICONS.scope. */
+    icons?: RecordsAdminIcons['scope'];
 }
-declare const ScopeTabs: ({ scopes, active, onChange, loading }: Props$9) => react_jsx_runtime.JSX.Element;
+declare const ScopeTabs: ({ scopes, active, onChange, loading, counts, icons, }: Props$9) => react_jsx_runtime.JSX.Element;
 
 interface Props$8 {
     source?: RecordSource;
@@ -408,17 +510,23 @@ interface Props$6 {
     renderListRow?: (record: RecordSummary, ctx: RecordSlotContext) => ReactNode;
     /** Optional override for `grid` / `gallery` cards. */
     renderCard?: (record: RecordSummary, ctx: RecordSlotContext) => ReactNode;
+    /** Optional grouping function. Returning null buckets the row under "Other". */
+    groupBy?: (record: RecordSummary) => {
+        key: string;
+        label: string;
+        icon?: ReactNode;
+    } | null;
 }
-declare const RecordList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, }: Props$6) => react_jsx_runtime.JSX.Element;
-declare const ProductList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, }: Props$6) => react_jsx_runtime.JSX.Element;
-declare const FacetList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, }: Props$6) => react_jsx_runtime.JSX.Element;
-declare const VariantList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, }: Props$6) => react_jsx_runtime.JSX.Element;
-declare const BatchList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, }: Props$6) => react_jsx_runtime.JSX.Element;
+declare const RecordList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, groupBy, }: Props$6) => react_jsx_runtime.JSX.Element;
+declare const ProductList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, groupBy, }: Props$6) => react_jsx_runtime.JSX.Element;
+declare const FacetList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, groupBy, }: Props$6) => react_jsx_runtime.JSX.Element;
+declare const VariantList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, groupBy, }: Props$6) => react_jsx_runtime.JSX.Element;
+declare const BatchList: ({ items, selectedRef, onSelect, dirtyRef, presentation, renderListRow, renderCard, groupBy, }: Props$6) => react_jsx_runtime.JSX.Element;
 
 interface DefaultRecordRowProps {
     record: RecordSummary;
     ctx: RecordSlotContext;
-    /** Drop the status dot + subtitle (used by the `compact` preset). */
+    /** Drop the icon + subtitle (used by the `compact` preset). */
     compact?: boolean;
 }
 declare const DefaultRecordRow: ({ record, ctx, compact }: DefaultRecordRowProps) => react_jsx_runtime.JSX.Element;
@@ -439,11 +547,17 @@ interface PresentationSwitcherProps {
 }
 declare const PresentationSwitcher: ({ options, value, onChange, i18n }: PresentationSwitcherProps) => react_jsx_runtime.JSX.Element | null;
 
-declare const EmptyState: ({ title, body, action }: {
+interface EmptyStateProps {
     title: string;
     body?: ReactNode;
+    /** Primary call-to-action — typically "+ Add your first …". */
     action?: ReactNode;
-}) => react_jsx_runtime.JSX.Element;
+    /** Optional secondary action — typically "Import from CSV". */
+    secondaryAction?: ReactNode;
+    /** Lucide icon component. Defaults to `Inbox`. */
+    icon?: LucideIcon;
+}
+declare const EmptyState: ({ title, body, action, secondaryAction, icon: Icon, }: EmptyStateProps) => react_jsx_runtime.JSX.Element;
 declare const LoadingState: () => react_jsx_runtime.JSX.Element;
 declare const ErrorState: ({ error }: {
     error: Error;
@@ -599,26 +713,33 @@ declare const ScopeBreadcrumb: ({ scope }: {
     scope: ParsedRef;
 }) => react_jsx_runtime.JSX.Element | null;
 
+type IntroTone = 'info' | 'success' | 'warning';
 interface Props$1 {
     title: string;
     body: ReactNode;
     onDismiss: () => void;
+    /** Visual tone — controls icon and surface tint. */
+    tone?: IntroTone;
+    /** Optional "Learn more" link or button rendered inline after the body. */
+    action?: ReactNode;
 }
-declare const IntroCard: ({ title, body, onDismiss }: Props$1) => react_jsx_runtime.JSX.Element;
+declare const IntroCard: ({ title, body, onDismiss, tone, action }: Props$1) => react_jsx_runtime.JSX.Element;
 
 interface Props {
     label: string;
-    recordType: string;
     introHidden: boolean;
     onShowIntro?: () => void;
 }
-declare const UtilityRow: ({ label, recordType, introHidden, onShowIntro }: Props) => react_jsx_runtime.JSX.Element;
+declare const UtilityRow: ({ label, introHidden, onShowIntro }: Props) => react_jsx_runtime.JSX.Element | null;
 
 interface RecordsCtx {
     SL: SmartLinksSDK;
     collectionId: string;
     appId: string;
-    recordType: string;
+    /** Optional — when omitted, records are stored against the app id alone
+     *  (no type qualifier). Set this only when an app uses multiple record types
+     *  and needs to query/scope by type. */
+    recordType?: string;
 }
 /** Shape of a single record write — uses the SDK's structured `scope`. */
 interface RecordWrite<T = unknown> {
@@ -761,7 +882,8 @@ declare function useRecordEditor<T>(args: UseRecordEditorArgs<T>): EditorContext
 interface UseResolvedRecordArgs {
     SL: SmartLinksSDK;
     appId: string;
-    recordType: string;
+    /** Optional — see `RecordsAdminShellProps.recordType`. */
+    recordType?: string;
     collectionId: string;
     productId?: string;
     variantId?: string;
@@ -780,8 +902,76 @@ declare function useResolvedRecord<T = unknown>(args: UseResolvedRecordArgs): {
     source: RecordSource;
     sourceRef?: string;
     parentValue?: T | null | undefined;
+    matchedAt?: _proveanything_smartlinks_dist_types_appObjects.MatchedAt;
+    matchedRule?: _proveanything_smartlinks_dist_types_appObjects.FacetRule;
 };
 
+interface UseResolveAllRecordsArgs {
+    SL: SmartLinksSDK;
+    collectionId: string;
+    appId: string;
+    /** Limit to a single record type. Omit to return every type. */
+    recordType?: string;
+    /** Product context — at minimum a productId in most apps. */
+    context: {
+        productId?: string;
+        variantId?: string;
+        batchId?: string;
+        proofId?: string;
+        /**
+         * Facet assignments for the product. Used for both legacy facet refs
+         * and `facetRule` evaluation server-side.
+         * e.g. `{ brand: 'samsung', type: ['tv', 'laptop'] }`
+         */
+        facets?: Record<string, string | string[]>;
+    };
+    /** Restrict to specific tiers (e.g. only `['rule', 'product']`). */
+    tiers?: MatchedAt[];
+    /** Safety cap. Default 500, max 5000. */
+    limit?: number;
+    /** Point-in-time evaluation for scheduled records. ISO 8601. */
+    at?: string;
+    includeScheduled?: boolean;
+    includeExpired?: boolean;
+    /**
+     * `false` to use the public (visibility-filtered) endpoint.
+     * Defaults to `false` so this hook is safe to call from public surfaces.
+     */
+    admin?: boolean;
+    enabled?: boolean;
+    staleTime?: number;
+}
+interface UseResolveAllResult {
+    /** All matching records, sorted most-specific first. Each appears once. */
+    records: MatchEntry[];
+    /** True when the result hit the `limit` safety cap. */
+    truncated: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+declare function useResolveAllRecords(args: UseResolveAllRecordsArgs): UseResolveAllResult;
+
+interface UseRulePreviewArgs {
+    SL: SmartLinksSDK;
+    collectionId: string;
+    appId: string;
+    rule: FacetRule | null;
+    /** Sample size. Default 20, max 200. */
+    limit?: number;
+    /** Debounce window in ms while the admin types. Default 350ms. */
+    debounceMs?: number;
+    enabled?: boolean;
+}
+interface UseRulePreviewResult {
+    totalMatches: number | null;
+    sampleProductIds: string[];
+    isLoading: boolean;
+    isStale: boolean;
+    error: Error | null;
+}
+declare function useRulePreview(args: UseRulePreviewArgs): UseRulePreviewResult;
+
 interface UseScopeProbeArgs {
     SL: SmartLinksSDK;
     collectionId: string;
@@ -803,7 +993,7 @@ declare const useScopeProbe: ({ SL, collectionId, admin, enabled }: UseScopeProb
     error: Error | null;
 };
 
-declare const useIntroDismissed: (SL: SmartLinksSDK, collectionId: string, appId: string, recordType: string) => {
+declare const useIntroDismissed: (SL: SmartLinksSDK, collectionId: string, appId: string, recordType?: string) => {
     dismissed: boolean;
     dismiss: () => Promise<void>;
     undismiss: () => void;
@@ -864,7 +1054,7 @@ interface CollectedRecord<T = unknown> {
 interface UseCollectedRecordsArgs {
     SL: SmartLinksSDK;
     appId: string;
-    recordType: string;
+    recordType?: string;
     collectionId: string;
     productId?: string;
     variantId?: string;
@@ -905,7 +1095,7 @@ interface MergedRecord<T = unknown> {
 interface UseMergedRecordArgs<T> {
     SL: SmartLinksSDK;
     appId: string;
-    recordType: string;
+    recordType?: string;
     collectionId: string;
     productId?: string;
     variantId?: string;
@@ -1002,7 +1192,7 @@ declare const useDirtyNavigation: ({ strategy, isDirty, save, reset, confirm, i1
 
 declare function usePresentationPref(args: {
     appId: string;
-    recordType: string;
+    recordType?: string;
     options: RecordPresentation[];
     defaultValue: RecordPresentation;
 }): [RecordPresentation, (next: RecordPresentation) => void];
@@ -1080,4 +1270,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_PRESENTATIONS, BatchList, BulkActionsMenu, type CollectedRecord, type CollectedSort, type CsvSchema, type CsvSchemaColumn, DEFAULT_I18N, DefaultRecordCard, DefaultRecordRow, DeleteButton, type DirtyStrategy, DrawerPreview, type EditorContext, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, LoadingState, type MergeStrategy, type MergedRecord, type NavConfirmI18n, type ParsedRef, 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, RecordsAdminShell, type RecordsAdminShellProps, ResolvedPreview, type ResolvedRecord, ScopeBreadcrumb, type ScopeKind, ScopeTabs, SidePreview, type SmartLinksSDK, StatusDot, StatusFilterPills, TabbedPreview, type TelemetryEvent, UtilityRow, VariantList, buildRef, bulkDelete, bulkUpsert, deleteRecord, downloadBlob, exportCsv, getRecordByRef, importCsv, listRecords, matchRecords, parseRef, parsedRefToScope, parsedRefToTarget, resolutionChain, resolveRecord, restoreRecord, scopesEqual, upsertRecord, useCollectedRecords, useDirtyNavigation, useIntroDismissed, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordEditor, useRecordList, useResolvedRecord, useScopeProbe, useUnsavedGuard };
+export { ALL_PRESENTATIONS, BatchList, BulkActionsMenu, type CollectedRecord, type CollectedSort, type CsvSchema, type CsvSchemaColumn, DEFAULT_I18N, DEFAULT_ICONS, DefaultRecordCard, DefaultRecordRow, DeleteButton, type DirtyStrategy, DrawerPreview, type EditorContext, EmptyState, ErrorState, FacetList, InheritanceMarker, InheritanceProvider, InlinePreview, IntroCard, LoadingState, type MergeStrategy, type MergedRecord, type NavConfirmI18n, type ParsedRef, 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, ResolvedPreview, type ResolvedRecord, ScopeBreadcrumb, type ScopeKind, ScopeTabs, SidePreview, type SmartLinksSDK, StatusDot, StatusFilterPills, TabbedPreview, type TelemetryEvent, type UseResolveAllRecordsArgs, type UseResolveAllResult, type UseRulePreviewArgs, type UseRulePreviewResult, UtilityRow, VariantList, buildRef, bulkDelete, bulkUpsert, deleteRecord, downloadBlob, exportCsv, getRecordByRef, importCsv, listRecords, matchRecords, mergeIcons, parseRef, parsedRefToScope, parsedRefToTarget, pickHeaderIcon, resolutionChain, resolveRecord, restoreRecord, scopesEqual, upsertRecord, useCollectedRecords, useDirtyNavigation, useIntroDismissed, useMergedRecord, usePresentationPref, useProductBrowse, useProductChildren, useRecordEditor, useRecordList, useResolveAllRecords, useResolvedRecord, useRulePreview, useScopeProbe, useUnsavedGuard };