@proveanything/smartlinks-utils-ui 0.9.2 → 0.9.4

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

@@ -493,7 +493,17 @@ interface DeepLinkAdapter {
     subscribe(listener: () => void): () => void;
 }
 interface DeepLinkOptions {
-    /** Master switch — default `false` (opt in per app). */
+    /**
+     * Master switch. **Default `true` as of v0.10.** Most hosts want URL
+     * round-tripping (refresh / share-link restores the open record), so the
+     * shell installs a default adapter automatically — `window.location` +
+     * `window.history` for standalone hosts, or a postMessage relay when
+     * mounted inside a SmartLinks iframe.
+     *
+     * Set to `false` to run an isolated shell whose state never touches the
+     * URL. Useful for embedded previews, modal pickers, or hosts that own
+     * a more opinionated URL scheme they don't want the shell to touch.
+     */
     enabled?: boolean;
     /** Push/replace strategy. Default `'smart'`. */
     history?: DeepLinkHistoryMode;
@@ -1376,13 +1386,19 @@ interface PreviewScopePickerProps {
     /** Are variants/batches available for drill-down. */
     showVariants: boolean;
     showBatches: boolean;
+    /** Active rail tab. The picker hides itself on product/variant/batch
+     *  tabs because the editing scope already pins a product there. */
+    activeScope?: ScopeKind;
     /** i18n strings (uses defaults if omitted). */
     i18n?: {
         previewAs?: string;
         previewAsDefault?: string;
+        change?: string;
+        searchProducts?: string;
+        close?: string;
     };
 }
-declare const PreviewScopePicker: ({ SL, collectionId, editingScope, value, onChange, showVariants, showBatches, i18n, }: PreviewScopePickerProps) => react_jsx_runtime.JSX.Element | null;
+declare const PreviewScopePicker: ({ SL, collectionId, editingScope, value, onChange, showVariants, showBatches, activeScope, i18n, }: PreviewScopePickerProps) => react_jsx_runtime.JSX.Element | null;
 
 declare const ScopeBreadcrumb: ({ scope }: {
     scope: ParsedRef;
@@ -2401,11 +2417,24 @@ declare const normaliseRule: (rule: FacetRule | null | undefined) => NormalisedR
  * `null` so the caller can route them to a separate "no rule" bucket.
  */
 declare const ruleHash: (rule: FacetRule | null | undefined) => string | null;
+/**
+ * Optional label lookup — turn raw facet/value KEYS (e.g. `cooking_guide`,
+ * `over-cook`) into the human-readable LABELS the host already shows
+ * elsewhere (e.g. "Cooking Guide", "Over-cook"). Pass via `summariseRule`
+ * so rail headers, right-pane summaries and chips never expose raw keys
+ * when a friendly name is available.
+ */
+interface RuleLabelLookup {
+    facetLabel?: (facetKey: string) => string | undefined;
+    valueLabel?: (facetKey: string, valueKey: string) => string | undefined;
+}
 /**
  * Human-readable single-line summary of a rule, used for group headers.
- * Compact ("country=DE,FR · tier=premium") so it fits a rail-width header.
+ * Compact ("Country: Germany, France · Tier: Premium") so it fits a
+ * rail-width header. Falls back to raw keys when no lookup is supplied
+ * or the lookup returns undefined for a given key.
  */
-declare const summariseRule: (rule: FacetRule | null | undefined) => string;
+declare const summariseRule: (rule: FacetRule | null | undefined, lookup?: RuleLabelLookup) => string;
 /** Comparator: are two rules semantically identical? */
 declare const rulesEqual: (a: FacetRule | null | undefined, b: FacetRule | null | undefined) => boolean;