@lattice-php/lattice 0.2.0 → 0.4.0

package/dist/core/use-column-resizing.js

@@ -0,0 +1,228 @@
+import { buildColumnGridTemplate, defaultColumnWidthPx, maxColumnWidthPx, minColumnWidthPx } from "./column-sizing.js";
+import { useCallback, useMemo, useRef, useState } from "react";
+//#region resources/js/core/use-column-resizing.ts
+var emptyTracks = [];
+function useColumnResizing({ columnGapPx = 0, columns, enabled, leadingTracks = emptyTracks, showIndicator = false, storageKey, trailingTracks = emptyTracks }) {
+	const columnKeys = useMemo(() => columns.map((column) => column.key), [columns]);
+	const [overrides, setOverrides] = useState(() => readStoredOverrides(storageKey, columns));
+	const overridesRef = useRef(overrides);
+	const drag = useRef(null);
+	const gridTemplateColumns = useMemo(() => buildColumnGridTemplate({
+		columns,
+		leadingTracks,
+		trailingTracks,
+		overrides: enabled ? overrides : {}
+	}), [
+		columns,
+		enabled,
+		leadingTracks,
+		overrides,
+		trailingTracks
+	]);
+	const setColumnWidth = useCallback((column, width, maxWidth) => {
+		setOverrides((current) => {
+			const next = {
+				...current,
+				[column.key]: Math.min(maxWidth ?? maxColumnWidthPx(column), Math.max(minColumnWidthPx(column), width))
+			};
+			overridesRef.current = next;
+			writeStoredOverrides(storageKey, columnKeys, next);
+			return next;
+		});
+	}, [columnKeys, storageKey]);
+	const resetColumnWidth = useCallback((column) => {
+		setOverrides((current) => {
+			const next = { ...current };
+			delete next[column.key];
+			overridesRef.current = next;
+			writeStoredOverrides(storageKey, columnKeys, next);
+			return next;
+		});
+	}, [columnKeys, storageKey]);
+	const resetColumns = useCallback(() => {
+		setOverrides({});
+		overridesRef.current = {};
+		writeStoredOverrides(storageKey, columnKeys, {});
+	}, [columnKeys, storageKey]);
+	const hasOverrides = enabled && Object.values(overrides).some((width) => typeof width === "number");
+	const currentColumnWidth = useCallback((column) => overridesRef.current[column.key] ?? defaultColumnWidthPx(column), []);
+	return {
+		getResizeHandleProps: useCallback((column) => {
+			const max = maxColumnWidthPx(column);
+			const min = minColumnWidthPx(column);
+			const current = currentColumnWidth(column);
+			const label = column.label ?? column.key;
+			const indicatorClass = showIndicator ? "after:bg-lt-border" : "after:bg-transparent";
+			const maxWidthForHandle = (handle) => maxColumnWidthForGrid({
+				column,
+				columnGapPx,
+				columns,
+				grid: handle.parentElement?.parentElement,
+				leadingTracks,
+				trailingTracks
+			});
+			const resizeBy = (handle, delta) => setColumnWidth(column, current + delta, maxWidthForHandle(handle));
+			return {
+				"aria-label": `Resize ${label}`,
+				"aria-orientation": "vertical",
+				"aria-valuemax": max,
+				"aria-valuemin": min,
+				"aria-valuenow": current,
+				className: `absolute inset-y-0 right-0 hidden w-2 cursor-col-resize touch-none items-stretch justify-center md:flex after:my-1 after:w-px ${indicatorClass} hover:after:bg-lt-border focus-visible:outline-none focus-visible:after:bg-lt-ring`,
+				onDoubleClick: () => resetColumnWidth(column),
+				onKeyDown: (event) => {
+					if (!enabled) return;
+					const step = event.shiftKey ? 32 : 8;
+					if (event.key === "ArrowLeft") {
+						event.preventDefault();
+						resizeBy(event.currentTarget, -step);
+					}
+					if (event.key === "ArrowRight") {
+						event.preventDefault();
+						resizeBy(event.currentTarget, step);
+					}
+					if (event.key === "Home") {
+						event.preventDefault();
+						setColumnWidth(column, min);
+					}
+					if (event.key === "End") {
+						event.preventDefault();
+						const handleMax = maxWidthForHandle(event.currentTarget);
+						setColumnWidth(column, handleMax, handleMax);
+					}
+					if (event.key === "Enter" || event.key === "Escape") {
+						event.preventDefault();
+						resetColumnWidth(column);
+					}
+				},
+				onPointerDown: (event) => {
+					if (!enabled) return;
+					const parentWidth = event.currentTarget.parentElement?.getBoundingClientRect().width ?? 0;
+					drag.current = {
+						key: column.key,
+						maxWidth: maxWidthForHandle(event.currentTarget),
+						startWidth: parentWidth > 0 ? parentWidth : current,
+						startX: event.clientX
+					};
+					event.currentTarget.setPointerCapture?.(event.pointerId);
+					event.preventDefault();
+				},
+				onPointerMove: (event) => {
+					const active = drag.current;
+					if (!enabled || active?.key !== column.key) return;
+					setColumnWidth(column, active.startWidth + event.clientX - active.startX, active.maxWidth);
+				},
+				onPointerUp: (event) => {
+					if (drag.current?.key !== column.key) return;
+					drag.current = null;
+					event.currentTarget.releasePointerCapture?.(event.pointerId);
+				},
+				role: "separator",
+				tabIndex: 0
+			};
+		}, [
+			columnGapPx,
+			columns,
+			currentColumnWidth,
+			enabled,
+			leadingTracks,
+			resetColumnWidth,
+			setColumnWidth,
+			showIndicator,
+			trailingTracks
+		]),
+		gridTemplateColumns,
+		hasOverrides,
+		resetColumns,
+		resetColumnWidth
+	};
+}
+function maxColumnWidthForGrid({ column, columnGapPx, columns, grid, leadingTracks, trailingTracks }) {
+	const gridWidth = grid?.getBoundingClientRect().width ?? 0;
+	if (gridWidth <= 0) return maxColumnWidthPx(column);
+	const utilityWidth = [...leadingTracks, ...trailingTracks].reduce((sum, track) => sum + fixedTrackWidthPx(track), 0);
+	const siblingMinWidth = columns.reduce((sum, sibling) => sibling.key === column.key ? sum : sum + minColumnWidthPx(sibling), 0);
+	const trackCount = columns.length + leadingTracks.length + trailingTracks.length;
+	const gapWidth = Math.max(0, trackCount - 1) * columnGapPx;
+	const available = gridWidth - utilityWidth - siblingMinWidth - gapWidth;
+	return Math.min(maxColumnWidthPx(column), Math.max(minColumnWidthPx(column), available));
+}
+function readStoredOverrides(storageKey, columns) {
+	if (!storageKey || typeof window === "undefined") return {};
+	try {
+		const raw = window.localStorage.getItem(storageKey);
+		if (raw === null) return {};
+		const stored = JSON.parse(raw);
+		const columnKeys = columns.map((column) => column.key);
+		if (!isStoredColumnWidths(stored) || !sameColumnKeys(stored.columns, columnKeys)) {
+			removeStoredOverrides(storageKey);
+			return {};
+		}
+		const overrides = sanitizeOverrides(stored.overrides, columns);
+		if (Object.keys(overrides).length === 0) removeStoredOverrides(storageKey);
+		return overrides;
+	} catch {
+		removeStoredOverrides(storageKey);
+		return {};
+	}
+}
+function writeStoredOverrides(storageKey, columnKeys, overrides) {
+	if (!storageKey || typeof window === "undefined") return;
+	const stored = {};
+	const knownKeys = new Set(columnKeys);
+	for (const [key, value] of Object.entries(overrides)) if (knownKeys.has(key) && typeof value === "number" && Number.isFinite(value)) stored[key] = value;
+	if (Object.keys(stored).length === 0) {
+		removeStoredOverrides(storageKey);
+		return;
+	}
+	try {
+		window.localStorage.setItem(storageKey, JSON.stringify({
+			columns: columnKeys,
+			overrides: stored
+		}));
+	} catch {
+		return;
+	}
+}
+function removeStoredOverrides(storageKey) {
+	if (typeof window === "undefined") return;
+	try {
+		window.localStorage.removeItem(storageKey);
+	} catch {
+		return;
+	}
+}
+function isStoredColumnWidths(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const record = value;
+	return Array.isArray(record.columns) && record.columns.every((column) => typeof column === "string") && typeof record.overrides === "object" && record.overrides !== null && !Array.isArray(record.overrides);
+}
+function sameColumnKeys(stored, current) {
+	return stored.length === current.length && stored.every((key, index) => key === current[index]);
+}
+function sanitizeOverrides(overrides, columns) {
+	const next = {};
+	for (const column of columns) {
+		const value = overrides[column.key];
+		if (typeof value !== "number" || !Number.isFinite(value)) continue;
+		next[column.key] = Math.min(maxColumnWidthPx(column), Math.max(minColumnWidthPx(column), value));
+	}
+	return next;
+}
+function fixedTrackWidthPx(track) {
+	const value = track.trim();
+	const px = value.match(/^([0-9.]+)px$/);
+	if (px) return Number.parseFloat(px[1]);
+	const rem = value.match(/^([0-9.]+)rem$/);
+	if (rem) return Number.parseFloat(rem[1]) * rootFontSizePx();
+	return 0;
+}
+function rootFontSizePx() {
+	if (typeof window === "undefined") return 16;
+	const parsed = Number.parseFloat(window.getComputedStyle(document.documentElement).fontSize);
+	return Number.isFinite(parsed) && parsed > 0 ? parsed : 16;
+}
+//#endregion
+export { useColumnResizing };
+
+//# sourceMappingURL=use-column-resizing.js.map

package/dist/core/use-column-resizing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-column-resizing.js","names":[],"sources":["../../resources/js/core/use-column-resizing.ts"],"sourcesContent":["import type { HTMLAttributes, KeyboardEvent, PointerEvent } from \"react\";\nimport { useCallback, useMemo, useRef, useState } from \"react\";\nimport {\n  buildColumnGridTemplate,\n  defaultColumnWidthPx,\n  maxColumnWidthPx,\n  minColumnWidthPx,\n  type SizableColumn,\n} from \"./column-sizing\";\n\ntype DragState = {\n  key: string;\n  maxWidth: number;\n  startWidth: number;\n  startX: number;\n};\n\ntype ResizeHandleProps = HTMLAttributes<HTMLDivElement> & {\n  \"aria-label\": string;\n  \"aria-orientation\": \"vertical\";\n  \"aria-valuemax\": number;\n  \"aria-valuemin\": number;\n  \"aria-valuenow\": number;\n  role: \"separator\";\n  tabIndex: number;\n};\n\ntype StoredColumnWidths = {\n  columns: string[];\n  overrides: Record<string, number>;\n};\n\nconst emptyTracks: string[] = [];\n\nexport function useColumnResizing({\n  columnGapPx = 0,\n  columns,\n  enabled,\n  leadingTracks = emptyTracks,\n  showIndicator = false,\n  storageKey,\n  trailingTracks = emptyTracks,\n}: {\n  columnGapPx?: number;\n  columns: SizableColumn[];\n  enabled: boolean;\n  leadingTracks?: string[];\n  showIndicator?: boolean;\n  storageKey?: string;\n  trailingTracks?: string[];\n}) {\n  const columnKeys = useMemo(() => columns.map((column) => column.key), [columns]);\n  const [overrides, setOverrides] = useState<Record<string, number | undefined>>(() =>\n    readStoredOverrides(storageKey, columns),\n  );\n  const overridesRef = useRef(overrides);\n  const drag = useRef<DragState | null>(null);\n\n  const gridTemplateColumns = useMemo(\n    () =>\n      buildColumnGridTemplate({\n        columns,\n        leadingTracks,\n        trailingTracks,\n        overrides: enabled ? overrides : {},\n      }),\n    [columns, enabled, leadingTracks, overrides, trailingTracks],\n  );\n\n  const setColumnWidth = useCallback(\n    (column: SizableColumn, width: number, maxWidth?: number) => {\n      setOverrides((current) => {\n        const next = {\n          ...current,\n          [column.key]: Math.min(\n            maxWidth ?? maxColumnWidthPx(column),\n            Math.max(minColumnWidthPx(column), width),\n          ),\n        };\n\n        overridesRef.current = next;\n        writeStoredOverrides(storageKey, columnKeys, next);\n\n        return next;\n      });\n    },\n    [columnKeys, storageKey],\n  );\n\n  const resetColumnWidth = useCallback(\n    (column: SizableColumn) => {\n      setOverrides((current) => {\n        const next = { ...current };\n        delete next[column.key];\n\n        overridesRef.current = next;\n        writeStoredOverrides(storageKey, columnKeys, next);\n\n        return next;\n      });\n    },\n    [columnKeys, storageKey],\n  );\n\n  const resetColumns = useCallback(() => {\n    setOverrides({});\n    overridesRef.current = {};\n    writeStoredOverrides(storageKey, columnKeys, {});\n  }, [columnKeys, storageKey]);\n\n  const hasOverrides =\n    enabled && Object.values(overrides).some((width) => typeof width === \"number\");\n\n  const currentColumnWidth = useCallback(\n    (column: SizableColumn): number =>\n      overridesRef.current[column.key] ?? defaultColumnWidthPx(column),\n    [],\n  );\n\n  const getResizeHandleProps = useCallback(\n    (column: SizableColumn): ResizeHandleProps => {\n      const max = maxColumnWidthPx(column);\n      const min = minColumnWidthPx(column);\n      const current = currentColumnWidth(column);\n      const label = column.label ?? column.key;\n      const indicatorClass = showIndicator ? \"after:bg-lt-border\" : \"after:bg-transparent\";\n\n      const maxWidthForHandle = (handle: HTMLDivElement): number =>\n        maxColumnWidthForGrid({\n          column,\n          columnGapPx,\n          columns,\n          grid: handle.parentElement?.parentElement,\n          leadingTracks,\n          trailingTracks,\n        });\n\n      const resizeBy = (handle: HTMLDivElement, delta: number): void =>\n        setColumnWidth(column, current + delta, maxWidthForHandle(handle));\n\n      return {\n        \"aria-label\": `Resize ${label}`,\n        \"aria-orientation\": \"vertical\",\n        \"aria-valuemax\": max,\n        \"aria-valuemin\": min,\n        \"aria-valuenow\": current,\n        className: `absolute inset-y-0 right-0 hidden w-2 cursor-col-resize touch-none items-stretch justify-center md:flex after:my-1 after:w-px ${indicatorClass} hover:after:bg-lt-border focus-visible:outline-none focus-visible:after:bg-lt-ring`,\n        onDoubleClick: () => resetColumnWidth(column),\n        onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => {\n          if (!enabled) {\n            return;\n          }\n\n          const step = event.shiftKey ? 32 : 8;\n\n          if (event.key === \"ArrowLeft\") {\n            event.preventDefault();\n            resizeBy(event.currentTarget, -step);\n          }\n\n          if (event.key === \"ArrowRight\") {\n            event.preventDefault();\n            resizeBy(event.currentTarget, step);\n          }\n\n          if (event.key === \"Home\") {\n            event.preventDefault();\n            setColumnWidth(column, min);\n          }\n\n          if (event.key === \"End\") {\n            event.preventDefault();\n            const handleMax = maxWidthForHandle(event.currentTarget);\n            setColumnWidth(column, handleMax, handleMax);\n          }\n\n          if (event.key === \"Enter\" || event.key === \"Escape\") {\n            event.preventDefault();\n            resetColumnWidth(column);\n          }\n        },\n        onPointerDown: (event: PointerEvent<HTMLDivElement>) => {\n          if (!enabled) {\n            return;\n          }\n\n          const parentWidth = event.currentTarget.parentElement?.getBoundingClientRect().width ?? 0;\n          drag.current = {\n            key: column.key,\n            maxWidth: maxWidthForHandle(event.currentTarget),\n            startWidth: parentWidth > 0 ? parentWidth : current,\n            startX: event.clientX,\n          };\n          event.currentTarget.setPointerCapture?.(event.pointerId);\n          event.preventDefault();\n        },\n        onPointerMove: (event: PointerEvent<HTMLDivElement>) => {\n          const active = drag.current;\n\n          if (!enabled || active?.key !== column.key) {\n            return;\n          }\n\n          setColumnWidth(\n            column,\n            active.startWidth + event.clientX - active.startX,\n            active.maxWidth,\n          );\n        },\n        onPointerUp: (event: PointerEvent<HTMLDivElement>) => {\n          const active = drag.current;\n\n          if (active?.key !== column.key) {\n            return;\n          }\n\n          drag.current = null;\n          event.currentTarget.releasePointerCapture?.(event.pointerId);\n        },\n        role: \"separator\",\n        tabIndex: 0,\n      };\n    },\n    [\n      columnGapPx,\n      columns,\n      currentColumnWidth,\n      enabled,\n      leadingTracks,\n      resetColumnWidth,\n      setColumnWidth,\n      showIndicator,\n      trailingTracks,\n    ],\n  );\n\n  return {\n    getResizeHandleProps,\n    gridTemplateColumns,\n    hasOverrides,\n    resetColumns,\n    resetColumnWidth,\n  };\n}\n\nfunction maxColumnWidthForGrid({\n  column,\n  columnGapPx,\n  columns,\n  grid,\n  leadingTracks,\n  trailingTracks,\n}: {\n  column: SizableColumn;\n  columnGapPx: number;\n  columns: SizableColumn[];\n  grid: Element | null | undefined;\n  leadingTracks: string[];\n  trailingTracks: string[];\n}): number {\n  const gridWidth = grid?.getBoundingClientRect().width ?? 0;\n\n  if (gridWidth <= 0) {\n    return maxColumnWidthPx(column);\n  }\n\n  const utilityWidth = [...leadingTracks, ...trailingTracks].reduce(\n    (sum, track) => sum + fixedTrackWidthPx(track),\n    0,\n  );\n  const siblingMinWidth = columns.reduce(\n    (sum, sibling) => (sibling.key === column.key ? sum : sum + minColumnWidthPx(sibling)),\n    0,\n  );\n  const trackCount = columns.length + leadingTracks.length + trailingTracks.length;\n  const gapWidth = Math.max(0, trackCount - 1) * columnGapPx;\n  const available = gridWidth - utilityWidth - siblingMinWidth - gapWidth;\n\n  return Math.min(maxColumnWidthPx(column), Math.max(minColumnWidthPx(column), available));\n}\n\nfunction readStoredOverrides(\n  storageKey: string | undefined,\n  columns: SizableColumn[],\n): Record<string, number | undefined> {\n  if (!storageKey || typeof window === \"undefined\") {\n    return {};\n  }\n\n  try {\n    const raw = window.localStorage.getItem(storageKey);\n\n    if (raw === null) {\n      return {};\n    }\n\n    const stored = JSON.parse(raw) as unknown;\n    const columnKeys = columns.map((column) => column.key);\n\n    if (!isStoredColumnWidths(stored) || !sameColumnKeys(stored.columns, columnKeys)) {\n      removeStoredOverrides(storageKey);\n\n      return {};\n    }\n\n    const overrides = sanitizeOverrides(stored.overrides, columns);\n\n    if (Object.keys(overrides).length === 0) {\n      removeStoredOverrides(storageKey);\n    }\n\n    return overrides;\n  } catch {\n    removeStoredOverrides(storageKey);\n\n    return {};\n  }\n}\n\nfunction writeStoredOverrides(\n  storageKey: string | undefined,\n  columnKeys: string[],\n  overrides: Record<string, number | undefined>,\n): void {\n  if (!storageKey || typeof window === \"undefined\") {\n    return;\n  }\n\n  const stored: Record<string, number> = {};\n  const knownKeys = new Set(columnKeys);\n\n  for (const [key, value] of Object.entries(overrides)) {\n    if (knownKeys.has(key) && typeof value === \"number\" && Number.isFinite(value)) {\n      stored[key] = value;\n    }\n  }\n\n  if (Object.keys(stored).length === 0) {\n    removeStoredOverrides(storageKey);\n\n    return;\n  }\n\n  try {\n    window.localStorage.setItem(\n      storageKey,\n      JSON.stringify({\n        columns: columnKeys,\n        overrides: stored,\n      }),\n    );\n  } catch {\n    return;\n  }\n}\n\nfunction removeStoredOverrides(storageKey: string): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  try {\n    window.localStorage.removeItem(storageKey);\n  } catch {\n    return;\n  }\n}\n\nfunction isStoredColumnWidths(value: unknown): value is StoredColumnWidths {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const record = value as Record<string, unknown>;\n\n  return (\n    Array.isArray(record.columns) &&\n    record.columns.every((column) => typeof column === \"string\") &&\n    typeof record.overrides === \"object\" &&\n    record.overrides !== null &&\n    !Array.isArray(record.overrides)\n  );\n}\n\nfunction sameColumnKeys(stored: string[], current: string[]): boolean {\n  return stored.length === current.length && stored.every((key, index) => key === current[index]);\n}\n\nfunction sanitizeOverrides(\n  overrides: Record<string, unknown>,\n  columns: SizableColumn[],\n): Record<string, number | undefined> {\n  const next: Record<string, number | undefined> = {};\n\n  for (const column of columns) {\n    const value = overrides[column.key];\n\n    if (typeof value !== \"number\" || !Number.isFinite(value)) {\n      continue;\n    }\n\n    next[column.key] = Math.min(\n      maxColumnWidthPx(column),\n      Math.max(minColumnWidthPx(column), value),\n    );\n  }\n\n  return next;\n}\n\nfunction fixedTrackWidthPx(track: string): number {\n  const value = track.trim();\n  const px = value.match(/^([0-9.]+)px$/);\n\n  if (px) {\n    return Number.parseFloat(px[1]);\n  }\n\n  const rem = value.match(/^([0-9.]+)rem$/);\n\n  if (rem) {\n    return Number.parseFloat(rem[1]) * rootFontSizePx();\n  }\n\n  return 0;\n}\n\nfunction rootFontSizePx(): number {\n  if (typeof window === \"undefined\") {\n    return 16;\n  }\n\n  const parsed = Number.parseFloat(window.getComputedStyle(document.documentElement).fontSize);\n\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 16;\n}\n"],"mappings":"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"}

package/dist/effects/dispatch.d.ts

@@ -0,0 +1,20 @@
+import { ActionResult, Effect } from '../types/generated';
+import { EffectHandlerRegistry } from './registry';
+export type ActionEffect = Effect;
+/** The server's action response. Fields are optional: a handler may omit any of them. */
+export type ActionResponse = Partial<ActionResult>;
+/**
+ * Run each effect through its handler. Handlers default to the built-ins; the
+ * Provider passes a merged registry that also includes consumer-registered
+ * handlers. An effect with no handler is warned about (dev) and skipped.
+ */
+export declare function dispatchEffects(effects: ActionEffect[], handlers?: EffectHandlerRegistry): void;
+export declare function dispatchActionError(error: unknown): void;
+export declare function getActionEffects(effects: unknown): ActionEffect[];
+/**
+ * Structural guard for an effect on the wire. Intentionally open: it accepts any
+ * object with a string `type`, not only the built-in types, so consumer-registered
+ * effects pass through getActionEffects() and reach their handlers. Dispatch warns
+ * on (and skips) a type with no registered handler.
+ */
+export declare function isActionEffect(effect: unknown): effect is ActionEffect;

package/dist/effects/dispatch.js

@@ -0,0 +1,39 @@
+import { LATTICE_EVENT } from "../events/event-names.js";
+import { builtinEffectHandlers } from "./registry.js";
+//#region resources/js/effects/dispatch.ts
+/**
+* Run each effect through its handler. Handlers default to the built-ins; the
+* Provider passes a merged registry that also includes consumer-registered
+* handlers. An effect with no handler is warned about (dev) and skipped.
+*/
+function dispatchEffects(effects, handlers = builtinEffectHandlers) {
+	if (typeof window === "undefined") return;
+	for (const effect of effects) {
+		const handler = handlers[effect.type];
+		if (handler === void 0) {
+			console.warn(`[lattice] No handler registered for effect type "${effect.type}".`);
+			continue;
+		}
+		handler(effect);
+	}
+}
+function dispatchActionError(error) {
+	if (typeof window === "undefined") return;
+	window.dispatchEvent(new CustomEvent(LATTICE_EVENT.actionError, { detail: { error } }));
+}
+function getActionEffects(effects) {
+	return Array.isArray(effects) ? effects.filter(isActionEffect) : [];
+}
+/**
+* Structural guard for an effect on the wire. Intentionally open: it accepts any
+* object with a string `type`, not only the built-in types, so consumer-registered
+* effects pass through getActionEffects() and reach their handlers. Dispatch warns
+* on (and skips) a type with no registered handler.
+*/
+function isActionEffect(effect) {
+	return typeof effect === "object" && effect !== null && "type" in effect && typeof effect.type === "string";
+}
+//#endregion
+export { dispatchActionError, dispatchEffects, getActionEffects, isActionEffect };
+
+//# sourceMappingURL=dispatch.js.map

package/dist/effects/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","names":[],"sources":["../../resources/js/effects/dispatch.ts"],"sourcesContent":["import type { ActionResult, Effect } from \"@lattice-php/lattice/types/generated\";\nimport { LATTICE_EVENT } from \"@lattice-php/lattice/events/event-names\";\nimport { builtinEffectHandlers } from \"./registry\";\nimport type { EffectHandlerRegistry } from \"./registry\";\n\nexport type ActionEffect = Effect;\n\n/** The server's action response. Fields are optional: a handler may omit any of them. */\nexport type ActionResponse = Partial<ActionResult>;\n\n/**\n * Run each effect through its handler. Handlers default to the built-ins; the\n * Provider passes a merged registry that also includes consumer-registered\n * handlers. An effect with no handler is warned about (dev) and skipped.\n */\nexport function dispatchEffects(\n  effects: ActionEffect[],\n  handlers: EffectHandlerRegistry = builtinEffectHandlers,\n): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  for (const effect of effects) {\n    const handler = handlers[effect.type];\n\n    if (handler === undefined) {\n      console.warn(`[lattice] No handler registered for effect type \"${effect.type}\".`);\n      continue;\n    }\n\n    handler(effect);\n  }\n}\n\nexport function dispatchActionError(error: unknown): void {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  window.dispatchEvent(new CustomEvent(LATTICE_EVENT.actionError, { detail: { error } }));\n}\n\nexport function getActionEffects(effects: unknown): ActionEffect[] {\n  return Array.isArray(effects) ? effects.filter(isActionEffect) : [];\n}\n\n/**\n * Structural guard for an effect on the wire. Intentionally open: it accepts any\n * object with a string `type`, not only the built-in types, so consumer-registered\n * effects pass through getActionEffects() and reach their handlers. Dispatch warns\n * on (and skips) a type with no registered handler.\n */\nexport function isActionEffect(effect: unknown): effect is ActionEffect {\n  return (\n    typeof effect === \"object\" &&\n    effect !== null &&\n    \"type\" in effect &&\n    typeof (effect as { type: unknown }).type === \"string\"\n  );\n}\n"],"mappings":";;;;;;;;AAeA,SAAgB,gBACd,SACA,WAAkC,uBAC5B;CACN,IAAI,OAAO,WAAW,aACpB;CAGF,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,UAAU,SAAS,OAAO;EAEhC,IAAI,YAAY,KAAA,GAAW;GACzB,QAAQ,KAAK,oDAAoD,OAAO,KAAK,GAAG;GAChF;EACF;EAEA,QAAQ,MAAM;CAChB;AACF;AAEA,SAAgB,oBAAoB,OAAsB;CACxD,IAAI,OAAO,WAAW,aACpB;CAGF,OAAO,cAAc,IAAI,YAAY,cAAc,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACxF;AAEA,SAAgB,iBAAiB,SAAkC;CACjE,OAAO,MAAM,QAAQ,OAAO,IAAI,QAAQ,OAAO,cAAc,IAAI,CAAC;AACpE;;;;;;;AAQA,SAAgB,eAAe,QAAyC;CACtE,OACE,OAAO,WAAW,YAClB,WAAW,QACX,UAAU,UACV,OAAQ,OAA6B,SAAS;AAElD"}

package/dist/effects/registry.d.ts

@@ -0,0 +1,38 @@
+import { ResolveProps } from '../core/types';
+import { Effect } from '../types/generated';
+/**
+ * Augmentable map of effect `type` → payload (the effect's fields minus `type`).
+ * Consumer apps extend it via `declare module "@lattice-php/lattice"` so their
+ * custom effects type their handler's payload; built-ins resolve through the
+ * generated `Effect` union.
+ */
+export interface EffectProps {
+}
+type EffectPayloads = {
+    [TEffect in Effect as TEffect["type"]]: Omit<TEffect, "type">;
+};
+type EffectPayloadOf<TType extends string> = ResolveProps<EffectProps, EffectPayloads, TType, Record<string, unknown>>;
+/**
+ * Resolves an effect `type` to its full shape — `{ type, ...payload }` — the way
+ * `Node<T>` pairs a type with its props, so built-ins and consumer effects alike
+ * always carry `type`. An unknown type falls back to the loose `Effect` union.
+ */
+export type EffectOf<TType extends string> = string extends TType ? Effect : {
+    type: TType;
+} & EffectPayloadOf<TType>;
+export type EffectHandler<TType extends string = string> = (effect: EffectOf<TType>) => void;
+export type EffectHandlerRegistry = Record<string, EffectHandler>;
+/**
+ * Registers a typed effect handler, erasing the type parameter for the registry.
+ * Mirrors `eagerComponent`/`columnCell`: author against `EffectHandler<"my.type">`
+ * for a typed payload, register through this.
+ */
+export declare function effectHandler<TType extends string>(_type: TType, fn: EffectHandler<TType>): EffectHandler;
+/**
+ * Built-in effect handlers. Imperative effects act directly; the rest bridge to
+ * the `lattice:*` DOM events that toast/callout/modal/fragment/form subscribe to
+ * — preserving today's behavior exactly.
+ */
+export declare const builtinEffectHandlers: EffectHandlerRegistry;
+export declare function mergeEffectHandlers(...registries: Array<EffectHandlerRegistry | undefined>): EffectHandlerRegistry;
+export {};

package/dist/effects/registry.js

@@ -0,0 +1,51 @@
+import { LATTICE_EVENT } from "../events/event-names.js";
+import { setLocale } from "../i18n/locale.js";
+import { router } from "@inertiajs/react";
+//#region resources/js/effects/registry.ts
+/**
+* Registers a typed effect handler, erasing the type parameter for the registry.
+* Mirrors `eagerComponent`/`columnCell`: author against `EffectHandler<"my.type">`
+* for a typed payload, register through this.
+*/
+function effectHandler(_type, fn) {
+	return fn;
+}
+function triggerDownload(url) {
+	const link = document.createElement("a");
+	link.href = url;
+	link.rel = "noopener";
+	document.body.appendChild(link);
+	link.click();
+	link.remove();
+}
+/** Re-broadcast an effect as its `lattice:*` DOM event for feature components. */
+function bridge(event) {
+	return (effect) => window.dispatchEvent(new CustomEvent(event, { detail: effect }));
+}
+/**
+* Built-in effect handlers. Imperative effects act directly; the rest bridge to
+* the `lattice:*` DOM events that toast/callout/modal/fragment/form subscribe to
+* — preserving today's behavior exactly.
+*/
+var builtinEffectHandlers = {
+	reloadPage: () => router.reload(),
+	redirect: effectHandler("redirect", (effect) => router.visit(effect.url)),
+	download: effectHandler("download", (effect) => triggerDownload(effect.url)),
+	localeChange: effectHandler("localeChange", (effect) => setLocale(effect.locale)),
+	toast: bridge(LATTICE_EVENT.toast),
+	callout: bridge(LATTICE_EVENT.callout),
+	reloadComponent: bridge(LATTICE_EVENT.reloadComponent),
+	openModal: bridge(LATTICE_EVENT.openModal),
+	closeModal: bridge(LATTICE_EVENT.closeModal),
+	resetForm: bridge(LATTICE_EVENT.resetForm)
+};
+function mergeEffectHandlers(...registries) {
+	return registries.reduce((merged, registry) => ({
+		...merged,
+		...registry
+	}), {});
+}
+//#endregion
+export { builtinEffectHandlers, effectHandler, mergeEffectHandlers };
+
+//# sourceMappingURL=registry.js.map

package/dist/effects/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../resources/js/effects/registry.ts"],"sourcesContent":["import { router } from \"@inertiajs/react\";\nimport type { ResolveProps } from \"@lattice-php/lattice/core/types\";\nimport type { Effect } from \"@lattice-php/lattice/types/generated\";\nimport { LATTICE_EVENT } from \"@lattice-php/lattice/events/event-names\";\nimport { setLocale } from \"@lattice-php/lattice/i18n/locale\";\n\n/**\n * Augmentable map of effect `type` → payload (the effect's fields minus `type`).\n * Consumer apps extend it via `declare module \"@lattice-php/lattice\"` so their\n * custom effects type their handler's payload; built-ins resolve through the\n * generated `Effect` union.\n */\nexport interface EffectProps {}\n\n// The generated built-in effect payloads, keyed by `type` (the discriminant stripped).\ntype EffectPayloads = { [TEffect in Effect as TEffect[\"type\"]]: Omit<TEffect, \"type\"> };\n\ntype EffectPayloadOf<TType extends string> = ResolveProps<\n  EffectProps,\n  EffectPayloads,\n  TType,\n  Record<string, unknown>\n>;\n\n/**\n * Resolves an effect `type` to its full shape — `{ type, ...payload }` — the way\n * `Node<T>` pairs a type with its props, so built-ins and consumer effects alike\n * always carry `type`. An unknown type falls back to the loose `Effect` union.\n */\nexport type EffectOf<TType extends string> = string extends TType\n  ? Effect\n  : { type: TType } & EffectPayloadOf<TType>;\n\nexport type EffectHandler<TType extends string = string> = (effect: EffectOf<TType>) => void;\n\nexport type EffectHandlerRegistry = Record<string, EffectHandler>;\n\n/**\n * Registers a typed effect handler, erasing the type parameter for the registry.\n * Mirrors `eagerComponent`/`columnCell`: author against `EffectHandler<\"my.type\">`\n * for a typed payload, register through this.\n */\nexport function effectHandler<TType extends string>(\n  _type: TType,\n  fn: EffectHandler<TType>,\n): EffectHandler {\n  return fn as unknown as EffectHandler;\n}\n\nfunction triggerDownload(url: string): void {\n  const link = document.createElement(\"a\");\n  link.href = url;\n  link.rel = \"noopener\";\n  document.body.appendChild(link);\n  link.click();\n  link.remove();\n}\n\n/** Re-broadcast an effect as its `lattice:*` DOM event for feature components. */\nfunction bridge(event: string): EffectHandler {\n  return (effect) => window.dispatchEvent(new CustomEvent(event, { detail: effect }));\n}\n\n/**\n * Built-in effect handlers. Imperative effects act directly; the rest bridge to\n * the `lattice:*` DOM events that toast/callout/modal/fragment/form subscribe to\n * — preserving today's behavior exactly.\n */\nexport const builtinEffectHandlers: EffectHandlerRegistry = {\n  reloadPage: () => router.reload(),\n  redirect: effectHandler(\"redirect\", (effect) => router.visit(effect.url)),\n  download: effectHandler(\"download\", (effect) => triggerDownload(effect.url)),\n  localeChange: effectHandler(\"localeChange\", (effect) => setLocale(effect.locale)),\n  toast: bridge(LATTICE_EVENT.toast),\n  callout: bridge(LATTICE_EVENT.callout),\n  reloadComponent: bridge(LATTICE_EVENT.reloadComponent),\n  openModal: bridge(LATTICE_EVENT.openModal),\n  closeModal: bridge(LATTICE_EVENT.closeModal),\n  resetForm: bridge(LATTICE_EVENT.resetForm),\n};\n\nexport function mergeEffectHandlers(\n  ...registries: Array<EffectHandlerRegistry | undefined>\n): EffectHandlerRegistry {\n  return registries.reduce<EffectHandlerRegistry>(\n    (merged, registry) => ({ ...merged, ...registry }),\n    {},\n  );\n}\n"],"mappings":";;;;;;;;;AA0CA,SAAgB,cACd,OACA,IACe;CACf,OAAO;AACT;AAEA,SAAS,gBAAgB,KAAmB;CAC1C,MAAM,OAAO,SAAS,cAAc,GAAG;CACvC,KAAK,OAAO;CACZ,KAAK,MAAM;CACX,SAAS,KAAK,YAAY,IAAI;CAC9B,KAAK,MAAM;CACX,KAAK,OAAO;AACd;;AAGA,SAAS,OAAO,OAA8B;CAC5C,QAAQ,WAAW,OAAO,cAAc,IAAI,YAAY,OAAO,EAAE,QAAQ,OAAO,CAAC,CAAC;AACpF;;;;;;AAOA,IAAa,wBAA+C;CAC1D,kBAAkB,OAAO,OAAO;CAChC,UAAU,cAAc,aAAa,WAAW,OAAO,MAAM,OAAO,GAAG,CAAC;CACxE,UAAU,cAAc,aAAa,WAAW,gBAAgB,OAAO,GAAG,CAAC;CAC3E,cAAc,cAAc,iBAAiB,WAAW,UAAU,OAAO,MAAM,CAAC;CAChF,OAAO,OAAO,cAAc,KAAK;CACjC,SAAS,OAAO,cAAc,OAAO;CACrC,iBAAiB,OAAO,cAAc,eAAe;CACrD,WAAW,OAAO,cAAc,SAAS;CACzC,YAAY,OAAO,cAAc,UAAU;CAC3C,WAAW,OAAO,cAAc,SAAS;AAC3C;AAEA,SAAgB,oBACd,GAAG,YACoB;CACvB,OAAO,WAAW,QACf,QAAQ,cAAc;EAAE,GAAG;EAAQ,GAAG;CAAS,IAChD,CAAC,CACH;AACF"}

package/dist/effects/use-effect-dispatcher.d.ts

@@ -0,0 +1,8 @@
+import { ActionEffect } from './dispatch';
+/**
+ * Returns a dispatcher bound to the built-in handlers plus any consumer handlers
+ * in the current registry. The built-ins are merged in directly so they fire even
+ * with no <Provider> in scope (effects are infrastructural) — this is the single
+ * place built-ins enter dispatch.
+ */
+export declare function useEffectDispatcher(): (effects: ActionEffect[]) => void;

package/dist/effects/use-effect-dispatcher.js

@@ -0,0 +1,20 @@
+import { builtinEffectHandlers, mergeEffectHandlers } from "./registry.js";
+import { dispatchEffects } from "./dispatch.js";
+import { useEffectHandlerRegistry } from "../core/registry-context.js";
+import { useCallback, useMemo } from "react";
+//#region resources/js/effects/use-effect-dispatcher.ts
+/**
+* Returns a dispatcher bound to the built-in handlers plus any consumer handlers
+* in the current registry. The built-ins are merged in directly so they fire even
+* with no <Provider> in scope (effects are infrastructural) — this is the single
+* place built-ins enter dispatch.
+*/
+function useEffectDispatcher() {
+	const registered = useEffectHandlerRegistry();
+	const handlers = useMemo(() => mergeEffectHandlers(builtinEffectHandlers, registered), [registered]);
+	return useCallback((effects) => dispatchEffects(effects, handlers), [handlers]);
+}
+//#endregion
+export { useEffectDispatcher };
+
+//# sourceMappingURL=use-effect-dispatcher.js.map

package/dist/effects/use-effect-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-effect-dispatcher.js","names":[],"sources":["../../resources/js/effects/use-effect-dispatcher.ts"],"sourcesContent":["import { useCallback, useMemo } from \"react\";\nimport { useEffectHandlerRegistry } from \"@lattice-php/lattice/core/registry-context\";\nimport { dispatchEffects } from \"./dispatch\";\nimport type { ActionEffect } from \"./dispatch\";\nimport { builtinEffectHandlers, mergeEffectHandlers } from \"./registry\";\n\n/**\n * Returns a dispatcher bound to the built-in handlers plus any consumer handlers\n * in the current registry. The built-ins are merged in directly so they fire even\n * with no <Provider> in scope (effects are infrastructural) — this is the single\n * place built-ins enter dispatch.\n */\nexport function useEffectDispatcher(): (effects: ActionEffect[]) => void {\n  const registered = useEffectHandlerRegistry();\n\n  const handlers = useMemo(\n    () => mergeEffectHandlers(builtinEffectHandlers, registered),\n    [registered],\n  );\n\n  return useCallback((effects: ActionEffect[]) => dispatchEffects(effects, handlers), [handlers]);\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,sBAAyD;CACvE,MAAM,aAAa,yBAAyB;CAE5C,MAAM,WAAW,cACT,oBAAoB,uBAAuB,UAAU,GAC3D,CAAC,UAAU,CACb;CAEA,OAAO,aAAa,YAA4B,gBAAgB,SAAS,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAChG"}

package/dist/effects/use-flash-effects.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Drains the `latticeEffects` flash bag (server `Effects::flash(...)`) on each
+ * Inertia navigation and runs the effects through the registry dispatcher.
+ */
+export declare function useFlashEffects(): void;

package/dist/effects/use-flash-effects.js

@@ -0,0 +1,22 @@
+import { getActionEffects } from "./dispatch.js";
+import { useEffectDispatcher } from "./use-effect-dispatcher.js";
+import { useEffect } from "react";
+import { router } from "@inertiajs/react";
+//#region resources/js/effects/use-flash-effects.ts
+/**
+* Drains the `latticeEffects` flash bag (server `Effects::flash(...)`) on each
+* Inertia navigation and runs the effects through the registry dispatcher.
+*/
+function useFlashEffects() {
+	const dispatch = useEffectDispatcher();
+	useEffect(() => {
+		return router.on("flash", (event) => {
+			const effects = getActionEffects(event.detail?.flash?.latticeEffects);
+			if (effects.length > 0) dispatch(effects);
+		});
+	}, [dispatch]);
+}
+//#endregion
+export { useFlashEffects };
+
+//# sourceMappingURL=use-flash-effects.js.map

package/dist/effects/use-flash-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-flash-effects.js","names":[],"sources":["../../resources/js/effects/use-flash-effects.ts"],"sourcesContent":["import { router } from \"@inertiajs/react\";\nimport { useEffect } from \"react\";\nimport { getActionEffects } from \"@lattice-php/lattice/effects/dispatch\";\nimport { useEffectDispatcher } from \"@lattice-php/lattice/effects/use-effect-dispatcher\";\n\ntype InertiaFlashEvent = CustomEvent<{\n  flash?: {\n    latticeEffects?: unknown;\n  };\n}>;\n\n/**\n * Drains the `latticeEffects` flash bag (server `Effects::flash(...)`) on each\n * Inertia navigation and runs the effects through the registry dispatcher.\n */\nexport function useFlashEffects(): void {\n  const dispatch = useEffectDispatcher();\n\n  useEffect(() => {\n    return router.on(\"flash\", (event) => {\n      const effects = getActionEffects((event as InertiaFlashEvent).detail?.flash?.latticeEffects);\n\n      if (effects.length > 0) {\n        dispatch(effects);\n      }\n    });\n  }, [dispatch]);\n}\n"],"mappings":";;;;;;;;;AAeA,SAAgB,kBAAwB;CACtC,MAAM,WAAW,oBAAoB;CAErC,gBAAgB;EACd,OAAO,OAAO,GAAG,UAAU,UAAU;GACnC,MAAM,UAAU,iBAAkB,MAA4B,QAAQ,OAAO,cAAc;GAE3F,IAAI,QAAQ,SAAS,GACnB,SAAS,OAAO;EAEpB,CAAC;CACH,GAAG,CAAC,QAAQ,CAAC;AACf"}

package/dist/events/event-bridge.d.ts

@@ -1,14 +1,10 @@
-export declare const toastVariants: readonly ["success", "info", "warning", "error"];
+import { ToastMessage } from '../toast/toast';
 export declare const appearances: readonly ["light", "dark", "system"];
-export type ToastVariant = (typeof toastVariants)[number];
 export type Appearance = (typeof appearances)[number];
-export type ToastMessage = {
-    message: string;
-    variant: ToastVariant;
-};
 type EventBridgeProps = {
     onAppearanceChange?: (appearance: Appearance) => void;
+    onLocaleChange?: (locale: string) => void;
     onToast?: (toast: ToastMessage) => void;
 };
-export declare function EventBridge({ onAppearanceChange, onToast }: EventBridgeProps): null;
+export declare function EventBridge({ onAppearanceChange, onLocaleChange, onToast }: EventBridgeProps): null;
 export {};

package/dist/events/event-bridge.js

@@ -1,61 +1,20 @@
 import { LATTICE_EVENT } from "./event-names.js";
+import { onToast } from "../toast/toast.js";
 import { useEffect } from "react";
-import { router } from "@inertiajs/react";
 //#region resources/js/events/event-bridge.tsx
-var toastVariants = [
-	"success",
-	"info",
-	"warning",
-	"error"
-];
 var appearances = [
 	"light",
 	"dark",
 	"system"
 ];
-function isToastVariant(value) {
-	return toastVariants.some((variant) => variant === value);
-}
 function isAppearance(value) {
 	return appearances.some((appearance) => appearance === value);
 }
-function normalizeFlashToast(value) {
-	if (typeof value !== "object" || value === null) return null;
-	const candidate = value;
-	if (typeof candidate.message !== "string" || !isToastVariant(candidate.variant)) return null;
-	return {
-		message: candidate.message,
-		variant: candidate.variant
-	};
-}
-function normalizeLatticeToast(event) {
-	const detail = event.detail;
-	const message = detail?.message;
-	if (typeof message !== "string" || message === "") return null;
-	return {
-		message,
-		variant: isToastVariant(detail.variant) ? detail.variant : "success"
-	};
-}
-function EventBridge({ onAppearanceChange, onToast }) {
+function EventBridge({ onAppearanceChange, onLocaleChange, onToast: onToast$1 }) {
 	useEffect(() => {
-		if (!onToast) return;
-		return router.on("flash", (event) => {
-			const toast = normalizeFlashToast(event.detail?.flash?.toast);
-			if (toast) onToast(toast);
-		});
-	}, [onToast]);
-	useEffect(() => {
-		if (!onToast) return;
-		const listener = (event) => {
-			const toast = normalizeLatticeToast(event);
-			if (toast) onToast(toast);
-		};
-		window.addEventListener(LATTICE_EVENT.toast, listener);
-		return () => {
-			window.removeEventListener(LATTICE_EVENT.toast, listener);
-		};
-	}, [onToast]);
+		if (!onToast$1) return;
+		return onToast(onToast$1);
+	}, [onToast$1]);
 	useEffect(() => {
 		if (!onAppearanceChange) return;
 		const listener = (event) => {
@@ -67,9 +26,20 @@ function EventBridge({ onAppearanceChange, onToast }) {
 			window.removeEventListener(LATTICE_EVENT.appearanceChange, listener);
 		};
 	}, [onAppearanceChange]);
+	useEffect(() => {
+		if (!onLocaleChange) return;
+		const listener = (event) => {
+			const locale = event.detail?.locale;
+			if (typeof locale === "string" && locale !== "") onLocaleChange(locale);
+		};
+		window.addEventListener(LATTICE_EVENT.localeChange, listener);
+		return () => {
+			window.removeEventListener(LATTICE_EVENT.localeChange, listener);
+		};
+	}, [onLocaleChange]);
 	return null;
 }
 //#endregion
-export { EventBridge, appearances, toastVariants };
+export { EventBridge, appearances };
 
 //# sourceMappingURL=event-bridge.js.map

package/dist/events/event-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-bridge.js","names":[],"sources":["../../resources/js/events/event-bridge.tsx"],"sourcesContent":["import { router } from \"@inertiajs/react\";\nimport { useEffect } from \"react\";\nimport { LATTICE_EVENT } from \"./event-names\";\n\nexport const toastVariants = [\"success\", \"info\", \"warning\", \"error\"] as const;\nexport const appearances = [\"light\", \"dark\", \"system\"] as const;\n\nexport type ToastVariant = (typeof toastVariants)[number];\nexport type Appearance = (typeof appearances)[number];\n\nexport type ToastMessage = {\n  message: string;\n  variant: ToastVariant;\n};\n\ntype EventBridgeProps = {\n  onAppearanceChange?: (appearance: Appearance) => void;\n  onToast?: (toast: ToastMessage) => void;\n};\n\ntype ToastEvent = CustomEvent<{\n  message?: unknown;\n  variant?: unknown;\n}>;\n\ntype AppearanceEvent = CustomEvent<{\n  value?: unknown;\n}>;\n\ntype InertiaFlashEvent = CustomEvent<{\n  flash?: {\n    toast?: unknown;\n  };\n}>;\n\nfunction isToastVariant(value: unknown): value is ToastVariant {\n  return toastVariants.some((variant) => variant === value);\n}\n\nfunction isAppearance(value: unknown): value is Appearance {\n  return appearances.some((appearance) => appearance === value);\n}\n\nfunction normalizeFlashToast(value: unknown): ToastMessage | null {\n  if (typeof value !== \"object\" || value === null) {\n    return null;\n  }\n\n  const candidate = value as Partial<ToastMessage>;\n\n  if (typeof candidate.message !== \"string\" || !isToastVariant(candidate.variant)) {\n    return null;\n  }\n\n  return {\n    message: candidate.message,\n    variant: candidate.variant,\n  };\n}\n\nfunction normalizeLatticeToast(event: Event): ToastMessage | null {\n  const detail = (event as ToastEvent).detail;\n  const message = detail?.message;\n\n  if (typeof message !== \"string\" || message === \"\") {\n    return null;\n  }\n\n  return {\n    message,\n    variant: isToastVariant(detail.variant) ? detail.variant : \"success\",\n  };\n}\n\nexport function EventBridge({ onAppearanceChange, onToast }: EventBridgeProps) {\n  useEffect(() => {\n    if (!onToast) {\n      return;\n    }\n\n    return router.on(\"flash\", (event) => {\n      const toast = normalizeFlashToast((event as InertiaFlashEvent).detail?.flash?.toast);\n\n      if (toast) {\n        onToast(toast);\n      }\n    });\n  }, [onToast]);\n\n  useEffect(() => {\n    if (!onToast) {\n      return;\n    }\n\n    const listener = (event: Event): void => {\n      const toast = normalizeLatticeToast(event);\n\n      if (toast) {\n        onToast(toast);\n      }\n    };\n\n    window.addEventListener(LATTICE_EVENT.toast, listener);\n\n    return () => {\n      window.removeEventListener(LATTICE_EVENT.toast, listener);\n    };\n  }, [onToast]);\n\n  useEffect(() => {\n    if (!onAppearanceChange) {\n      return;\n    }\n\n    const listener = (event: Event): void => {\n      const value = (event as AppearanceEvent).detail?.value;\n\n      if (isAppearance(value)) {\n        onAppearanceChange(value);\n      }\n    };\n\n    window.addEventListener(LATTICE_EVENT.appearanceChange, listener);\n\n    return () => {\n      window.removeEventListener(LATTICE_EVENT.appearanceChange, listener);\n    };\n  }, [onAppearanceChange]);\n\n  return null;\n}\n"],"mappings":";;;;AAIA,IAAa,gBAAgB;CAAC;CAAW;CAAQ;CAAW;AAAO;AACnE,IAAa,cAAc;CAAC;CAAS;CAAQ;AAAQ;AA8BrD,SAAS,eAAe,OAAuC;CAC7D,OAAO,cAAc,MAAM,YAAY,YAAY,KAAK;AAC1D;AAEA,SAAS,aAAa,OAAqC;CACzD,OAAO,YAAY,MAAM,eAAe,eAAe,KAAK;AAC9D;AAEA,SAAS,oBAAoB,OAAqC;CAChE,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,OAAO;CAGT,MAAM,YAAY;CAElB,IAAI,OAAO,UAAU,YAAY,YAAY,CAAC,eAAe,UAAU,OAAO,GAC5E,OAAO;CAGT,OAAO;EACL,SAAS,UAAU;EACnB,SAAS,UAAU;CACrB;AACF;AAEA,SAAS,sBAAsB,OAAmC;CAChE,MAAM,SAAU,MAAqB;CACrC,MAAM,UAAU,QAAQ;CAExB,IAAI,OAAO,YAAY,YAAY,YAAY,IAC7C,OAAO;CAGT,OAAO;EACL;EACA,SAAS,eAAe,OAAO,OAAO,IAAI,OAAO,UAAU;CAC7D;AACF;AAEA,SAAgB,YAAY,EAAE,oBAAoB,WAA6B;CAC7E,gBAAgB;EACd,IAAI,CAAC,SACH;EAGF,OAAO,OAAO,GAAG,UAAU,UAAU;GACnC,MAAM,QAAQ,oBAAqB,MAA4B,QAAQ,OAAO,KAAK;GAEnF,IAAI,OACF,QAAQ,KAAK;EAEjB,CAAC;CACH,GAAG,CAAC,OAAO,CAAC;CAEZ,gBAAgB;EACd,IAAI,CAAC,SACH;EAGF,MAAM,YAAY,UAAuB;GACvC,MAAM,QAAQ,sBAAsB,KAAK;GAEzC,IAAI,OACF,QAAQ,KAAK;EAEjB;EAEA,OAAO,iBAAiB,cAAc,OAAO,QAAQ;EAErD,aAAa;GACX,OAAO,oBAAoB,cAAc,OAAO,QAAQ;EAC1D;CACF,GAAG,CAAC,OAAO,CAAC;CAEZ,gBAAgB;EACd,IAAI,CAAC,oBACH;EAGF,MAAM,YAAY,UAAuB;GACvC,MAAM,QAAS,MAA0B,QAAQ;GAEjD,IAAI,aAAa,KAAK,GACpB,mBAAmB,KAAK;EAE5B;EAEA,OAAO,iBAAiB,cAAc,kBAAkB,QAAQ;EAEhE,aAAa;GACX,OAAO,oBAAoB,cAAc,kBAAkB,QAAQ;EACrE;CACF,GAAG,CAAC,kBAAkB,CAAC;CAEvB,OAAO;AACT"}
+{"version":3,"file":"event-bridge.js","names":[],"sources":["../../resources/js/events/event-bridge.tsx"],"sourcesContent":["import { useEffect } from \"react\";\nimport { onToast as subscribeToToasts } from \"@lattice-php/lattice/toast/toast\";\nimport type { ToastMessage } from \"@lattice-php/lattice/toast/toast\";\nimport { LATTICE_EVENT } from \"./event-names\";\n\nexport const appearances = [\"light\", \"dark\", \"system\"] as const;\n\nexport type Appearance = (typeof appearances)[number];\n\ntype EventBridgeProps = {\n  onAppearanceChange?: (appearance: Appearance) => void;\n  onLocaleChange?: (locale: string) => void;\n  onToast?: (toast: ToastMessage) => void;\n};\n\ntype AppearanceEvent = CustomEvent<{\n  value?: unknown;\n}>;\n\ntype LocaleEvent = CustomEvent<{\n  locale?: unknown;\n}>;\n\nfunction isAppearance(value: unknown): value is Appearance {\n  return appearances.some((appearance) => appearance === value);\n}\n\nexport function EventBridge({ onAppearanceChange, onLocaleChange, onToast }: EventBridgeProps) {\n  useEffect(() => {\n    if (!onToast) {\n      return;\n    }\n\n    return subscribeToToasts(onToast);\n  }, [onToast]);\n\n  useEffect(() => {\n    if (!onAppearanceChange) {\n      return;\n    }\n\n    const listener = (event: Event): void => {\n      const value = (event as AppearanceEvent).detail?.value;\n\n      if (isAppearance(value)) {\n        onAppearanceChange(value);\n      }\n    };\n\n    window.addEventListener(LATTICE_EVENT.appearanceChange, listener);\n\n    return () => {\n      window.removeEventListener(LATTICE_EVENT.appearanceChange, listener);\n    };\n  }, [onAppearanceChange]);\n\n  useEffect(() => {\n    if (!onLocaleChange) {\n      return;\n    }\n\n    const listener = (event: Event): void => {\n      const locale = (event as LocaleEvent).detail?.locale;\n\n      if (typeof locale === \"string\" && locale !== \"\") {\n        onLocaleChange(locale);\n      }\n    };\n\n    window.addEventListener(LATTICE_EVENT.localeChange, listener);\n\n    return () => {\n      window.removeEventListener(LATTICE_EVENT.localeChange, listener);\n    };\n  }, [onLocaleChange]);\n\n  return null;\n}\n"],"mappings":";;;;AAKA,IAAa,cAAc;CAAC;CAAS;CAAQ;AAAQ;AAkBrD,SAAS,aAAa,OAAqC;CACzD,OAAO,YAAY,MAAM,eAAe,eAAe,KAAK;AAC9D;AAEA,SAAgB,YAAY,EAAE,oBAAoB,gBAAgB,SAAA,aAA6B;CAC7F,gBAAgB;EACd,IAAI,CAAC,WACH;EAGF,OAAO,QAAkB,SAAO;CAClC,GAAG,CAAC,SAAO,CAAC;CAEZ,gBAAgB;EACd,IAAI,CAAC,oBACH;EAGF,MAAM,YAAY,UAAuB;GACvC,MAAM,QAAS,MAA0B,QAAQ;GAEjD,IAAI,aAAa,KAAK,GACpB,mBAAmB,KAAK;EAE5B;EAEA,OAAO,iBAAiB,cAAc,kBAAkB,QAAQ;EAEhE,aAAa;GACX,OAAO,oBAAoB,cAAc,kBAAkB,QAAQ;EACrE;CACF,GAAG,CAAC,kBAAkB,CAAC;CAEvB,gBAAgB;EACd,IAAI,CAAC,gBACH;EAGF,MAAM,YAAY,UAAuB;GACvC,MAAM,SAAU,MAAsB,QAAQ;GAE9C,IAAI,OAAO,WAAW,YAAY,WAAW,IAC3C,eAAe,MAAM;EAEzB;EAEA,OAAO,iBAAiB,cAAc,cAAc,QAAQ;EAE5D,aAAa;GACX,OAAO,oBAAoB,cAAc,cAAc,QAAQ;EACjE;CACF,GAAG,CAAC,cAAc,CAAC;CAEnB,OAAO;AACT"}