@proveanything/smartlinks-utils-ui 0.10.7 → 0.10.8

package/dist/index.d.ts

@@ -1,14 +1,72 @@
-export { A as ASSET_MIME_FILTERS, a as AssetItem, b as AssetMimeFilter, 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';
+export { g as ASSET_MIME_FILTERS, A as AssetItem, h as AssetMimeFilter, a as AssetPicker, b as AssetPickerMode, c as AssetPickerProps, d as AssetPickerSelection, e as AssetScope, f as AssetViewMode, u as useAssets } from './useAssets-BAtXv6D5.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
 export { ConditionsEditor } from './components/ConditionsEditor/index.js';
 export { C as Condition, a as ConditionGroup, b as ConditionType, c as ConditionTypeMeta, d as ConditionsEditorProps, S as SelectOption, V as VersionOption } from './types-a2DdgZ2H.js';
 export { FacetRuleEditor, FacetRuleEditorProps } from './components/FacetRuleEditor/index.js';
-export { I as IconPicker, a as IconPickerProps, b as IconSelection } from './IconPicker-BMMQLR5I.js';
+export { b as IconPicker, c as IconPickerProps, d as IconSelection } from './IconPicker-DKpL5Hcc.js';
 export { CATEGORY_FALLBACKS, CATEGORY_LABELS, FontCategory, FontEntry, FontPicker, FontPickerProps, FontScope, FontSelection, FontSource, FontWeight, GOOGLE_FONTS_CATALOG, getGoogleFontUrl } from './components/FontPicker/index.js';
 import { ClassValue } from 'clsx';
 export { FacetRule, FacetRuleClause } from '@proveanything/smartlinks/dist/types/appObjects';
-import 'react';
+
+type AdminPageHeaderIntroTone = 'info' | 'success' | 'warning';
+interface AdminPageHeaderIntro {
+    /** Short headline shown in bold at the start of the intro card. */
+    title: string;
+    /** Body content — plain text or rich nodes. */
+    body: ReactNode;
+    /** Visual tone — controls icon and surface tint. Default `'info'`. */
+    tone?: AdminPageHeaderIntroTone;
+    /** Optional action node rendered inline after the body (e.g. a Learn-more link). */
+    action?: ReactNode;
+    /** Whether the intro is currently dismissed. Controlled. */
+    dismissed: boolean;
+    /** Called when the user clicks the dismiss `X`. */
+    onDismiss: () => void;
+    /**
+     * Called when the user clicks the reopen `?` button (only rendered when
+     * dismissed is true). Omit to hide the reopen affordance entirely.
+     */
+    onReopen?: () => void;
+    /** Tooltip / aria-label for the reopen button. Default "How it works". */
+    reopenLabel?: string;
+}
+interface AdminPageHeaderProps {
+    /** Page title — required. */
+    title: string;
+    /** Single-line muted subtitle under the title. */
+    subtitle?: string;
+    /** Icon rendered inline before the title. Pass a Lucide element or any node. */
+    icon?: ReactNode;
+    /**
+     * External help / documentation URL. When set, renders a small icon-button
+     * that opens the URL in a new tab. Use this to point at app-specific docs.
+     */
+    helpUrl?: string;
+    /** Tooltip / aria-label for the help link. Default "Help & documentation". */
+    helpLabel?: string;
+    /**
+     * Right-aligned action slot — typically a primary "+ New" button and/or
+     * secondary controls. Rendered before the help / intro-reopen icon-buttons.
+     */
+    actions?: ReactNode;
+    /**
+     * Extra header content rendered between `actions` and the trailing
+     * help / reopen icon-buttons. Used by RecordsAdminShell for its stats strip;
+     * standalone apps rarely need it.
+     */
+    aside?: ReactNode;
+    /**
+     * Optional dismissible intro card rendered below the header row.
+     * See {@link AdminPageHeaderIntro}.
+     */
+    intro?: AdminPageHeaderIntro;
+    /** Extra class on the root container for layout overrides. */
+    className?: string;
+}
+declare function AdminPageHeader({ title, subtitle, icon, helpUrl, helpLabel, actions, aside, intro, className, }: AdminPageHeaderProps): react_jsx_runtime.JSX.Element;
 
 /** Merge Tailwind classes with clsx — same pattern as shadcn/ui */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { cn };
+export { AdminPageHeader, type AdminPageHeaderIntro, type AdminPageHeaderIntroTone, type AdminPageHeaderProps, cn };

package/dist/index.js

@@ -2,6 +2,7 @@ export { ASSET_MIME_FILTERS, AssetPicker, useAssets } from './chunk-2IQEDRSZ.js'
 export { ConditionsEditor } from './chunk-7UBXTFZQ.js';
 export { IconPicker } from './chunk-JQPS5XPJ.js';
 export { CATEGORY_FALLBACKS, CATEGORY_LABELS, FontPicker, GOOGLE_FONTS_CATALOG, getGoogleFontUrl } from './chunk-OTJV62XV.js';
+export { AdminPageHeader } from './chunk-2MW54ZVG.js';
 import { assertStylesLoaded } from './chunk-OLYC54YT.js';
 import './chunk-5UQQYXCX.js';
 import './chunk-S27GIYV7.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAOA,kBAAA,EAAmB","file":"index.js","sourcesContent":["// =============================================================================\r\n// @proveanything/smartlinks-ui\r\n// =============================================================================\r\n\r\n// Pre-compiled Tailwind utilities — tsup processes this through PostCSS\r\nimport './styles.css';\r\nimport { assertStylesLoaded } from './utils/assertStylesLoaded';\r\nassertStylesLoaded();\r\n\r\n// --- Asset Picker ---\r\nexport { AssetPicker, useAssets } from './components/AssetPicker';\r\nexport type {\r\n  AssetPickerProps,\r\n  AssetPickerMode,\r\n  AssetScope,\r\n  AssetPickerSelection,\r\n  AssetItem,\r\n  AssetViewMode,\r\n  AssetMimeFilter,\r\n} from './components/AssetPicker/types';\r\nexport { ASSET_MIME_FILTERS } from './components/AssetPicker/types';\r\n\r\n// --- Conditions Editor ---\r\nexport { ConditionsEditor } from './components/ConditionsEditor';\r\nexport type {\r\n  ConditionsEditorProps,\r\n  Condition,\r\n  ConditionGroup,\r\n  ConditionType,\r\n  ConditionTypeMeta,\r\n  SelectOption,\r\n  VersionOption,\r\n} from './components/ConditionsEditor/types';\r\n\r\n// --- Facet Rule Editor (records targeting) ---\r\nexport { FacetRuleEditor } from './components/FacetRuleEditor';\r\nexport type {\r\n  FacetRuleEditorProps,\r\n  FacetRule,\r\n  FacetRuleClause,\r\n} from './components/FacetRuleEditor/types';\r\n\r\n// --- Icon Picker ---\r\nexport { IconPicker } from './components/IconPicker';\r\nexport type {\r\n  IconPickerProps,\r\n  IconSelection,\r\n} from './components/IconPicker/types';\r\n\r\n// --- Font Picker ---\r\nexport { FontPicker } from './components/FontPicker';\r\nexport type {\r\n  FontPickerProps,\r\n  FontSelection,\r\n  FontSource,\r\n  FontCategory,\r\n  FontWeight,\r\n  FontEntry,\r\n  FontScope,\r\n} from './components/FontPicker/types';\r\nexport { GOOGLE_FONTS_CATALOG, getGoogleFontUrl, CATEGORY_LABELS, CATEGORY_FALLBACKS } from './components/FontPicker/google-fonts';\r\n\r\n// --- Shared utilities ---\r\nexport { cn } from './utils/cn';\r\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAOA,kBAAA,EAAmB","file":"index.js","sourcesContent":["// =============================================================================\r\n// @proveanything/smartlinks-ui\r\n// =============================================================================\r\n\r\n// Pre-compiled Tailwind utilities — tsup processes this through PostCSS\r\nimport './styles.css';\r\nimport { assertStylesLoaded } from './utils/assertStylesLoaded';\r\nassertStylesLoaded();\r\n\r\n// --- Asset Picker ---\r\nexport { AssetPicker, useAssets } from './components/AssetPicker';\r\nexport type {\r\n  AssetPickerProps,\r\n  AssetPickerMode,\r\n  AssetScope,\r\n  AssetPickerSelection,\r\n  AssetItem,\r\n  AssetViewMode,\r\n  AssetMimeFilter,\r\n} from './components/AssetPicker/types';\r\nexport { ASSET_MIME_FILTERS } from './components/AssetPicker/types';\r\n\r\n// --- Admin Page Header ---\r\nexport { AdminPageHeader } from './components/AdminPageHeader';\r\nexport type {\r\n  AdminPageHeaderProps,\r\n  AdminPageHeaderIntro,\r\n  AdminPageHeaderIntroTone,\r\n} from './components/AdminPageHeader';\r\n\r\n// --- Conditions Editor ---\r\nexport { ConditionsEditor } from './components/ConditionsEditor';\r\nexport type {\r\n  ConditionsEditorProps,\r\n  Condition,\r\n  ConditionGroup,\r\n  ConditionType,\r\n  ConditionTypeMeta,\r\n  SelectOption,\r\n  VersionOption,\r\n} from './components/ConditionsEditor/types';\r\n\r\n// --- Facet Rule Editor (records targeting) ---\r\nexport { FacetRuleEditor } from './components/FacetRuleEditor';\r\nexport type {\r\n  FacetRuleEditorProps,\r\n  FacetRule,\r\n  FacetRuleClause,\r\n} from './components/FacetRuleEditor/types';\r\n\r\n// --- Icon Picker ---\r\nexport { IconPicker } from './components/IconPicker';\r\nexport type {\r\n  IconPickerProps,\r\n  IconSelection,\r\n} from './components/IconPicker/types';\r\n\r\n// --- Font Picker ---\r\nexport { FontPicker } from './components/FontPicker';\r\nexport type {\r\n  FontPickerProps,\r\n  FontSelection,\r\n  FontSource,\r\n  FontCategory,\r\n  FontWeight,\r\n  FontEntry,\r\n  FontScope,\r\n} from './components/FontPicker/types';\r\nexport { GOOGLE_FONTS_CATALOG, getGoogleFontUrl, CATEGORY_LABELS, CATEGORY_FALLBACKS } from './components/FontPicker/google-fonts';\r\n\r\n// --- Shared utilities ---\r\nexport { cn } from './utils/cn';\r\n"]}

package/dist/{useAssets-BM1bzzkq.d.ts → useAssets-BAtXv6D5.d.ts}

@@ -202,4 +202,4 @@ interface UseAssetsReturn {
 }
 declare function useAssets({ scope, accept, pageSize, appId, listAppId }: UseAssetsOptions): UseAssetsReturn;
 
-export { ASSET_MIME_FILTERS as A, type AssetItem as a, type AssetMimeFilter as b, AssetPicker as c, type AssetPickerMode as d, type AssetPickerProps as e, type AssetPickerSelection as f, type AssetScope as g, type AssetViewMode as h, useAssets as u };
+export { type AssetItem as A, AssetPicker as a, type AssetPickerMode as b, type AssetPickerProps as c, type AssetPickerSelection as d, type AssetScope as e, type AssetViewMode as f, ASSET_MIME_FILTERS as g, type AssetMimeFilter as h, useAssets as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks-utils-ui",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "description": "Reusable React components for SmartLinks microapps — Asset Picker, Conditions Editor, Icon Picker, and more.",
   "type": "module",
   "main": "dist/index.js",