@lattice-php/lattice 0.40.0 → 0.42.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import "./types/core-augmentation.js";
 export { registry } from './registry.js';
 export { useChat } from './chat/hooks/use-chat.js';
 export { chatComponents } from './chat/plugin.js';

package/dist/index.js

@@ -20,8 +20,8 @@ import { LATTICE_REF_HEADER, withRefHeader } from "@lattice-php/core/component-r
 import { Icon, IconRenderer, IconRendererProvider, SpriteProvider } from "@lattice-php/ui/icons";
 import { Renderer } from "@lattice-php/core/renderer";
 import { LATTICE_EVENT } from "@lattice-php/core/event-names";
-import { useEffectDispatcher } from "@lattice-php/ui/effects/use-effect-dispatcher";
 import { dispatchActionError, dispatchEffects, getActionEffects, isActionEffect } from "@lattice-php/ui/effects/dispatch";
+import { useEffectDispatcher } from "@lattice-php/ui/effects/use-effect-dispatcher";
 import { builtinEffectHandlers, effectHandler, mergeEffectHandlers } from "@lattice-php/ui/effects/registry";
 import { copyToClipboard } from "@lattice-php/ui/copyable-text";
 import { columnCell } from "@lattice-php/table/registry";

package/dist/provider-base.js

@@ -1,9 +1,9 @@
 import { updateAppearance } from "./appearance/index.js";
 import { Toaster } from "./toast/toaster.js";
-import { ActionInteractionProvider } from "./action/components/action-trigger-provider.js";
 import { EventBridge } from "./event-bridge.js";
 import { RegistryContext } from "@lattice-php/core/registry-context";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { ActionInteractionProvider } from "@lattice-php/action/components/action-trigger-provider";
 import { useFlashEffects } from "@lattice-php/ui/effects/use-flash-effects";
 import { SpriteProvider } from "@lattice-php/ui/icons/sprite";
 //#region resources/js/provider-base.tsx

package/dist/provider-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-base.js","names":[],"sources":["../resources/js/provider-base.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { ActionInteractionProvider } from \"./action/components/action-trigger-provider\";\nimport type { Registry } from \"@lattice-php/core/registry\";\nimport { RegistryContext } from \"@lattice-php/core/registry-context\";\nimport { useFlashEffects } from \"@lattice-php/ui/effects/use-flash-effects\";\nimport { EventBridge } from \"./event-bridge\";\nimport type { SpriteValue } from \"@lattice-php/ui/icons/sprite\";\nimport { SpriteProvider } from \"@lattice-php/ui/icons/sprite\";\nimport { Toaster } from \"./toast\";\nimport { updateAppearance } from \"./appearance\";\n\nconst defaultSprite: SpriteValue = { href: \"\" };\n\nexport type ProviderBaseProps = {\n  children: ReactNode;\n  registry: Registry;\n  sprite?: SpriteValue;\n  toaster?: boolean;\n};\n\nexport function ProviderBase({\n  children,\n  registry,\n  sprite = defaultSprite,\n  toaster = true,\n}: ProviderBaseProps) {\n  useFlashEffects();\n\n  return (\n    <RegistryContext.Provider value={registry}>\n      <ActionInteractionProvider>\n        <SpriteProvider sprite={sprite}>\n          {children}\n          <EventBridge onAppearanceChange={updateAppearance} />\n          {toaster ? <Toaster /> : null}\n        </SpriteProvider>\n      </ActionInteractionProvider>\n    </RegistryContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;AAWA,IAAM,gBAA6B,EAAE,MAAM,GAAG;AAS9C,SAAgB,aAAa,EAC3B,UACA,UACA,SAAS,eACT,UAAU,QACU;CACpB,gBAAgB;CAEhB,OACE,oBAAC,gBAAgB,UAAjB;EAA0B,OAAO;EAC/B,UAAA,oBAAC,2BAAD,EAAA,UACE,qBAAC,gBAAD;GAAwB;GAAxB,UAAA;IACG;IACD,oBAAC,aAAD,EAAa,oBAAoB,iBAAmB,CAAA;IACnD,UAAU,oBAAC,SAAD,CAAU,CAAA,IAAI;GACX;EACS,CAAA,EAAA,CAAA;CACH,CAAA;AAE9B"}
+{"version":3,"file":"provider-base.js","names":[],"sources":["../resources/js/provider-base.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { ActionInteractionProvider } from \"@lattice-php/action/components/action-trigger-provider\";\nimport type { Registry } from \"@lattice-php/core/registry\";\nimport { RegistryContext } from \"@lattice-php/core/registry-context\";\nimport { useFlashEffects } from \"@lattice-php/ui/effects/use-flash-effects\";\nimport { EventBridge } from \"./event-bridge\";\nimport type { SpriteValue } from \"@lattice-php/ui/icons/sprite\";\nimport { SpriteProvider } from \"@lattice-php/ui/icons/sprite\";\nimport { Toaster } from \"./toast\";\nimport { updateAppearance } from \"./appearance\";\n\nconst defaultSprite: SpriteValue = { href: \"\" };\n\nexport type ProviderBaseProps = {\n  children: ReactNode;\n  registry: Registry;\n  sprite?: SpriteValue;\n  toaster?: boolean;\n};\n\nexport function ProviderBase({\n  children,\n  registry,\n  sprite = defaultSprite,\n  toaster = true,\n}: ProviderBaseProps) {\n  useFlashEffects();\n\n  return (\n    <RegistryContext.Provider value={registry}>\n      <ActionInteractionProvider>\n        <SpriteProvider sprite={sprite}>\n          {children}\n          <EventBridge onAppearanceChange={updateAppearance} />\n          {toaster ? <Toaster /> : null}\n        </SpriteProvider>\n      </ActionInteractionProvider>\n    </RegistryContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;AAWA,IAAM,gBAA6B,EAAE,MAAM,GAAG;AAS9C,SAAgB,aAAa,EAC3B,UACA,UACA,SAAS,eACT,UAAU,QACU;CACpB,gBAAgB;CAEhB,OACE,oBAAC,gBAAgB,UAAjB;EAA0B,OAAO;EAC/B,UAAA,oBAAC,2BAAD,EAAA,UACE,qBAAC,gBAAD;GAAwB;GAAxB,UAAA;IACG;IACD,oBAAC,aAAD,EAAa,oBAAoB,iBAAmB,CAAA;IACnD,UAAU,oBAAC,SAAD,CAAU,CAAA,IAAI;GACX;EACS,CAAA,EAAA,CAAA;CACH,CAAA;AAE9B"}

package/dist/registry.js

@@ -1,10 +1,10 @@
 import { layoutComponents } from "./layout/plugin.js";
-import { actionComponents } from "./action/plugin.js";
 import { chatComponents } from "./chat/plugin.js";
 import { fragmentComponents } from "./fragments/plugin.js";
 import { notificationsComponents } from "./notifications/plugin.js";
 import { remoteComponents } from "./remote/plugin.js";
 import { createRegistry } from "@lattice-php/core/registry";
+import { actionComponents } from "@lattice-php/action/plugin";
 import { formComponents } from "@lattice-php/form";
 import { tableComponents } from "@lattice-php/table";
 import { uiComponents } from "@lattice-php/ui";

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../resources/js/registry.ts"],"sourcesContent":["import { createRegistry } from \"@lattice-php/core/registry\";\nimport type {\n  ActionNodeType,\n  ChatNodeType,\n  FormNodeType,\n  FragmentNodeType,\n  LayoutNodeType,\n  NodeType,\n  NotificationNodeType,\n  RemoteNodeType,\n  TableNodeType,\n  UiNodeType,\n} from \"@lattice-php/lattice/types/generated\";\nimport { actionComponents } from \"./action/plugin\";\nimport { chatComponents } from \"./chat/plugin\";\nimport { formComponents } from \"@lattice-php/form\";\nimport { fragmentComponents } from \"./fragments/plugin\";\nimport { layoutComponents } from \"./layout/plugin\";\nimport { notificationsComponents } from \"./notifications/plugin\";\nimport { remoteComponents } from \"./remote/plugin\";\nimport { tableComponents } from \"@lattice-php/table\";\nimport { uiComponents } from \"@lattice-php/ui\";\n\n// Compile-time totality: every generated NodeType must belong to a registered\n// plugin's union. A new PHP domain fails here until its plugin exists.\ntype RegisteredNodeType =\n  | ActionNodeType\n  | ChatNodeType\n  | FormNodeType\n  | FragmentNodeType\n  | LayoutNodeType\n  | NotificationNodeType\n  | RemoteNodeType\n  | TableNodeType\n  | UiNodeType;\ntype Assert<T extends true> = T;\nexport type AllNodeTypesRegistered = Assert<\n  Exclude<NodeType, RegisteredNodeType> extends never ? true : false\n>;\n\nexport const registry = createRegistry(\n  uiComponents,\n  fragmentComponents,\n  actionComponents,\n  formComponents,\n  layoutComponents,\n  tableComponents,\n  chatComponents,\n  notificationsComponents,\n  remoteComponents,\n);\n"],"mappings":";;;;;;;;;;;AAwCA,IAAa,WAAW,eACtB,cACA,oBACA,kBACA,gBACA,kBACA,iBACA,gBACA,yBACA,gBACF"}
+{"version":3,"file":"registry.js","names":[],"sources":["../resources/js/registry.ts"],"sourcesContent":["import { createRegistry } from \"@lattice-php/core/registry\";\nimport type {\n  ActionNodeType,\n  ChatNodeType,\n  FormNodeType,\n  FragmentNodeType,\n  LayoutNodeType,\n  NodeType,\n  NotificationNodeType,\n  RemoteNodeType,\n  TableNodeType,\n  UiNodeType,\n} from \"@lattice-php/lattice/types/generated\";\nimport { actionComponents } from \"@lattice-php/action/plugin\";\nimport { chatComponents } from \"./chat/plugin\";\nimport { formComponents } from \"@lattice-php/form\";\nimport { fragmentComponents } from \"./fragments/plugin\";\nimport { layoutComponents } from \"./layout/plugin\";\nimport { notificationsComponents } from \"./notifications/plugin\";\nimport { remoteComponents } from \"./remote/plugin\";\nimport { tableComponents } from \"@lattice-php/table\";\nimport { uiComponents } from \"@lattice-php/ui\";\n\n// Compile-time totality: every generated NodeType must belong to a registered\n// plugin's union. A new PHP domain fails here until its plugin exists.\ntype RegisteredNodeType =\n  | ActionNodeType\n  | ChatNodeType\n  | FormNodeType\n  | FragmentNodeType\n  | LayoutNodeType\n  | NotificationNodeType\n  | RemoteNodeType\n  | TableNodeType\n  | UiNodeType;\ntype Assert<T extends true> = T;\nexport type AllNodeTypesRegistered = Assert<\n  Exclude<NodeType, RegisteredNodeType> extends never ? true : false\n>;\n\nexport const registry = createRegistry(\n  uiComponents,\n  fragmentComponents,\n  actionComponents,\n  formComponents,\n  layoutComponents,\n  tableComponents,\n  chatComponents,\n  notificationsComponents,\n  remoteComponents,\n);\n"],"mappings":";;;;;;;;;;;AAwCA,IAAa,WAAW,eACtB,cACA,oBACA,kBACA,gBACA,kBACA,iBACA,gBACA,yBACA,gBACF"}

package/dist/runtime.d.ts

@@ -1,9 +1,17 @@
 export * from './index.js';
 export { router } from '@inertiajs/react';
-export { apiJson } from '@lattice-php/core/api';
+export { runAction } from '@lattice-php/action';
+export { apiFetch, apiJson, setRefRefreshEndpoint, xsrfToken } from '@lattice-php/core/api';
+export { RenderNode } from '@lattice-php/core/renderer';
 export { nodeIdentity } from '@lattice-php/core/test-id';
-export { cn, usePersistentState } from '@lattice-php/ui';
-export { setRefRefreshEndpoint } from '@lattice-php/core/api';
+export { requestSignedUpload, xhrTransfer } from '@lattice-php/core/upload';
+export { SimpleField } from '@lattice-php/form/components/fields/simple-field';
+export { RICH_EDITOR_EXTENSION, ToolbarIconButton } from '@lattice-php/form/rich-editor';
 export * from '@lattice-php/form/toolkit';
+export { useTable } from '@lattice-php/table/hooks/use-table';
+export { useTableSelection } from '@lattice-php/table/hooks/use-table-selection';
+export { getBulkActions } from '@lattice-php/table/lib/bulk';
+export { Button, Checkbox, cn, ConfirmDialog, Dialog, DialogContent, DialogHeader, formatDateValue, IconButton, Input, Label, NativeSelect, PreviewableImage, useDebouncedCallback, useFormatContext, usePersistentState, } from '@lattice-php/ui';
 export * from '@lattice-php/ui/i18n';
+export { announce, attachTreeItemInstruction, combine, draggable, dropTargetForElements, extractTreeItemInstruction, } from './dnd/index.js';
 export type { Variant } from './toast/index.js';

package/dist/runtime.js

@@ -15,10 +15,19 @@ import { registry } from "./registry.js";
 import { createLatticeApp } from "./create-app.js";
 import { Provider, useColumnRegistry, useComponentRegistry } from "./provider.js";
 import { Icon, IconRenderer, IconRendererProvider, LATTICE_EVENT, LATTICE_REF_HEADER, Renderer, SpriteProvider, builtinEffectHandlers, columnCell, copyToClipboard, createRegistry, dispatchActionError, dispatchEffects, eagerComponent, effectHandler, extendRegistry, getActionEffects, isActionEffect, lazyComponent, loadPluginModules, mergeEffectHandlers, useEffectDispatcher, withHeaders, withRefHeader } from "./index.js";
+import { announce, attachTreeItemInstruction, combine, draggable, dropTargetForElements, extractTreeItemInstruction } from "./dnd/index.js";
 import { router } from "@inertiajs/react";
-import { apiJson, setRefRefreshEndpoint } from "@lattice-php/core/api";
+import { apiFetch, apiJson, setRefRefreshEndpoint, xsrfToken } from "@lattice-php/core/api";
+import { RenderNode } from "@lattice-php/core/renderer";
 import { nodeIdentity } from "@lattice-php/core/test-id";
-import { cn, usePersistentState } from "@lattice-php/ui";
+import { Button, Checkbox, ConfirmDialog, Dialog, DialogContent, DialogHeader, IconButton, Input, Label, NativeSelect, PreviewableImage, cn, formatDateValue, useDebouncedCallback, useFormatContext, usePersistentState } from "@lattice-php/ui";
+import { runAction } from "@lattice-php/action";
+import { requestSignedUpload, xhrTransfer } from "@lattice-php/core/upload";
+import { SimpleField } from "@lattice-php/form/components/fields/simple-field";
+import { RICH_EDITOR_EXTENSION, ToolbarIconButton } from "@lattice-php/form/rich-editor";
+import { useTable } from "@lattice-php/table/hooks/use-table";
+import { useTableSelection } from "@lattice-php/table/hooks/use-table-selection";
+import { getBulkActions } from "@lattice-php/table/lib/bulk";
 export * from "@lattice-php/ui/i18n";
 export * from "@lattice-php/form/toolkit";
-export { Callouts, EventBridge, Icon, IconRenderer, IconRendererProvider, LATTICE_EVENT, LATTICE_REF_HEADER, OutletContext, Provider, RealtimeListeners, Renderer, SchemaLayout, SidebarCollapsedContext, SpriteProvider, Toaster, apiJson, builtinEffectHandlers, chatComponents, cn, columnCell, copyToClipboard, createLatticeApp, createLayoutResolver, createPageResolver, createRegistry, dispatchActionError, dispatchEffects, eagerComponent, effectHandler, extendRegistry, getActionEffects, initializeAppearance, isActionEffect, layoutComponents, lazyComponent, loadPluginModules, mergeEffectHandlers, nodeIdentity, onCallout, onToast, pageComponentName, registry, router, setRefRefreshEndpoint, updateAppearance, useAppearance, useChat, useColumnRegistry, useComponentRegistry, useEffectDispatcher, usePersistentState, useSidebarCollapsed, withHeaders, withRefHeader, withVisitHeaders };
+export { Button, Callouts, Checkbox, ConfirmDialog, Dialog, DialogContent, DialogHeader, EventBridge, Icon, IconButton, IconRenderer, IconRendererProvider, Input, LATTICE_EVENT, LATTICE_REF_HEADER, Label, NativeSelect, OutletContext, PreviewableImage, Provider, RICH_EDITOR_EXTENSION, RealtimeListeners, RenderNode, Renderer, SchemaLayout, SidebarCollapsedContext, SimpleField, SpriteProvider, Toaster, ToolbarIconButton, announce, apiFetch, apiJson, attachTreeItemInstruction, builtinEffectHandlers, chatComponents, cn, columnCell, combine, copyToClipboard, createLatticeApp, createLayoutResolver, createPageResolver, createRegistry, dispatchActionError, dispatchEffects, draggable, dropTargetForElements, eagerComponent, effectHandler, extendRegistry, extractTreeItemInstruction, formatDateValue, getActionEffects, getBulkActions, initializeAppearance, isActionEffect, layoutComponents, lazyComponent, loadPluginModules, mergeEffectHandlers, nodeIdentity, onCallout, onToast, pageComponentName, registry, requestSignedUpload, router, runAction, setRefRefreshEndpoint, updateAppearance, useAppearance, useChat, useColumnRegistry, useComponentRegistry, useDebouncedCallback, useEffectDispatcher, useFormatContext, usePersistentState, useSidebarCollapsed, useTable, useTableSelection, withHeaders, withRefHeader, withVisitHeaders, xhrTransfer, xsrfToken };

package/dist/types/core-augmentation.d.ts

@@ -1,4 +1,5 @@
 import { ComponentPropsMap } from './generated.js';
 declare module "@lattice-php/core" {
-  interface ComponentProps extends ComponentPropsMap {}
+    interface ComponentProps extends ComponentPropsMap {
+    }
 }

package/dist/vite.d.ts

@@ -30,22 +30,27 @@ export type LatticeComponentPackage = {
     dir: string;
     /** Absolute path to the package's JS plugin entry. */
     plugin: string;
+    /** Absolute path to the package's stylesheet, when it declares one. */
+    css?: string;
+    /** Absolute path to the package's icon directory, when it declares one. */
+    icons?: string;
+};
+type LatticeManifest = {
+    plugin?: string;
+    css?: string;
+    icons?: string;
 };
 type InstalledPackage = {
     name: string;
     "install-path"?: string;
     extra?: {
-        lattice?: {
-            plugin?: string;
-        };
+        lattice?: LatticeManifest;
     };
 };
 type RootPackageJson = {
     name?: string;
     extra?: {
-        lattice?: {
-            plugin?: string;
-        };
+        lattice?: LatticeManifest;
     };
 };
 /**
@@ -77,5 +82,5 @@ export declare function discoverComponentPackages(appRoot: string): LatticeCompo
  */
 export declare function componentPackagesPlugin(packages: LatticeComponentPackage[]): Plugin;
 export declare function latticeConfig(options?: LatticeViteOptions): ConfigWithTest;
-export declare function resolveIconOptions(options: LatticeViteOptions): SvgSpriteOptions | null;
+export declare function resolveIconOptions(options: LatticeViteOptions, packages?: LatticeComponentPackage[]): SvgSpriteOptions | null;
 export {};

package/dist/vite.js

@@ -6,16 +6,23 @@ import { searchForWorkspaceRoot } from "vite";
 //#region resources/js/vite.ts
 function lattice(options = {}) {
 	const { appRoot } = resolveRoots(options);
+	const packages = discoverComponentPackages(appRoot);
 	const plugins = [
 		corePlugin(options),
 		optionalPeersPlugin(),
-		componentPackagesPlugin(discoverComponentPackages(appRoot)),
+		componentPackagesPlugin(packages),
 		typescriptPlugin(options)
 	];
-	const iconOptions = resolveIconOptions(options);
+	const iconOptions = resolveIconOptions(options, packages);
 	if (iconOptions) plugins.push(svgSprite(iconOptions));
 	return plugins;
 }
+function resolveManifestPaths(manifest, dir) {
+	return {
+		...typeof manifest.css === "string" ? { css: path.resolve(dir, manifest.css) } : {},
+		...typeof manifest.icons === "string" ? { icons: path.resolve(dir, manifest.icons) } : {}
+	};
+}
 /**
 * Resolve every Composer package that declares `extra.lattice.plugin` into an
 * absolute plugin-entry path. `installPathsRelativeTo` is `vendor/composer` (the
@@ -23,13 +30,15 @@ function lattice(options = {}) {
 */
 function collectComponentPackages(installed, installPathsRelativeTo) {
 	return (Array.isArray(installed) ? installed : installed.packages ?? []).flatMap((pkg) => {
-		const entry = pkg.extra?.lattice?.plugin;
+		const manifest = pkg.extra?.lattice ?? {};
+		const entry = manifest.plugin;
 		if (typeof entry !== "string") return [];
 		const dir = path.resolve(installPathsRelativeTo, pkg["install-path"] ?? `../${pkg.name}`);
 		return [{
 			name: pkg.name,
 			dir,
-			plugin: path.resolve(dir, entry)
+			plugin: path.resolve(dir, entry),
+			...resolveManifestPaths(manifest, dir)
 		}];
 	});
 }
@@ -41,12 +50,13 @@ function collectComponentPackages(installed, installPathsRelativeTo) {
 * the package itself is the app root).
 */
 function collectRootComponentPackage(composerJson, appRoot) {
-	const entry = composerJson.extra?.lattice?.plugin;
-	if (typeof entry !== "string" || typeof composerJson.name !== "string") return [];
+	const manifest = composerJson.extra?.lattice ?? {};
+	if (typeof manifest.plugin !== "string" || typeof composerJson.name !== "string") return [];
 	return [{
 		name: composerJson.name,
 		dir: appRoot,
-		plugin: path.resolve(appRoot, entry)
+		plugin: path.resolve(appRoot, manifest.plugin),
+		...resolveManifestPaths(manifest, appRoot)
 	}];
 }
 /**
@@ -84,7 +94,12 @@ function componentPackagesPlugin(packages) {
 		name: "lattice:component-packages",
 		config(config) {
 			if (packages.length === 0) return {};
-			return { server: { fs: { allow: [searchForWorkspaceRoot(config.root ?? process.cwd()), ...packages.map((pkg) => pkg.dir)] } } };
+			const workspaceRoot = searchForWorkspaceRoot(config.root ?? process.cwd());
+			const alias = Object.fromEntries(packages.flatMap((pkg) => pkg.css ? [[`@${pkg.name}/css`, pkg.css]] : []));
+			return {
+				...Object.keys(alias).length > 0 ? { resolve: { alias } } : {},
+				server: { fs: { allow: [workspaceRoot, ...packages.map((pkg) => pkg.dir)] } }
+			};
 		},
 		resolveId(id) {
 			return id === VIRTUAL_PLUGINS_ID ? RESOLVED_VIRTUAL_PLUGINS_ID : null;
@@ -102,6 +117,7 @@ function latticeConfig(options = {}) {
 			...options.source ? { alias: {
 				"@lattice-php/lattice/css": path.resolve(root, "../ui/resources/css/lattice.css"),
 				"@lattice-php/lattice": path.resolve(root, "resources/js"),
+				"@lattice-php/action": path.resolve(root, "../action/resources/js"),
 				"@lattice-php/core": path.resolve(root, "../core/resources/js"),
 				"@lattice-php/form": path.resolve(root, "../form/resources/js"),
 				"@lattice-php/table": path.resolve(root, "../table/resources/js"),
@@ -117,6 +133,7 @@ function latticeConfig(options = {}) {
 		server: options.source ? { fs: { allow: [searchForWorkspaceRoot(appRoot), root] } } : void 0,
 		test: { server: { deps: { inline: [
 			"@lattice-php/lattice",
+			"@lattice-php/action",
 			"@lattice-php/core",
 			"@lattice-php/form",
 			"@lattice-php/table",
@@ -192,7 +209,7 @@ function typescriptPlugin(options) {
 		}
 	};
 }
-function resolveIconOptions(options) {
+function resolveIconOptions(options, packages = []) {
 	const icons = options.icons ?? true;
 	if (icons === false) return null;
 	const { root } = resolveRoots(options);
@@ -204,7 +221,11 @@ function resolveIconOptions(options) {
 	};
 	return {
 		...spriteOptions,
-		iconDirs: [path.resolve(root, "../ui/resources/icons"), ...dirs],
+		iconDirs: [
+			path.resolve(root, "../ui/resources/icons"),
+			...packages.flatMap((pkg) => pkg.icons ? [pkg.icons] : []),
+			...dirs
+		],
 		...dts === false ? {} : { dts: {
 			...defaultTypes,
 			...dts

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","names":[],"sources":["../resources/js/vite.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { svgSprite } from \"@lattice-php/vite-svg-sprite\";\nimport type { IconTypesOptions, SvgSpriteOptions } from \"@lattice-php/vite-svg-sprite\";\nimport { searchForWorkspaceRoot } from \"vite\";\nimport type { Plugin, PluginOption, UserConfig } from \"vite\";\nimport { refreshTypeScriptTypes } from \"./vite-typescript-refresh.ts\";\n\ntype InlineDependency = string | RegExp;\n\ntype ConfigWithTest = UserConfig & {\n  test?: {\n    server?: {\n      deps?: {\n        inline?: InlineDependency[];\n      };\n    };\n  };\n};\n\nexport type LatticeViteIconsOptions = Omit<SvgSpriteOptions, \"dts\" | \"iconDirs\"> & {\n  dirs?: string[];\n  dts?: Partial<IconTypesOptions> | false;\n};\n\nexport type LatticeViteOptions = {\n  appRoot?: string;\n  icons?: boolean | LatticeViteIconsOptions;\n  root?: string;\n  source?: boolean;\n  /** Refresh generated TypeScript types via the dev server. Defaults to `true`. */\n  typescript?: boolean;\n};\n\ntype Roots = {\n  appRoot: string;\n  root: string;\n};\n\nexport function lattice(options: LatticeViteOptions = {}): PluginOption[] {\n  const { appRoot } = resolveRoots(options);\n  const plugins: PluginOption[] = [\n    corePlugin(options),\n    optionalPeersPlugin(),\n    componentPackagesPlugin(discoverComponentPackages(appRoot)),\n    typescriptPlugin(options),\n  ];\n  const iconOptions = resolveIconOptions(options);\n\n  if (iconOptions) {\n    plugins.push(svgSprite(iconOptions));\n  }\n\n  return plugins;\n}\n\n/** A Composer package that contributes a Lattice component plugin. */\nexport type LatticeComponentPackage = {\n  name: string;\n  /** Absolute path to the package's installed directory. */\n  dir: string;\n  /** Absolute path to the package's JS plugin entry. */\n  plugin: string;\n};\n\ntype InstalledPackage = {\n  name: string;\n  \"install-path\"?: string;\n  extra?: { lattice?: { plugin?: string } };\n};\n\ntype RootPackageJson = {\n  name?: string;\n  extra?: { lattice?: { plugin?: string } };\n};\n\n/**\n * Resolve every Composer package that declares `extra.lattice.plugin` into an\n * absolute plugin-entry path. `installPathsRelativeTo` is `vendor/composer` (the\n * dir `installed.json` records its `install-path`s against).\n */\nexport function collectComponentPackages(\n  installed: { packages?: InstalledPackage[] } | InstalledPackage[],\n  installPathsRelativeTo: string,\n): LatticeComponentPackage[] {\n  const packages = Array.isArray(installed) ? installed : (installed.packages ?? []);\n\n  return packages.flatMap((pkg) => {\n    const entry = pkg.extra?.lattice?.plugin;\n\n    if (typeof entry !== \"string\") {\n      return [];\n    }\n\n    const dir = path.resolve(installPathsRelativeTo, pkg[\"install-path\"] ?? `../${pkg.name}`);\n\n    return [{ name: pkg.name, dir, plugin: path.resolve(dir, entry) }];\n  });\n}\n\n/**\n * Resolve the composer ROOT project's own `extra.lattice.plugin` — Composer\n * never lists the root package in `installed.json`, so a component package\n * declaring the plugin entry in its own composer.json would otherwise be\n * invisible to its own dev server (e.g. inside a testbench workbench, where\n * the package itself is the app root).\n */\nexport function collectRootComponentPackage(\n  composerJson: RootPackageJson,\n  appRoot: string,\n): LatticeComponentPackage[] {\n  const entry = composerJson.extra?.lattice?.plugin;\n\n  if (typeof entry !== \"string\" || typeof composerJson.name !== \"string\") {\n    return [];\n  }\n\n  return [{ name: composerJson.name, dir: appRoot, plugin: path.resolve(appRoot, entry) }];\n}\n\n/**\n * Read `<appRoot>/vendor/composer/installed.json` and `<appRoot>/composer.json`\n * and collect every component package they contribute.\n */\nexport function discoverComponentPackages(appRoot: string): LatticeComponentPackage[] {\n  const composerDir = path.resolve(appRoot, \"vendor/composer\");\n\n  let installed: LatticeComponentPackage[] = [];\n\n  try {\n    const raw = readFileSync(path.join(composerDir, \"installed.json\"), \"utf8\");\n    installed = collectComponentPackages(JSON.parse(raw), composerDir);\n  } catch {\n    installed = [];\n  }\n\n  let root: LatticeComponentPackage[] = [];\n\n  try {\n    const raw = readFileSync(path.join(appRoot, \"composer.json\"), \"utf8\");\n    root = collectRootComponentPackage(JSON.parse(raw), appRoot);\n  } catch {\n    root = [];\n  }\n\n  return [...installed, ...root];\n}\n\nconst VIRTUAL_PLUGINS_ID = \"virtual:lattice/plugins\";\nconst RESOLVED_VIRTUAL_PLUGINS_ID = `\\0${VIRTUAL_PLUGINS_ID}`;\n\n/**\n * Exposes the discovered component packages as `virtual:lattice/plugins` — a\n * module whose default export is the array of their plugin objects,\n * ready for `extendRegistry(registry, ...plugins)`. Also grants Vite filesystem\n * access to each package dir so its source compiles from `vendor/` (or a symlink).\n */\nexport function componentPackagesPlugin(packages: LatticeComponentPackage[]): Plugin {\n  return {\n    name: \"lattice:component-packages\",\n    config(config) {\n      if (packages.length === 0) {\n        return {};\n      }\n\n      const workspaceRoot = searchForWorkspaceRoot(config.root ?? process.cwd());\n\n      return { server: { fs: { allow: [workspaceRoot, ...packages.map((pkg) => pkg.dir)] } } };\n    },\n    resolveId(id) {\n      return id === VIRTUAL_PLUGINS_ID ? RESOLVED_VIRTUAL_PLUGINS_ID : null;\n    },\n    load(id) {\n      if (id !== RESOLVED_VIRTUAL_PLUGINS_ID) {\n        return null;\n      }\n\n      const imports = packages\n        .map((pkg, index) => `import p${index} from ${JSON.stringify(pkg.plugin)};`)\n        .join(\"\\n\");\n      const list = packages.map((_, index) => `p${index}`).join(\", \");\n\n      return `${imports}\\nexport default [${list}];\\n`;\n    },\n  };\n}\n\nexport function latticeConfig(options: LatticeViteOptions = {}): ConfigWithTest {\n  const { appRoot, root } = resolveRoots(options);\n\n  return {\n    resolve: {\n      // A react alias would break SSR: Vite only externalizes bare specifiers,\n      // so an absolute path inlines react's CJS into the SSR module runner.\n      // `dedupe` alone keeps the app on a single React copy, symlinks included.\n      ...(options.source\n        ? {\n            alias: {\n              \"@lattice-php/lattice/css\": path.resolve(root, \"../ui/resources/css/lattice.css\"),\n              \"@lattice-php/lattice\": path.resolve(root, \"resources/js\"),\n              \"@lattice-php/core\": path.resolve(root, \"../core/resources/js\"),\n              \"@lattice-php/form\": path.resolve(root, \"../form/resources/js\"),\n              \"@lattice-php/table\": path.resolve(root, \"../table/resources/js\"),\n              \"@lattice-php/ui/css\": path.resolve(root, \"../ui/resources/css/lattice.css\"),\n              \"@lattice-php/ui\": path.resolve(root, \"../ui/resources/js\"),\n            },\n          }\n        : {}),\n      dedupe: [\"@inertiajs/react\", \"react\", \"react-dom\"],\n    },\n    server: options.source\n      ? {\n          fs: {\n            allow: [searchForWorkspaceRoot(appRoot), root],\n          },\n        }\n      : undefined,\n    test: {\n      server: {\n        deps: {\n          inline: [\n            \"@lattice-php/lattice\",\n            \"@lattice-php/core\",\n            \"@lattice-php/form\",\n            \"@lattice-php/table\",\n            \"@lattice-php/ui\",\n            /[/\\\\]lattice[/\\\\]dist[/\\\\]/,\n            /[/\\\\]lattice[/\\\\]node_modules[/\\\\]@radix-ui[/\\\\]/,\n            /[/\\\\]lattice[/\\\\]node_modules[/\\\\]@tiptap[/\\\\]/,\n            /[/\\\\]lattice[/\\\\]node_modules[/\\\\]react-i18next[/\\\\]/,\n          ],\n        },\n      },\n    },\n  };\n}\n\nfunction corePlugin(options: LatticeViteOptions): Plugin {\n  return {\n    name: \"lattice\",\n    config() {\n      return latticeConfig(options);\n    },\n  };\n}\n\nconst OPTIONAL_PEER_STUB_PREFIX = \"\\0lattice-optional-peer/\";\n\n/**\n * Real-time listeners statically import their optional Echo peers. A consumer\n * that never uses real-time should still build, so stub a missing peer with\n * hooks that throw — the `RealtimeListeners` error boundary then degrades\n * gracefully and warns to install the peer, exactly as when it is absent.\n */\nconst OPTIONAL_PEER_STUBS: Record<string, string> = {\n  \"@laravel/echo-react\": [\n    \"const missing = () => {\",\n    \"  throw new Error(\",\n    '    \"[lattice] Real-time listeners require @laravel/echo-react. Install it and call configureEcho().\",',\n    \"  );\",\n    \"};\",\n    \"export const useEcho = missing;\",\n    \"export const useEchoPublic = missing;\",\n    \"export const useEchoPresence = missing;\",\n    \"export const useEchoNotification = missing;\",\n  ].join(\"\\n\"),\n};\n\nfunction optionalPeersPlugin(): Plugin {\n  return {\n    name: \"lattice:optional-peers\",\n    enforce: \"pre\",\n    async resolveId(id) {\n      if (!Object.prototype.hasOwnProperty.call(OPTIONAL_PEER_STUBS, id)) {\n        return null;\n      }\n\n      const installed = await this.resolve(id, undefined, { skipSelf: true });\n\n      return installed ? null : `${OPTIONAL_PEER_STUB_PREFIX}${id}`;\n    },\n    load(id) {\n      if (!id.startsWith(OPTIONAL_PEER_STUB_PREFIX)) {\n        return null;\n      }\n\n      return OPTIONAL_PEER_STUBS[id.slice(OPTIONAL_PEER_STUB_PREFIX.length)] ?? null;\n    },\n  };\n}\n\n/**\n * Refreshes `node.props` typings from the app's own `php artisan\n * lattice:typescript` whenever the dev server starts — installing or updating\n * a component package would otherwise leave its generated types stale until\n * someone remembers to run the command by hand. Dev-server only: a production\n * build machine may not have PHP installed, and the generated file is a dev\n * ergonomics artifact, not a build input.\n *\n * Module-private like its siblings `optionalPeersPlugin`/`corePlugin` — the\n * `refreshTypeScriptTypes` DI seam it defers to lives in\n * `./vite-typescript-refresh`, which isn't part of the published `vite`\n * subpath either (see that module for why).\n */\nfunction typescriptPlugin(options: LatticeViteOptions): Plugin {\n  return {\n    name: \"lattice:typescript\",\n    apply: \"serve\",\n    configureServer(server) {\n      const typescript = options.typescript ?? true;\n\n      if (typescript === false) {\n        return;\n      }\n\n      const { appRoot } = resolveRoots(options);\n\n      refreshTypeScriptTypes(appRoot, server.config.logger);\n    },\n  };\n}\n\nexport function resolveIconOptions(options: LatticeViteOptions): SvgSpriteOptions | null {\n  const icons = options.icons ?? true;\n\n  if (icons === false) {\n    return null;\n  }\n\n  const { root } = resolveRoots(options);\n  const iconOptions = icons === true ? {} : icons;\n  const { dirs = [], dts, ...spriteOptions } = iconOptions;\n  const defaultTypes = {\n    file: \"resources/js/types/sprite-icons.ts\",\n    augmentModule: \"@lattice-php/ui\",\n    augmentInterface: \"KnownIcons\",\n  };\n\n  return {\n    ...spriteOptions,\n    iconDirs: [path.resolve(root, \"../ui/resources/icons\"), ...dirs],\n    ...(dts === false ? {} : { dts: { ...defaultTypes, ...dts } }),\n  };\n}\n\nfunction resolveRoots(options: LatticeViteOptions): Roots {\n  const appRoot = options.appRoot ?? process.cwd();\n  const root = options.root ?? path.resolve(appRoot, \"vendor/lattice-php/lattice\");\n\n  return { appRoot, root };\n}\n"],"mappings":";;;;;;AAuCA,SAAgB,QAAQ,UAA8B,CAAC,GAAmB;CACxE,MAAM,EAAE,YAAY,aAAa,OAAO;CACxC,MAAM,UAA0B;EAC9B,WAAW,OAAO;EAClB,oBAAoB;EACpB,wBAAwB,0BAA0B,OAAO,CAAC;EAC1D,iBAAiB,OAAO;CAC1B;CACA,MAAM,cAAc,mBAAmB,OAAO;CAE9C,IAAI,aACF,QAAQ,KAAK,UAAU,WAAW,CAAC;CAGrC,OAAO;AACT;;;;;;AA2BA,SAAgB,yBACd,WACA,wBAC2B;CAG3B,QAFiB,MAAM,QAAQ,SAAS,IAAI,YAAa,UAAU,YAAY,CAAC,EAAA,CAEhE,SAAS,QAAQ;EAC/B,MAAM,QAAQ,IAAI,OAAO,SAAS;EAElC,IAAI,OAAO,UAAU,UACnB,OAAO,CAAC;EAGV,MAAM,MAAM,KAAK,QAAQ,wBAAwB,IAAI,mBAAmB,MAAM,IAAI,MAAM;EAExF,OAAO,CAAC;GAAE,MAAM,IAAI;GAAM;GAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK;EAAE,CAAC;CACnE,CAAC;AACH;;;;;;;;AASA,SAAgB,4BACd,cACA,SAC2B;CAC3B,MAAM,QAAQ,aAAa,OAAO,SAAS;CAE3C,IAAI,OAAO,UAAU,YAAY,OAAO,aAAa,SAAS,UAC5D,OAAO,CAAC;CAGV,OAAO,CAAC;EAAE,MAAM,aAAa;EAAM,KAAK;EAAS,QAAQ,KAAK,QAAQ,SAAS,KAAK;CAAE,CAAC;AACzF;;;;;AAMA,SAAgB,0BAA0B,SAA4C;CACpF,MAAM,cAAc,KAAK,QAAQ,SAAS,iBAAiB;CAE3D,IAAI,YAAuC,CAAC;CAE5C,IAAI;EACF,MAAM,MAAM,aAAa,KAAK,KAAK,aAAa,gBAAgB,GAAG,MAAM;EACzE,YAAY,yBAAyB,KAAK,MAAM,GAAG,GAAG,WAAW;CACnE,QAAQ;EACN,YAAY,CAAC;CACf;CAEA,IAAI,OAAkC,CAAC;CAEvC,IAAI;EACF,MAAM,MAAM,aAAa,KAAK,KAAK,SAAS,eAAe,GAAG,MAAM;EACpE,OAAO,4BAA4B,KAAK,MAAM,GAAG,GAAG,OAAO;CAC7D,QAAQ;EACN,OAAO,CAAC;CACV;CAEA,OAAO,CAAC,GAAG,WAAW,GAAG,IAAI;AAC/B;AAEA,IAAM,qBAAqB;AAC3B,IAAM,8BAA8B,KAAK;;;;;;;AAQzC,SAAgB,wBAAwB,UAA6C;CACnF,OAAO;EACL,MAAM;EACN,OAAO,QAAQ;GACb,IAAI,SAAS,WAAW,GACtB,OAAO,CAAC;GAKV,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAFV,uBAAuB,OAAO,QAAQ,QAAQ,IAAI,CAEvC,GAAe,GAAG,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,EAAE,EAAE;EACzF;EACA,UAAU,IAAI;GACZ,OAAO,OAAO,qBAAqB,8BAA8B;EACnE;EACA,KAAK,IAAI;GACP,IAAI,OAAO,6BACT,OAAO;GAQT,OAAO,GALS,SACb,KAAK,KAAK,UAAU,WAAW,MAAM,QAAQ,KAAK,UAAU,IAAI,MAAM,EAAE,EAAE,CAAC,CAC3E,KAAK,IAGE,EAAQ,oBAFL,SAAS,KAAK,GAAG,UAAU,IAAI,OAAO,CAAC,CAAC,KAAK,IAEpB,EAAK;EAC7C;CACF;AACF;AAEA,SAAgB,cAAc,UAA8B,CAAC,GAAmB;CAC9E,MAAM,EAAE,SAAS,SAAS,aAAa,OAAO;CAE9C,OAAO;EACL,SAAS;GAIP,GAAI,QAAQ,SACR,EACE,OAAO;IACL,4BAA4B,KAAK,QAAQ,MAAM,iCAAiC;IAChF,wBAAwB,KAAK,QAAQ,MAAM,cAAc;IACzD,qBAAqB,KAAK,QAAQ,MAAM,sBAAsB;IAC9D,qBAAqB,KAAK,QAAQ,MAAM,sBAAsB;IAC9D,sBAAsB,KAAK,QAAQ,MAAM,uBAAuB;IAChE,uBAAuB,KAAK,QAAQ,MAAM,iCAAiC;IAC3E,mBAAmB,KAAK,QAAQ,MAAM,oBAAoB;GAC5D,EACF,IACA,CAAC;GACL,QAAQ;IAAC;IAAoB;IAAS;GAAW;EACnD;EACA,QAAQ,QAAQ,SACZ,EACE,IAAI,EACF,OAAO,CAAC,uBAAuB,OAAO,GAAG,IAAI,EAC/C,EACF,IACA,KAAA;EACJ,MAAM,EACJ,QAAQ,EACN,MAAM,EACJ,QAAQ;GACN;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,EACF,EACF,EACF;CACF;AACF;AAEA,SAAS,WAAW,SAAqC;CACvD,OAAO;EACL,MAAM;EACN,SAAS;GACP,OAAO,cAAc,OAAO;EAC9B;CACF;AACF;AAEA,IAAM,4BAA4B;;;;;;;AAQlC,IAAM,sBAA8C,EAClD,uBAAuB;CACrB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI,EACb;AAEA,SAAS,sBAA8B;CACrC,OAAO;EACL,MAAM;EACN,SAAS;EACT,MAAM,UAAU,IAAI;GAClB,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,qBAAqB,EAAE,GAC/D,OAAO;GAKT,OAAO,MAFiB,KAAK,QAAQ,IAAI,KAAA,GAAW,EAAE,UAAU,KAAK,CAAC,IAEnD,OAAO,GAAG,4BAA4B;EAC3D;EACA,KAAK,IAAI;GACP,IAAI,CAAC,GAAG,WAAW,yBAAyB,GAC1C,OAAO;GAGT,OAAO,oBAAoB,GAAG,MAAM,EAAgC,MAAM;EAC5E;CACF;AACF;;;;;;;;;;;;;;AAeA,SAAS,iBAAiB,SAAqC;CAC7D,OAAO;EACL,MAAM;EACN,OAAO;EACP,gBAAgB,QAAQ;GAGtB,KAFmB,QAAQ,cAAc,UAEtB,OACjB;GAGF,MAAM,EAAE,YAAY,aAAa,OAAO;GAExC,uBAAuB,SAAS,OAAO,OAAO,MAAM;EACtD;CACF;AACF;AAEA,SAAgB,mBAAmB,SAAsD;CACvF,MAAM,QAAQ,QAAQ,SAAS;CAE/B,IAAI,UAAU,OACZ,OAAO;CAGT,MAAM,EAAE,SAAS,aAAa,OAAO;CAErC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,GAAG,kBADP,UAAU,OAAO,CAAC,IAAI;CAE1C,MAAM,eAAe;EACnB,MAAM;EACN,eAAe;EACf,kBAAkB;CACpB;CAEA,OAAO;EACL,GAAG;EACH,UAAU,CAAC,KAAK,QAAQ,MAAM,uBAAuB,GAAG,GAAG,IAAI;EAC/D,GAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,KAAK;GAAE,GAAG;GAAc,GAAG;EAAI,EAAE;CAC9D;AACF;AAEA,SAAS,aAAa,SAAoC;CACxD,MAAM,UAAU,QAAQ,WAAW,QAAQ,IAAI;CAG/C,OAAO;EAAE;EAAS,MAFL,QAAQ,QAAQ,KAAK,QAAQ,SAAS,4BAA4B;CAExD;AACzB"}
+{"version":3,"file":"vite.js","names":[],"sources":["../resources/js/vite.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { svgSprite } from \"@lattice-php/vite-svg-sprite\";\nimport type { IconTypesOptions, SvgSpriteOptions } from \"@lattice-php/vite-svg-sprite\";\nimport { searchForWorkspaceRoot } from \"vite\";\nimport type { Plugin, PluginOption, UserConfig } from \"vite\";\nimport { refreshTypeScriptTypes } from \"./vite-typescript-refresh.ts\";\n\ntype InlineDependency = string | RegExp;\n\ntype ConfigWithTest = UserConfig & {\n  test?: {\n    server?: {\n      deps?: {\n        inline?: InlineDependency[];\n      };\n    };\n  };\n};\n\nexport type LatticeViteIconsOptions = Omit<SvgSpriteOptions, \"dts\" | \"iconDirs\"> & {\n  dirs?: string[];\n  dts?: Partial<IconTypesOptions> | false;\n};\n\nexport type LatticeViteOptions = {\n  appRoot?: string;\n  icons?: boolean | LatticeViteIconsOptions;\n  root?: string;\n  source?: boolean;\n  /** Refresh generated TypeScript types via the dev server. Defaults to `true`. */\n  typescript?: boolean;\n};\n\ntype Roots = {\n  appRoot: string;\n  root: string;\n};\n\nexport function lattice(options: LatticeViteOptions = {}): PluginOption[] {\n  const { appRoot } = resolveRoots(options);\n  const packages = discoverComponentPackages(appRoot);\n  const plugins: PluginOption[] = [\n    corePlugin(options),\n    optionalPeersPlugin(),\n    componentPackagesPlugin(packages),\n    typescriptPlugin(options),\n  ];\n  const iconOptions = resolveIconOptions(options, packages);\n\n  if (iconOptions) {\n    plugins.push(svgSprite(iconOptions));\n  }\n\n  return plugins;\n}\n\n/** A Composer package that contributes a Lattice component plugin. */\nexport type LatticeComponentPackage = {\n  name: string;\n  /** Absolute path to the package's installed directory. */\n  dir: string;\n  /** Absolute path to the package's JS plugin entry. */\n  plugin: string;\n  /** Absolute path to the package's stylesheet, when it declares one. */\n  css?: string;\n  /** Absolute path to the package's icon directory, when it declares one. */\n  icons?: string;\n};\n\ntype LatticeManifest = { plugin?: string; css?: string; icons?: string };\n\ntype InstalledPackage = {\n  name: string;\n  \"install-path\"?: string;\n  extra?: { lattice?: LatticeManifest };\n};\n\ntype RootPackageJson = {\n  name?: string;\n  extra?: { lattice?: LatticeManifest };\n};\n\nfunction resolveManifestPaths(\n  manifest: LatticeManifest,\n  dir: string,\n): Pick<LatticeComponentPackage, \"css\" | \"icons\"> {\n  return {\n    ...(typeof manifest.css === \"string\" ? { css: path.resolve(dir, manifest.css) } : {}),\n    ...(typeof manifest.icons === \"string\" ? { icons: path.resolve(dir, manifest.icons) } : {}),\n  };\n}\n\n/**\n * Resolve every Composer package that declares `extra.lattice.plugin` into an\n * absolute plugin-entry path. `installPathsRelativeTo` is `vendor/composer` (the\n * dir `installed.json` records its `install-path`s against).\n */\nexport function collectComponentPackages(\n  installed: { packages?: InstalledPackage[] } | InstalledPackage[],\n  installPathsRelativeTo: string,\n): LatticeComponentPackage[] {\n  const packages = Array.isArray(installed) ? installed : (installed.packages ?? []);\n\n  return packages.flatMap((pkg) => {\n    const manifest = pkg.extra?.lattice ?? {};\n    const entry = manifest.plugin;\n\n    if (typeof entry !== \"string\") {\n      return [];\n    }\n\n    const dir = path.resolve(installPathsRelativeTo, pkg[\"install-path\"] ?? `../${pkg.name}`);\n\n    return [\n      {\n        name: pkg.name,\n        dir,\n        plugin: path.resolve(dir, entry),\n        ...resolveManifestPaths(manifest, dir),\n      },\n    ];\n  });\n}\n\n/**\n * Resolve the composer ROOT project's own `extra.lattice.plugin` — Composer\n * never lists the root package in `installed.json`, so a component package\n * declaring the plugin entry in its own composer.json would otherwise be\n * invisible to its own dev server (e.g. inside a testbench workbench, where\n * the package itself is the app root).\n */\nexport function collectRootComponentPackage(\n  composerJson: RootPackageJson,\n  appRoot: string,\n): LatticeComponentPackage[] {\n  const manifest = composerJson.extra?.lattice ?? {};\n\n  if (typeof manifest.plugin !== \"string\" || typeof composerJson.name !== \"string\") {\n    return [];\n  }\n\n  return [\n    {\n      name: composerJson.name,\n      dir: appRoot,\n      plugin: path.resolve(appRoot, manifest.plugin),\n      ...resolveManifestPaths(manifest, appRoot),\n    },\n  ];\n}\n\n/**\n * Read `<appRoot>/vendor/composer/installed.json` and `<appRoot>/composer.json`\n * and collect every component package they contribute.\n */\nexport function discoverComponentPackages(appRoot: string): LatticeComponentPackage[] {\n  const composerDir = path.resolve(appRoot, \"vendor/composer\");\n\n  let installed: LatticeComponentPackage[] = [];\n\n  try {\n    const raw = readFileSync(path.join(composerDir, \"installed.json\"), \"utf8\");\n    installed = collectComponentPackages(JSON.parse(raw), composerDir);\n  } catch {\n    installed = [];\n  }\n\n  let root: LatticeComponentPackage[] = [];\n\n  try {\n    const raw = readFileSync(path.join(appRoot, \"composer.json\"), \"utf8\");\n    root = collectRootComponentPackage(JSON.parse(raw), appRoot);\n  } catch {\n    root = [];\n  }\n\n  return [...installed, ...root];\n}\n\nconst VIRTUAL_PLUGINS_ID = \"virtual:lattice/plugins\";\nconst RESOLVED_VIRTUAL_PLUGINS_ID = `\\0${VIRTUAL_PLUGINS_ID}`;\n\n/**\n * Exposes the discovered component packages as `virtual:lattice/plugins` — a\n * module whose default export is the array of their plugin objects,\n * ready for `extendRegistry(registry, ...plugins)`. Also grants Vite filesystem\n * access to each package dir so its source compiles from `vendor/` (or a symlink).\n */\nexport function componentPackagesPlugin(packages: LatticeComponentPackage[]): Plugin {\n  return {\n    name: \"lattice:component-packages\",\n    config(config) {\n      if (packages.length === 0) {\n        return {};\n      }\n\n      const workspaceRoot = searchForWorkspaceRoot(config.root ?? process.cwd());\n      // Vite's mergeAlias puts plugin-config aliases in front of the user config's,\n      // so this specific `/css` alias wins over a user's broader package-dir alias.\n      const alias = Object.fromEntries(\n        packages.flatMap((pkg) => (pkg.css ? [[`@${pkg.name}/css`, pkg.css]] : [])),\n      );\n\n      return {\n        ...(Object.keys(alias).length > 0 ? { resolve: { alias } } : {}),\n        server: { fs: { allow: [workspaceRoot, ...packages.map((pkg) => pkg.dir)] } },\n      };\n    },\n    resolveId(id) {\n      return id === VIRTUAL_PLUGINS_ID ? RESOLVED_VIRTUAL_PLUGINS_ID : null;\n    },\n    load(id) {\n      if (id !== RESOLVED_VIRTUAL_PLUGINS_ID) {\n        return null;\n      }\n\n      const imports = packages\n        .map((pkg, index) => `import p${index} from ${JSON.stringify(pkg.plugin)};`)\n        .join(\"\\n\");\n      const list = packages.map((_, index) => `p${index}`).join(\", \");\n\n      return `${imports}\\nexport default [${list}];\\n`;\n    },\n  };\n}\n\nexport function latticeConfig(options: LatticeViteOptions = {}): ConfigWithTest {\n  const { appRoot, root } = resolveRoots(options);\n\n  return {\n    resolve: {\n      // A react alias would break SSR: Vite only externalizes bare specifiers,\n      // so an absolute path inlines react's CJS into the SSR module runner.\n      // `dedupe` alone keeps the app on a single React copy, symlinks included.\n      ...(options.source\n        ? {\n            alias: {\n              \"@lattice-php/lattice/css\": path.resolve(root, \"../ui/resources/css/lattice.css\"),\n              \"@lattice-php/lattice\": path.resolve(root, \"resources/js\"),\n              \"@lattice-php/action\": path.resolve(root, \"../action/resources/js\"),\n              \"@lattice-php/core\": path.resolve(root, \"../core/resources/js\"),\n              \"@lattice-php/form\": path.resolve(root, \"../form/resources/js\"),\n              \"@lattice-php/table\": path.resolve(root, \"../table/resources/js\"),\n              \"@lattice-php/ui/css\": path.resolve(root, \"../ui/resources/css/lattice.css\"),\n              \"@lattice-php/ui\": path.resolve(root, \"../ui/resources/js\"),\n            },\n          }\n        : {}),\n      dedupe: [\"@inertiajs/react\", \"react\", \"react-dom\"],\n    },\n    server: options.source\n      ? {\n          fs: {\n            allow: [searchForWorkspaceRoot(appRoot), root],\n          },\n        }\n      : undefined,\n    test: {\n      server: {\n        deps: {\n          inline: [\n            \"@lattice-php/lattice\",\n            \"@lattice-php/action\",\n            \"@lattice-php/core\",\n            \"@lattice-php/form\",\n            \"@lattice-php/table\",\n            \"@lattice-php/ui\",\n            /[/\\\\]lattice[/\\\\]dist[/\\\\]/,\n            /[/\\\\]lattice[/\\\\]node_modules[/\\\\]@radix-ui[/\\\\]/,\n            /[/\\\\]lattice[/\\\\]node_modules[/\\\\]@tiptap[/\\\\]/,\n            /[/\\\\]lattice[/\\\\]node_modules[/\\\\]react-i18next[/\\\\]/,\n          ],\n        },\n      },\n    },\n  };\n}\n\nfunction corePlugin(options: LatticeViteOptions): Plugin {\n  return {\n    name: \"lattice\",\n    config() {\n      return latticeConfig(options);\n    },\n  };\n}\n\nconst OPTIONAL_PEER_STUB_PREFIX = \"\\0lattice-optional-peer/\";\n\n/**\n * Real-time listeners statically import their optional Echo peers. A consumer\n * that never uses real-time should still build, so stub a missing peer with\n * hooks that throw — the `RealtimeListeners` error boundary then degrades\n * gracefully and warns to install the peer, exactly as when it is absent.\n */\nconst OPTIONAL_PEER_STUBS: Record<string, string> = {\n  \"@laravel/echo-react\": [\n    \"const missing = () => {\",\n    \"  throw new Error(\",\n    '    \"[lattice] Real-time listeners require @laravel/echo-react. Install it and call configureEcho().\",',\n    \"  );\",\n    \"};\",\n    \"export const useEcho = missing;\",\n    \"export const useEchoPublic = missing;\",\n    \"export const useEchoPresence = missing;\",\n    \"export const useEchoNotification = missing;\",\n  ].join(\"\\n\"),\n};\n\nfunction optionalPeersPlugin(): Plugin {\n  return {\n    name: \"lattice:optional-peers\",\n    enforce: \"pre\",\n    async resolveId(id) {\n      if (!Object.prototype.hasOwnProperty.call(OPTIONAL_PEER_STUBS, id)) {\n        return null;\n      }\n\n      const installed = await this.resolve(id, undefined, { skipSelf: true });\n\n      return installed ? null : `${OPTIONAL_PEER_STUB_PREFIX}${id}`;\n    },\n    load(id) {\n      if (!id.startsWith(OPTIONAL_PEER_STUB_PREFIX)) {\n        return null;\n      }\n\n      return OPTIONAL_PEER_STUBS[id.slice(OPTIONAL_PEER_STUB_PREFIX.length)] ?? null;\n    },\n  };\n}\n\n/**\n * Refreshes `node.props` typings from the app's own `php artisan\n * lattice:typescript` whenever the dev server starts — installing or updating\n * a component package would otherwise leave its generated types stale until\n * someone remembers to run the command by hand. Dev-server only: a production\n * build machine may not have PHP installed, and the generated file is a dev\n * ergonomics artifact, not a build input.\n *\n * Module-private like its siblings `optionalPeersPlugin`/`corePlugin` — the\n * `refreshTypeScriptTypes` DI seam it defers to lives in\n * `./vite-typescript-refresh`, which isn't part of the published `vite`\n * subpath either (see that module for why).\n */\nfunction typescriptPlugin(options: LatticeViteOptions): Plugin {\n  return {\n    name: \"lattice:typescript\",\n    apply: \"serve\",\n    configureServer(server) {\n      const typescript = options.typescript ?? true;\n\n      if (typescript === false) {\n        return;\n      }\n\n      const { appRoot } = resolveRoots(options);\n\n      refreshTypeScriptTypes(appRoot, server.config.logger);\n    },\n  };\n}\n\nexport function resolveIconOptions(\n  options: LatticeViteOptions,\n  packages: LatticeComponentPackage[] = [],\n): SvgSpriteOptions | null {\n  const icons = options.icons ?? true;\n\n  if (icons === false) {\n    return null;\n  }\n\n  const { root } = resolveRoots(options);\n  const iconOptions = icons === true ? {} : icons;\n  const { dirs = [], dts, ...spriteOptions } = iconOptions;\n  const defaultTypes = {\n    file: \"resources/js/types/sprite-icons.ts\",\n    augmentModule: \"@lattice-php/ui\",\n    augmentInterface: \"KnownIcons\",\n  };\n\n  return {\n    ...spriteOptions,\n    iconDirs: [\n      path.resolve(root, \"../ui/resources/icons\"),\n      ...packages.flatMap((pkg) => (pkg.icons ? [pkg.icons] : [])),\n      ...dirs,\n    ],\n    ...(dts === false ? {} : { dts: { ...defaultTypes, ...dts } }),\n  };\n}\n\nfunction resolveRoots(options: LatticeViteOptions): Roots {\n  const appRoot = options.appRoot ?? process.cwd();\n  const root = options.root ?? path.resolve(appRoot, \"vendor/lattice-php/lattice\");\n\n  return { appRoot, root };\n}\n"],"mappings":"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"}