@lattice-php/lattice 0.2.0 → 0.3.0

package/dist/core/registry.d.ts

@@ -1,6 +1,7 @@
 import { LazyExoticComponent } from 'react';
 import { RendererComponent, RendererComponentModule } from './types';
-import { ColumnRegistry } from '../table/column-registry';
+import { ColumnRegistry } from '../table/registry';
+import { EffectHandlerRegistry } from '../effects/registry';
 export type EagerComponentRegistration = {
     component: RendererComponent;
     mode: "eager";
@@ -17,10 +18,12 @@ export type Plugin = {
     name: string;
     components?: ComponentRegistry;
     columns?: ColumnRegistry;
+    effects?: EffectHandlerRegistry;
 };
 export type Registry = {
     components: ComponentRegistry;
     columns: ColumnRegistry;
+    effects: EffectHandlerRegistry;
 };
 export type LazyComponentOptions<TType extends string> = {
     fallback?: RendererComponent<TType>;

package/dist/core/registry.js

@@ -27,10 +27,15 @@ function createRegistry(...plugins) {
 		columns: {
 			...registry.columns,
 			...plugin.columns
+		},
+		effects: {
+			...registry.effects,
+			...plugin.effects
 		}
 	}), {
 		components: {},
-		columns: {}
+		columns: {},
+		effects: {}
 	});
 }
 function extendRegistry(registry, ...plugins) {
@@ -43,6 +48,10 @@ function extendRegistry(registry, ...plugins) {
 		columns: {
 			...registry.columns,
 			...merged.columns
+		},
+		effects: {
+			...registry.effects,
+			...merged.effects
 		}
 	};
 }

package/dist/core/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../resources/js/core/registry.ts"],"sourcesContent":["import { lazy } from \"react\";\nimport type { LazyExoticComponent } from \"react\";\nimport type { RendererComponent, RendererComponentModule } from \"./types\";\nimport type { ColumnRegistry } from \"../table/column-registry\";\n\nexport type EagerComponentRegistration = {\n  component: RendererComponent;\n  mode: \"eager\";\n};\n\nexport type LazyComponentRegistration = {\n  component: LazyExoticComponent<RendererComponent>;\n  fallback?: RendererComponent;\n  load: () => Promise<RendererComponentModule>;\n  mode: \"lazy\";\n};\n\nexport type ComponentRegistration = EagerComponentRegistration | LazyComponentRegistration;\n\nexport type ComponentRegistry = Record<string, ComponentRegistration>;\n\nexport type Plugin = {\n  name: string;\n  components?: ComponentRegistry;\n  columns?: ColumnRegistry;\n};\n\nexport type Registry = {\n  components: ComponentRegistry;\n  columns: ColumnRegistry;\n};\n\nexport type LazyComponentOptions<TType extends string> = {\n  fallback?: RendererComponent<TType>;\n};\n\nexport function eagerComponent<TType extends string>(\n  component: RendererComponent<TType>,\n): EagerComponentRegistration {\n  return {\n    component: component as unknown as RendererComponent,\n    mode: \"eager\",\n  };\n}\n\nexport function lazyComponent<TType extends string>(\n  load: () => Promise<RendererComponentModule<TType>>,\n  options: LazyComponentOptions<TType> = {},\n): LazyComponentRegistration {\n  const erasedLoader = load as unknown as () => Promise<RendererComponentModule>;\n\n  return {\n    component: lazy(erasedLoader),\n    fallback: options.fallback as RendererComponent | undefined,\n    load: erasedLoader,\n    mode: \"lazy\",\n  };\n}\n\nexport function createPlugin(plugin: Plugin): Plugin {\n  return plugin;\n}\n\nexport function createRegistry(...plugins: Plugin[]): Registry {\n  return plugins.reduce<Registry>(\n    (registry, plugin) => ({\n      components: { ...registry.components, ...plugin.components },\n      columns: { ...registry.columns, ...plugin.columns },\n    }),\n    { components: {}, columns: {} },\n  );\n}\n\nexport function extendRegistry(registry: Registry, ...plugins: Plugin[]): Registry {\n  const merged = createRegistry(...plugins);\n\n  return {\n    components: { ...registry.components, ...merged.components },\n    columns: { ...registry.columns, ...merged.columns },\n  };\n}\n"],"mappings":";;AAoCA,SAAgB,eACd,WAC4B;CAC5B,OAAO;EACM;EACX,MAAM;CACR;AACF;AAEA,SAAgB,cACd,MACA,UAAuC,CAAC,GACb;CAC3B,MAAM,eAAe;CAErB,OAAO;EACL,WAAW,KAAK,YAAY;EAC5B,UAAU,QAAQ;EAClB,MAAM;EACN,MAAM;CACR;AACF;AAEA,SAAgB,aAAa,QAAwB;CACnD,OAAO;AACT;AAEA,SAAgB,eAAe,GAAG,SAA6B;CAC7D,OAAO,QAAQ,QACZ,UAAU,YAAY;EACrB,YAAY;GAAE,GAAG,SAAS;GAAY,GAAG,OAAO;EAAW;EAC3D,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAQ;CACpD,IACA;EAAE,YAAY,CAAC;EAAG,SAAS,CAAC;CAAE,CAChC;AACF;AAEA,SAAgB,eAAe,UAAoB,GAAG,SAA6B;CACjF,MAAM,SAAS,eAAe,GAAG,OAAO;CAExC,OAAO;EACL,YAAY;GAAE,GAAG,SAAS;GAAY,GAAG,OAAO;EAAW;EAC3D,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAQ;CACpD;AACF"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../resources/js/core/registry.ts"],"sourcesContent":["import { lazy } from \"react\";\nimport type { LazyExoticComponent } from \"react\";\nimport type { RendererComponent, RendererComponentModule } from \"./types\";\nimport type { ColumnRegistry } from \"../table/registry\";\nimport type { EffectHandlerRegistry } from \"../effects/registry\";\n\nexport type EagerComponentRegistration = {\n  component: RendererComponent;\n  mode: \"eager\";\n};\n\nexport type LazyComponentRegistration = {\n  component: LazyExoticComponent<RendererComponent>;\n  fallback?: RendererComponent;\n  load: () => Promise<RendererComponentModule>;\n  mode: \"lazy\";\n};\n\nexport type ComponentRegistration = EagerComponentRegistration | LazyComponentRegistration;\n\nexport type ComponentRegistry = Record<string, ComponentRegistration>;\n\nexport type Plugin = {\n  name: string;\n  components?: ComponentRegistry;\n  columns?: ColumnRegistry;\n  effects?: EffectHandlerRegistry;\n};\n\nexport type Registry = {\n  components: ComponentRegistry;\n  columns: ColumnRegistry;\n  effects: EffectHandlerRegistry;\n};\n\nexport type LazyComponentOptions<TType extends string> = {\n  fallback?: RendererComponent<TType>;\n};\n\nexport function eagerComponent<TType extends string>(\n  component: RendererComponent<TType>,\n): EagerComponentRegistration {\n  return {\n    component: component as unknown as RendererComponent,\n    mode: \"eager\",\n  };\n}\n\nexport function lazyComponent<TType extends string>(\n  load: () => Promise<RendererComponentModule<TType>>,\n  options: LazyComponentOptions<TType> = {},\n): LazyComponentRegistration {\n  const erasedLoader = load as unknown as () => Promise<RendererComponentModule>;\n\n  return {\n    component: lazy(erasedLoader),\n    fallback: options.fallback as RendererComponent | undefined,\n    load: erasedLoader,\n    mode: \"lazy\",\n  };\n}\n\nexport function createPlugin(plugin: Plugin): Plugin {\n  return plugin;\n}\n\nexport function createRegistry(...plugins: Plugin[]): Registry {\n  return plugins.reduce<Registry>(\n    (registry, plugin) => ({\n      components: { ...registry.components, ...plugin.components },\n      columns: { ...registry.columns, ...plugin.columns },\n      effects: { ...registry.effects, ...plugin.effects },\n    }),\n    { components: {}, columns: {}, effects: {} },\n  );\n}\n\nexport function extendRegistry(registry: Registry, ...plugins: Plugin[]): Registry {\n  const merged = createRegistry(...plugins);\n\n  return {\n    components: { ...registry.components, ...merged.components },\n    columns: { ...registry.columns, ...merged.columns },\n    effects: { ...registry.effects, ...merged.effects },\n  };\n}\n"],"mappings":";;AAuCA,SAAgB,eACd,WAC4B;CAC5B,OAAO;EACM;EACX,MAAM;CACR;AACF;AAEA,SAAgB,cACd,MACA,UAAuC,CAAC,GACb;CAC3B,MAAM,eAAe;CAErB,OAAO;EACL,WAAW,KAAK,YAAY;EAC5B,UAAU,QAAQ;EAClB,MAAM;EACN,MAAM;CACR;AACF;AAEA,SAAgB,aAAa,QAAwB;CACnD,OAAO;AACT;AAEA,SAAgB,eAAe,GAAG,SAA6B;CAC7D,OAAO,QAAQ,QACZ,UAAU,YAAY;EACrB,YAAY;GAAE,GAAG,SAAS;GAAY,GAAG,OAAO;EAAW;EAC3D,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAQ;EAClD,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAQ;CACpD,IACA;EAAE,YAAY,CAAC;EAAG,SAAS,CAAC;EAAG,SAAS,CAAC;CAAE,CAC7C;AACF;AAEA,SAAgB,eAAe,UAAoB,GAAG,SAA6B;CACjF,MAAM,SAAS,eAAe,GAAG,OAAO;CAExC,OAAO;EACL,YAAY;GAAE,GAAG,SAAS;GAAY,GAAG,OAAO;EAAW;EAC3D,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAQ;EAClD,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAQ;CACpD;AACF"}

package/dist/core/renderer.d.ts

@@ -1,16 +1,10 @@
 import { ReactNode } from 'react';
-import { ComponentRegistry } from './registry';
-import { Node, UnknownComponent } from './types';
-type RendererContextValue = {
-    fallback: ReactNode;
-    missingComponent: UnknownComponent;
-    registry: ComponentRegistry;
-};
-export declare function useRendererContext(): RendererContextValue;
-export declare function Renderer({ fallback, missingComponent: UnknownComponent, nodes, registry, }: {
-    fallback?: ReactNode;
-    missingComponent?: UnknownComponent;
+import { Node } from './types';
+/** Renders a schema (list of nodes) against the active component registry. */
+export declare function Renderer({ nodes }: {
     nodes: Node[];
-    registry: ComponentRegistry;
-}): import("react").JSX.Element;
-export {};
+}): ReactNode;
+/** Renders a single node against the active component registry. */
+export declare function RenderNode({ node }: {
+    node: Node;
+}): ReactNode;

package/dist/core/renderer.js

@@ -1,41 +1,31 @@
-import { Suspense, createContext, useContext, useMemo } from "react";
+import { useComponentRegistry } from "./registry-context.js";
+import { useCollapsed } from "./collapsed-context.js";
+import { Suspense } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region resources/js/core/renderer.tsx
 function MissingComponent({ node }) {
 	return null;
 }
-var RendererContext = createContext(null);
-function useRendererContext() {
-	const context = useContext(RendererContext);
-	if (!context) throw new Error("Renderer context is not available.");
-	return context;
-}
 function nodeKey(node, index) {
 	return node.key ?? node.id ?? `${node.type}-${index}`;
 }
-function Renderer({ fallback = null, missingComponent: UnknownComponent = MissingComponent, nodes, registry }) {
-	const context = useMemo(() => ({
-		fallback,
-		missingComponent: UnknownComponent,
-		registry
-	}), [
-		fallback,
-		registry,
-		UnknownComponent
-	]);
-	return /* @__PURE__ */ jsx(RendererContext.Provider, {
-		value: context,
-		children: nodes.map((node, index) => /* @__PURE__ */ jsx(NodeRenderer, { node }, nodeKey(node, index)))
-	});
+/** Renders a schema (list of nodes) against the active component registry. */
+function Renderer({ nodes }) {
+	return nodes.map((node, index) => /* @__PURE__ */ jsx(NodeRenderer, { node }, nodeKey(node, index)));
+}
+/** Renders a single node against the active component registry. */
+function RenderNode({ node }) {
+	return /* @__PURE__ */ jsx(NodeRenderer, { node });
 }
 function NodeRenderer({ node }) {
-	const { fallback, missingComponent: UnknownComponent, registry } = useRendererContext();
-	const registration = registry[node.type];
-	if (!registration) return /* @__PURE__ */ jsx(UnknownComponent, { node });
+	const collapsed = useCollapsed();
+	const registration = useComponentRegistry()[node.type];
+	if (collapsed && node.props?.hideWhenCollapsed === true) return null;
+	if (!registration) return /* @__PURE__ */ jsx(MissingComponent, { node });
 	const Component = registration.component;
 	const renderedComponent = /* @__PURE__ */ jsx(Component, {
 		node,
-		children: node.schema?.length ? node.schema.map((child, index) => /* @__PURE__ */ jsx(NodeRenderer, { node: child }, nodeKey(child, index))) : null
+		children: node.schema?.length ? /* @__PURE__ */ jsx(Renderer, { nodes: node.schema }) : null
 	});
 	if (registration.mode === "lazy") {
 		const FallbackComponent = registration.fallback;
@@ -43,13 +33,13 @@ function NodeRenderer({ node }) {
 			fallback: FallbackComponent ? /* @__PURE__ */ jsx(FallbackComponent, {
 				node,
 				children: null
-			}) : fallback,
+			}) : null,
 			children: renderedComponent
 		});
 	}
 	return renderedComponent;
 }
 //#endregion
-export { Renderer, useRendererContext };
+export { RenderNode, Renderer };
 
 //# sourceMappingURL=renderer.js.map

package/dist/core/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","names":[],"sources":["../../resources/js/core/renderer.tsx"],"sourcesContent":["import { createContext, Suspense, useContext, useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { ComponentRegistry } from \"./registry\";\nimport type { Node, UnknownComponent } from \"./types\";\n\nfunction MissingComponent({ node }: { node: Node }) {\n  if (!import.meta.env.DEV) {\n    return null;\n  }\n\n  return <div data-lattice-missing-component={node.type}>Missing component: {node.type}</div>;\n}\n\ntype RendererContextValue = {\n  fallback: ReactNode;\n  missingComponent: UnknownComponent;\n  registry: ComponentRegistry;\n};\n\nconst RendererContext = createContext<RendererContextValue | null>(null);\n\nexport function useRendererContext(): RendererContextValue {\n  const context = useContext(RendererContext);\n\n  if (!context) {\n    throw new Error(\"Renderer context is not available.\");\n  }\n\n  return context;\n}\n\nfunction nodeKey(node: Node, index: number): string {\n  return node.key ?? node.id ?? `${node.type}-${index}`;\n}\n\nexport function Renderer({\n  fallback = null,\n  missingComponent: UnknownComponent = MissingComponent,\n  nodes,\n  registry,\n}: {\n  fallback?: ReactNode;\n  missingComponent?: UnknownComponent;\n  nodes: Node[];\n  registry: ComponentRegistry;\n}) {\n  const context = useMemo(\n    () => ({\n      fallback,\n      missingComponent: UnknownComponent,\n      registry,\n    }),\n    [fallback, registry, UnknownComponent],\n  );\n\n  return (\n    <RendererContext.Provider value={context}>\n      {nodes.map((node, index) => (\n        <NodeRenderer key={nodeKey(node, index)} node={node} />\n      ))}\n    </RendererContext.Provider>\n  );\n}\n\nfunction NodeRenderer({ node }: { node: Node }) {\n  const { fallback, missingComponent: UnknownComponent, registry } = useRendererContext();\n  const registration = registry[node.type];\n\n  if (!registration) {\n    return <UnknownComponent node={node} />;\n  }\n\n  const Component = registration.component;\n  const children = node.schema?.length\n    ? node.schema.map((child, index) => <NodeRenderer key={nodeKey(child, index)} node={child} />)\n    : null;\n\n  const renderedComponent = <Component node={node}>{children}</Component>;\n\n  if (registration.mode === \"lazy\") {\n    const FallbackComponent = registration.fallback;\n    const suspenseFallback = FallbackComponent ? (\n      <FallbackComponent node={node}>{null}</FallbackComponent>\n    ) : (\n      fallback\n    );\n\n    return <Suspense fallback={suspenseFallback}>{renderedComponent}</Suspense>;\n  }\n\n  return renderedComponent;\n}\n"],"mappings":";;;AAKA,SAAS,iBAAiB,EAAE,QAAwB;CAEhD,OAAO;AAIX;AAQA,IAAM,kBAAkB,cAA2C,IAAI;AAEvE,SAAgB,qBAA2C;CACzD,MAAM,UAAU,WAAW,eAAe;CAE1C,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,oCAAoC;CAGtD,OAAO;AACT;AAEA,SAAS,QAAQ,MAAY,OAAuB;CAClD,OAAO,KAAK,OAAO,KAAK,MAAM,GAAG,KAAK,KAAK,GAAG;AAChD;AAEA,SAAgB,SAAS,EACvB,WAAW,MACX,kBAAkB,mBAAmB,kBACrC,OACA,YAMC;CACD,MAAM,UAAU,eACP;EACL;EACA,kBAAkB;EAClB;CACF,IACA;EAAC;EAAU;EAAU;CAAgB,CACvC;CAEA,OACE,oBAAC,gBAAgB,UAAjB;EAA0B,OAAO;YAC9B,MAAM,KAAK,MAAM,UAChB,oBAAC,cAAD,EAA+C,KAAO,GAAnC,QAAQ,MAAM,KAAK,CAAgB,CACvD;CACuB,CAAA;AAE9B;AAEA,SAAS,aAAa,EAAE,QAAwB;CAC9C,MAAM,EAAE,UAAU,kBAAkB,kBAAkB,aAAa,mBAAmB;CACtF,MAAM,eAAe,SAAS,KAAK;CAEnC,IAAI,CAAC,cACH,OAAO,oBAAC,kBAAD,EAAwB,KAAO,CAAA;CAGxC,MAAM,YAAY,aAAa;CAK/B,MAAM,oBAAoB,oBAAC,WAAD;EAAiB;EAAO,UAJjC,KAAK,QAAQ,SAC1B,KAAK,OAAO,KAAK,OAAO,UAAU,oBAAC,cAAD,EAA0C,MAAM,MAAQ,GAArC,QAAQ,OAAO,KAAK,CAAiB,CAAC,IAC3F;CAEkE,CAAA;CAEtE,IAAI,aAAa,SAAS,QAAQ;EAChC,MAAM,oBAAoB,aAAa;EAOvC,OAAO,oBAAC,UAAD;GAAU,UANQ,oBACvB,oBAAC,mBAAD;IAAyB;cAAO;GAAwB,CAAA,IAExD;aAG4C;EAA4B,CAAA;CAC5E;CAEA,OAAO;AACT"}
+{"version":3,"file":"renderer.js","names":[],"sources":["../../resources/js/core/renderer.tsx"],"sourcesContent":["import { Suspense } from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { Node } from \"./types\";\nimport { useCollapsed } from \"./collapsed-context\";\nimport { useComponentRegistry } from \"./registry-context\";\n\nfunction MissingComponent({ node }: { node: Node }) {\n  if (!import.meta.env.DEV) {\n    return null;\n  }\n\n  return <div data-lattice-missing-component={node.type}>Missing component: {node.type}</div>;\n}\n\nfunction nodeKey(node: Node, index: number): string {\n  return node.key ?? node.id ?? `${node.type}-${index}`;\n}\n\n/** Renders a schema (list of nodes) against the active component registry. */\nexport function Renderer({ nodes }: { nodes: Node[] }): ReactNode {\n  return nodes.map((node, index) => <NodeRenderer key={nodeKey(node, index)} node={node} />);\n}\n\n/** Renders a single node against the active component registry. */\nexport function RenderNode({ node }: { node: Node }): ReactNode {\n  return <NodeRenderer node={node} />;\n}\n\nfunction NodeRenderer({ node }: { node: Node }) {\n  const collapsed = useCollapsed();\n  const registry = useComponentRegistry();\n  const registration = registry[node.type];\n\n  if (collapsed && node.props?.hideWhenCollapsed === true) {\n    return null;\n  }\n\n  if (!registration) {\n    return <MissingComponent node={node} />;\n  }\n\n  const Component = registration.component;\n  const children = node.schema?.length ? <Renderer nodes={node.schema} /> : null;\n  const renderedComponent = <Component node={node}>{children}</Component>;\n\n  if (registration.mode === \"lazy\") {\n    const FallbackComponent = registration.fallback;\n    const fallback = FallbackComponent ? (\n      <FallbackComponent node={node}>{null}</FallbackComponent>\n    ) : null;\n\n    return <Suspense fallback={fallback}>{renderedComponent}</Suspense>;\n  }\n\n  return renderedComponent;\n}\n"],"mappings":";;;;;AAMA,SAAS,iBAAiB,EAAE,QAAwB;CAEhD,OAAO;AAIX;AAEA,SAAS,QAAQ,MAAY,OAAuB;CAClD,OAAO,KAAK,OAAO,KAAK,MAAM,GAAG,KAAK,KAAK,GAAG;AAChD;;AAGA,SAAgB,SAAS,EAAE,SAAuC;CAChE,OAAO,MAAM,KAAK,MAAM,UAAU,oBAAC,cAAD,EAA+C,KAAO,GAAnC,QAAQ,MAAM,KAAK,CAAgB,CAAC;AAC3F;;AAGA,SAAgB,WAAW,EAAE,QAAmC;CAC9D,OAAO,oBAAC,cAAD,EAAoB,KAAO,CAAA;AACpC;AAEA,SAAS,aAAa,EAAE,QAAwB;CAC9C,MAAM,YAAY,aAAa;CAE/B,MAAM,eADW,qBACI,EAAS,KAAK;CAEnC,IAAI,aAAa,KAAK,OAAO,sBAAsB,MACjD,OAAO;CAGT,IAAI,CAAC,cACH,OAAO,oBAAC,kBAAD,EAAwB,KAAO,CAAA;CAGxC,MAAM,YAAY,aAAa;CAE/B,MAAM,oBAAoB,oBAAC,WAAD;EAAiB;EAAO,UADjC,KAAK,QAAQ,SAAS,oBAAC,UAAD,EAAU,OAAO,KAAK,OAAS,CAAA,IAAI;CACJ,CAAA;CAEtE,IAAI,aAAa,SAAS,QAAQ;EAChC,MAAM,oBAAoB,aAAa;EAKvC,OAAO,oBAAC,UAAD;GAAoB,UAJV,oBACf,oBAAC,mBAAD;IAAyB;cAAO;GAAwB,CAAA,IACtD;aAEkC;EAA4B,CAAA;CACpE;CAEA,OAAO;AACT"}

package/dist/core/test-id.d.ts

@@ -0,0 +1,8 @@
+import { Node } from './types';
+type IdentifiedNode = Pick<Node, "id" | "key">;
+export declare function testIdentity(value: string | null | undefined): string | undefined;
+export declare function nodeIdentity(node: IdentifiedNode): string | undefined;
+export declare function leafTestIdentity(value: string | null | undefined): string | undefined;
+export declare function prefixedTestId(prefix: string, value: string | null | undefined): string | undefined;
+export declare function prefixedNodeTestId(prefix: string, node: IdentifiedNode): string | undefined;
+export {};

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

@@ -3,6 +3,9 @@ import { Node as WireNode, NodeType, Option, PageContainer as KnownPageContainer
 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 };
 /**
@@ -25,18 +28,23 @@ export type LooseNode<TType extends string = string> = {
  */
 export interface ComponentProps {
 }
-type BuiltInPropsOf<TType extends string> = [Extract<WireNode, {
-    type: TType;
-}>] extends [never] ? never : Extract<WireNode, {
-    type: TType;
-}> extends {
-    props: infer TProps;
-} ? TProps : never;
+/**
+ * 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> = TType extends keyof ComponentProps ? ComponentProps[TType] : [BuiltInPropsOf<TType>] extends [never] ? NodeProps : BuiltInPropsOf<TType>;
+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
@@ -58,6 +66,12 @@ 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[];
     container: PageContainer;

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"}