@levo-so/react 0.1.113 → 0.2.1

package/dist/audience/components/block.d.ts

@@ -1,8 +1,24 @@
 import { ILevoAudience } from '@levo-so/insights';
 import { default as React } from 'react';
-export declare const LevoAudienceBlock: React.FC<{
+/**
+ * Fires a one-time `block.view` audience event when the block scrolls into view.
+ *
+ * Renders nothing. Mount it inside a block wrapper and pass the DOM `id` of the
+ * element to observe; the event fires once per instance, the first time that
+ * element intersects the viewport. On a failed `track()` the observer stays
+ * connected, so re-entering the viewport is a natural retry.
+ *
+ * @example
+ * ```tsx
+ * <div id={block.id}>
+ *   <LevoInsightsBlock id={block.id} properties={{ resource: "block" }} />
+ *   {block.children}
+ * </div>
+ * ```
+ */
+export declare const LevoInsightsBlock: React.FC<{
     id: string;
     properties?: ILevoAudience.Properties;
 }>;
-export default LevoAudienceBlock;
+export default LevoInsightsBlock;
 //# sourceMappingURL=block.d.ts.map

package/dist/audience/components/block.js

@@ -17,7 +17,7 @@ var a = ({ id: a, properties: o = {} }) => {
 					identifier: a
 				}), l.current = !0, t.disconnect();
 			} catch (e) {
-				s?.error("[LevoAudienceBlock] track failed", { exception: n(e) });
+				s?.error("[LevoInsightsBlock] track failed", { exception: n(e) });
 			}
 		}, { threshold: 0 });
 		return t.observe(e), () => t.disconnect();

package/dist/audience/components/page.d.ts

@@ -6,8 +6,24 @@ declare global {
         levo_insights?: ILevoInsights;
     }
 }
-export declare const LevoAudiencePage: React.FC<{
+/**
+ * Initializes audience/page tracking for a rendered Levo page.
+ *
+ * Renders nothing. Mount once per page (typically at the page root). It exposes
+ * the client/insights runtimes on `window` and calls `insights.init()` so page
+ * views and the welcome event fire. `id` is optional because headless sites
+ * mount this without a page id and still need `init()` to run.
+ *
+ * @example
+ * ```tsx
+ * <>
+ *   <LevoInsightsPage id={page.id} />
+ *   {page.children}
+ * </>
+ * ```
+ */
+export declare const LevoInsightsPage: React.FC<{
     id?: string;
 }>;
-export default LevoAudiencePage;
+export default LevoInsightsPage;
 //# sourceMappingURL=page.d.ts.map

package/dist/audience/index.d.ts

@@ -1,4 +1,3 @@
-export { default as LevoInsightsBlock } from './components/block';
-export { default as LevoInsightsComponent } from './components/component';
-export { default as LevoInsightsPage } from './components/page';
+export { LevoInsightsBlock } from './components/block';
+export { LevoInsightsPage } from './components/page';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Sonner.d.ts

@@ -1,7 +1,10 @@
 import { ExternalToast, Toaster as Sonner, toast } from 'sonner';
 type ToasterProps = React.ComponentProps<typeof Sonner>;
+/** App-level toast host. Mount once near the root; styled to Levo's theme tokens. */
 export declare const Toaster: ({ ...props }: ToasterProps) => import("react/jsx-runtime").JSX.Element;
+/** Show an error toast (title + description) at bottom-right. */
 export declare const errorToast: (message: string, title?: string, options?: ExternalToast) => void;
+/** Show a success toast; dismisses a prior toast with the same id first. */
 export declare const successToast: (message: string | React.ReactNode, title?: string, options?: ExternalToast) => void;
 export { toast, type ExternalToast };
 //# sourceMappingURL=Sonner.d.ts.map

package/dist/components/index.d.ts

@@ -1,8 +1,2 @@
-export * from './button';
-export * from './Dialog';
-export * from './DialogWrapper';
 export * from './Sonner';
-export * from './Spinner';
-export * from './Tabs';
-export * from './Tooltip';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 export * from './audience';
 export * from './components';
-export * from './constants';
 export * from './membership';
 export * from './providers/LevoProvider';
 export * from './utils';

package/dist/index.js

@@ -1,24 +1,9 @@
 /* empty css                 */
-import { LevoProvider as e, useLevo as t, useLevoInsights as n } from "./providers/LevoProvider.js";
-import r from "./audience/components/block.js";
-import i from "./audience/components/component.js";
+import { LevoProvider as e, useLevo as t, useLevoClient as n, useLevoInsights as r } from "./providers/LevoProvider.js";
+import i from "./audience/components/block.js";
 import a from "./audience/components/page.js";
-import o from "./utils/cn.js";
-import { buttonVariants as s } from "./components/button/buttonVariants.js";
-import c from "./components/button/Button.js";
-import { Dialog as l, DialogClose as u, DialogContent as d, DialogDescription as f, DialogFooter as p, DialogHeader as m, DialogOverlay as h, DialogPortal as g, DialogTitle as _, DialogTrigger as v } from "./components/Dialog.js";
-import { DialogWrapper as y } from "./components/DialogWrapper.js";
-import { Toaster as b, errorToast as x, successToast as S, toast as C } from "./components/Sonner.js";
-import w from "./components/Spinner.js";
-import { Tabs as T, TabsContent as E, TabsList as D, TabsTrigger as O } from "./components/Tabs.js";
-import { SimpleTooltipWrapper as k, Tooltip as A, TooltipContent as j, TooltipPortal as M, TooltipProvider as N, TooltipTrigger as P } from "./components/Tooltip.js";
-import { allMediaFileExtensions as F, allMediaMimetypes as I, audioFileExtensions as L, audioMimetype as R, documentFileExtensions as z, documentMimetype as B, imageFileExtensions as V, imageMimetype as H, mediaExtensionsByKind as U, mediaMimetypeByKind as W, videoFileExtensions as G, videoMimetype as K } from "./constants/fileUploadPresets.js";
-import { useLevoOAuth as q } from "./membership/useLevoOAuth.js";
-import { LevoOAuth as J } from "./membership/index.js";
-import Y from "./utils/byteToSize.js";
-import { errorHandler as X } from "./utils/errorHandler.js";
-import { isDateObject as Z } from "./utils/isDateObject.js";
-import { isNullOrUndefined as Q } from "./utils/isNullOrUndefined.js";
-import { isObject as $, isObjectType as ee } from "./utils/isObject.js";
-import { isEmptyObject as te } from "./utils/isEmptyObject.js";
-export { c as Button, l as Dialog, u as DialogClose, d as DialogContent, f as DialogDescription, p as DialogFooter, m as DialogHeader, h as DialogOverlay, g as DialogPortal, _ as DialogTitle, v as DialogTrigger, y as DialogWrapper, r as LevoInsightsBlock, i as LevoInsightsComponent, a as LevoInsightsPage, J as LevoOAuth, e as LevoProvider, k as SimpleTooltipWrapper, w as Spinner, T as Tabs, E as TabsContent, D as TabsList, O as TabsTrigger, b as Toaster, A as Tooltip, j as TooltipContent, M as TooltipPortal, N as TooltipProvider, P as TooltipTrigger, F as allMediaFileExtensions, I as allMediaMimetypes, L as audioFileExtensions, R as audioMimetype, s as buttonVariants, Y as byteToSize, o as cn, z as documentFileExtensions, B as documentMimetype, X as errorHandler, x as errorToast, V as imageFileExtensions, H as imageMimetype, Z as isDateObject, te as isEmptyObject, Q as isNullOrUndefined, $ as isObject, ee as isObjectType, U as mediaExtensionsByKind, W as mediaMimetypeByKind, S as successToast, C as toast, t as useLevo, n as useLevoInsights, q as useLevoOAuth, G as videoFileExtensions, K as videoMimetype };
+import { Toaster as o, errorToast as s, successToast as c, toast as l } from "./components/Sonner.js";
+import { useLevoOAuth as u } from "./membership/useLevoOAuth.js";
+import { LevoOAuth as d } from "./membership/index.js";
+import { errorHandler as f } from "./utils/errorHandler.js";
+export { i as LevoInsightsBlock, a as LevoInsightsPage, d as LevoOAuth, e as LevoProvider, o as Toaster, f as errorHandler, s as errorToast, c as successToast, l as toast, t as useLevo, n as useLevoClient, r as useLevoInsights, u as useLevoOAuth };

package/dist/membership/components/Button.js

@@ -1,22 +1,21 @@
 "use client";
-import e from "../../components/Spinner.js";
-import { useLevoOAuth as t } from "./Container.js";
-import n from "./Core.js";
-import { jsx as r } from "react/jsx-runtime";
+import { useLevoOAuth as e } from "./Container.js";
+import t from "./Core.js";
+import { jsx as n } from "react/jsx-runtime";
 //#region src/membership/components/Button.tsx
-var i = ({ children: i, provider: a }) => {
-	let { title: o, urls: s, isLoading: c, onSuccess: l, onError: u } = t(), d = s?.[a];
-	return d ? /* @__PURE__ */ r(n, {
-		title: o,
-		provider: a,
-		url: d,
-		onSuccess: l,
-		onError: u,
-		children: c ? /* @__PURE__ */ r("div", {
+var r = ({ children: r, provider: i }) => {
+	let { title: a, urls: o, isLoading: s, onSuccess: c, onError: l } = e(), u = o?.[i];
+	return u ? /* @__PURE__ */ n(t, {
+		title: a,
+		provider: i,
+		url: u,
+		onSuccess: c,
+		onError: l,
+		children: s ? /* @__PURE__ */ n("div", {
 			className: "w-full items-center justify-center",
-			children: /* @__PURE__ */ r(e, { className: "h-5 w-5 bg-brand" })
-		}) : i
+			children: /* @__PURE__ */ n("span", { className: "inline-block h-5 w-5 animate-spin rounded-full border-2 border-current border-t-transparent" })
+		}) : r
 	}) : null;
 };
 //#endregion
-export { i as default };
+export { r as default };

package/dist/providers/LevoProvider.d.ts

@@ -8,6 +8,13 @@ interface ILevoProps {
 }
 export declare const LevoProvider: React.FC<ILevoProps>;
 export declare const useLevo: () => ILevoClient;
+/**
+ * Null-safe counterpart to `useLevo` — returns the client or `null` when no provider is
+ * mounted (or it's mounted without a client). Use where a missing client is a valid state
+ * that should degrade gracefully rather than throw (e.g. Studio v3 sites before their Levo
+ * env is injected).
+ */
+export declare const useLevoClient: () => ILevoClient | null;
 export declare const useLevoInsights: () => ILevoInsights | null;
 export {};
 //# sourceMappingURL=LevoProvider.d.ts.map

package/dist/providers/LevoProvider.js

@@ -15,6 +15,6 @@ var r = e({
 	let e = t(r);
 	if (!e.client) throw Error("useLevo must be used within a LevoProvider. Please ensure you have wrapped your component tree with LevoProvider.");
 	return e.client;
-}, o = () => t(r).insights;
+}, o = () => t(r).client, s = () => t(r).insights;
 //#endregion
-export { i as LevoProvider, a as useLevo, o as useLevoInsights };
+export { i as LevoProvider, a as useLevo, o as useLevoClient, s as useLevoInsights };