@lattice-php/lattice 0.1.0 → 0.3.0

package/dist/core/test-id.js

@@ -0,0 +1,21 @@
+//#region resources/js/core/test-id.ts
+function testIdentity(value) {
+	return value === void 0 || value === null || value === "" ? void 0 : value;
+}
+function nodeIdentity(node) {
+	return testIdentity(node.key) ?? testIdentity(node.id);
+}
+function leafTestIdentity(value) {
+	return testIdentity(value)?.split(".").at(-1);
+}
+function prefixedTestId(prefix, value) {
+	const identity = leafTestIdentity(value);
+	return identity ? `${prefix}-${identity}` : void 0;
+}
+function prefixedNodeTestId(prefix, node) {
+	return prefixedTestId(prefix, nodeIdentity(node));
+}
+//#endregion
+export { leafTestIdentity, nodeIdentity, prefixedNodeTestId, prefixedTestId, testIdentity };
+
+//# sourceMappingURL=test-id.js.map

package/dist/core/test-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-id.js","names":[],"sources":["../../resources/js/core/test-id.ts"],"sourcesContent":["import type { Node } from \"./types\";\n\ntype IdentifiedNode = Pick<Node, \"id\" | \"key\">;\n\nexport function testIdentity(value: string | null | undefined): string | undefined {\n  return value === undefined || value === null || value === \"\" ? undefined : value;\n}\n\nexport function nodeIdentity(node: IdentifiedNode): string | undefined {\n  return testIdentity(node.key) ?? testIdentity(node.id);\n}\n\nexport function leafTestIdentity(value: string | null | undefined): string | undefined {\n  return testIdentity(value)?.split(\".\").at(-1);\n}\n\nexport function prefixedTestId(\n  prefix: string,\n  value: string | null | undefined,\n): string | undefined {\n  const identity = leafTestIdentity(value);\n\n  return identity ? `${prefix}-${identity}` : undefined;\n}\n\nexport function prefixedNodeTestId(prefix: string, node: IdentifiedNode): string | undefined {\n  return prefixedTestId(prefix, nodeIdentity(node));\n}\n"],"mappings":";AAIA,SAAgB,aAAa,OAAsD;CACjF,OAAO,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU,KAAK,KAAA,IAAY;AAC7E;AAEA,SAAgB,aAAa,MAA0C;CACrE,OAAO,aAAa,KAAK,GAAG,KAAK,aAAa,KAAK,EAAE;AACvD;AAEA,SAAgB,iBAAiB,OAAsD;CACrF,OAAO,aAAa,KAAK,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE;AAC9C;AAEA,SAAgB,eACd,QACA,OACoB;CACpB,MAAM,WAAW,iBAAiB,KAAK;CAEvC,OAAO,WAAW,GAAG,OAAO,GAAG,aAAa,KAAA;AAC9C;AAEA,SAAgB,mBAAmB,QAAgB,MAA0C;CAC3F,OAAO,eAAe,QAAQ,aAAa,IAAI,CAAC;AAClD"}

package/dist/core/types.d.ts

@@ -1,46 +1,88 @@
-import { Method } from '@inertiajs/core';
 import { ComponentType as ReactComponentType, ReactNode } from 'react';
+import { Node as WireNode, NodeType, Option, PageContainer as KnownPageContainer } from '../types/generated';
+export type { KnownPageContainer, NodeType, WireNode };
+/** Loose props bag for nodes whose `type` is not a generated built-in. */
 export type NodeProps = Record<string, unknown>;
+export type CommonNodeProps = {
+    hideWhenCollapsed?: boolean | null;
+};
+/** A `{ label, value }` pair used by the choice, select and segmented controls. */
+export type { Option };
+/**
+ * A node whose `type` is not one of the generated built-ins. This is the escape
+ * hatch that keeps the renderer open to components registered by consumers.
+ */
+export type LooseNode<TType extends string = string> = {
+    id?: string;
+    key?: string;
+    props?: NodeProps;
+    schema?: Schema;
+    type: TType;
+};
+/**
+ * Augmentable map of wire `type` string → props. Consumer apps extend it via
+ * `declare module "@lattice-php/lattice"` so their custom components gain strong
+ * prop types; the entries are generated by `php artisan lattice:typescript`.
+ * Built-in components resolve through the generated `WireNode` union below, so
+ * this interface starts empty. Types listed in neither fall back to a loose bag.
+ */
 export interface ComponentProps {
-    [component: string]: NodeProps;
 }
-export type ComponentType = keyof ComponentProps & string;
-export type PropsFor<TType extends string> = TType extends ComponentType ? ComponentProps[TType] & NodeProps : NodeProps;
-export type Node<TType extends string = string> = {
-    children?: Node[];
+/**
+ * Resolves a registry `type` string to its payload: consumer augmentations
+ * (`TAugment`) first, then generated built-ins (`TBuiltins`), then a loose
+ * fallback. Shared by the component, column, chat-part and effect type maps so
+ * every extensible kind resolves the same way.
+ */
+export type ResolveProps<TAugment, TBuiltins, TType extends string, TFallback> = TType extends keyof TAugment ? TAugment[TType] : TType extends keyof TBuiltins ? TBuiltins[TType] : TFallback;
+type WireNodeProps = {
+    [TNode in WireNode as TNode["type"]]: TNode extends {
+        props: infer TProps;
+    } ? TProps : never;
+};
+/**
+ * Resolves a wire `type` to its props: consumer augmentations
+ * (`ComponentProps`) first, then generated built-ins, then a loose bag.
+ */
+export type PropsOf<TType extends string> = ResolveProps<ComponentProps, WireNodeProps, TType, NodeProps> & CommonNodeProps;
+/**
+ * Resolves a wire `type` string to its node shape: built-ins narrow to their
+ * generated props, unknown types fall back to a loose props bag so custom
+ * components still type-check. Built-in `props` is always present — the wire
+ * serializes the full prop object, so reads need no optional chaining.
+ */
+export type NodeOfType<TType extends string = string> = string extends TType ? LooseNode : {
     id?: string;
     key?: string;
-    props?: PropsFor<TType>;
+    props: PropsOf<TType>;
+    schema?: Schema;
     type: TType;
 };
+export type Node<TType extends string = string> = NodeOfType<TType>;
+/** An ordered list of component nodes — the content of a page, form, or container. */
+export type Schema = Node[];
+/** A server-composed layout shell: its key plus a schema containing one Outlet. */
+export type LayoutPayload = {
+    key: string;
+    schema: Schema;
+};
+/**
+ * The page payload the server hydrates onto `lattice` (see PHP `Page::toArray`).
+ * Hand-written rather than generated: its `schema`/`layout.schema` are component
+ * trees serialized eagerly during the request (to fire side effects before the
+ * final encode), so they cannot be derived from a value object as typed `Node[]`.
+ */
 export type PagePayload = {
     breadcrumbs: PageBreadcrumb[];
-    components: Node[];
     container: PageContainer;
-    layout: string;
-    menus: Record<string, MenuPayload | undefined>;
+    layout: LayoutPayload | null;
+    schema: Schema;
     title: string | null;
 };
 export type PageBreadcrumb = {
     href: string;
     title: string;
 };
-export type MenuItem = {
-    active: boolean;
-    href: string;
-    icon: string | null;
-    key: string;
-    label: string;
-    method: Method;
-};
-export type MenuGroup = {
-    items: MenuItem[];
-    label: string | null;
-};
-export type MenuPayload = {
-    groups: MenuGroup[];
-};
-export type KnownPageContainer = "centered" | "default";
 export type PageContainer = KnownPageContainer | (string & {});
 export type RendererComponentProps<TType extends string = string> = {
     children: ReactNode;

package/dist/core/use-column-resizing.d.ts

@@ -0,0 +1,27 @@
+import { HTMLAttributes } from 'react';
+import { SizableColumn } from './column-sizing';
+type ResizeHandleProps = HTMLAttributes<HTMLDivElement> & {
+    "aria-label": string;
+    "aria-orientation": "vertical";
+    "aria-valuemax": number;
+    "aria-valuemin": number;
+    "aria-valuenow": number;
+    role: "separator";
+    tabIndex: number;
+};
+export declare function useColumnResizing({ columnGapPx, columns, enabled, leadingTracks, showIndicator, storageKey, trailingTracks, }: {
+    columnGapPx?: number;
+    columns: SizableColumn[];
+    enabled: boolean;
+    leadingTracks?: string[];
+    showIndicator?: boolean;
+    storageKey?: string;
+    trailingTracks?: string[];
+}): {
+    getResizeHandleProps: (column: SizableColumn) => ResizeHandleProps;
+    gridTemplateColumns: string;
+    hasOverrides: boolean;
+    resetColumns: () => void;
+    resetColumnWidth: (column: SizableColumn) => void;
+};
+export {};

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;