@lattice-php/lattice 0.3.0 → 0.5.0

package/dist/types/generated.d.ts

@@ -1,6 +1,5 @@
 export type Action = {
     confirmation: Confirmation | null;
-    effects: Effect[];
     endpoint: string | null;
     form: Node | null;
     icon: string | null;
@@ -37,6 +36,10 @@ export type ActionResult = {
     readonly data: Record<string, unknown>;
     readonly effects: Effect[];
 };
+export type Affix = {
+    readonly icon: string | null;
+    readonly text: string | null;
+};
 export type Align = "center" | "left" | "start" | "stretch";
 export type Badge = {
     label: string;
@@ -46,6 +49,13 @@ export type BadgeColumn = {
 };
 export type BooleanColumn = Record<string, never>;
 export type Breadcrumbs = Record<string, never>;
+export type BrowserToken = {
+    readonly accessToken: string;
+    readonly tokenType: string;
+    readonly expiresIn: number;
+    readonly audience: string;
+    readonly scopes: string[];
+};
 export type Builder = {
     addLabel: string | null;
     columnWidth: ColumnWidth;
@@ -80,7 +90,6 @@ export type Builder = {
 };
 export type BulkAction = {
     confirmation: Confirmation | null;
-    effects: Effect[];
     endpoint: string | null;
     form: Node | null;
     icon: string | null;
@@ -92,7 +101,9 @@ export type BulkAction = {
 };
 export type Button = {
     buttonType: ButtonType;
+    effects: Effect[];
     href: string | null;
+    icon: string | null;
     label: string;
     variant: ButtonVariant | null;
 };
@@ -113,6 +124,7 @@ export type Card = {
     description: string | null;
     title: string | null;
 };
+export type ChannelVisibility = "public" | "private" | "presence";
 export type Chart = {
     categoryKey: string | null;
     data: Record<string, unknown>[];
@@ -136,19 +148,23 @@ export type ChartSeries = {
 };
 export type ChartSeriesType = "area" | "bar" | "line" | "pie";
 export type ChatBox = {
-    conversationId: string | null;
     fill: boolean;
     historyEndpoint: string | null;
     placeholder: string | null;
+    remote: RemoteAccess | null;
     streamEndpoint: string | null;
     title: string | null;
 };
 export type ChatMessage = {
     readonly id: string;
     readonly role: ChatRole;
-    readonly parts: ChatNode[];
+    readonly parts: Node[];
 };
 export type ChatNode = {
+    type: "chat.box";
+    key?: string;
+    props: ChatBox;
+} | {
     type: "chat.part.text";
     key?: string;
     props: TextPart;
@@ -234,6 +250,16 @@ export type ColumnFilter = {
     readonly options: Option[];
     readonly multiple: boolean;
     readonly searchable: boolean;
+    readonly clauseOptions?: ColumnFilterOption[];
+};
+export type ColumnFilterOption = {
+    readonly label: string;
+    readonly value: string;
+    readonly clauses: ColumnFilterOptionClause[];
+};
+export type ColumnFilterOptionClause = {
+    readonly operator: Op;
+    readonly value: string;
 };
 export type ColumnPropsMap = {
     "column.badge": BadgeColumn;
@@ -274,10 +300,6 @@ export type CoreNode = {
     type: "chart";
     key?: string;
     props: Chart;
-} | {
-    type: "chat.box";
-    key?: string;
-    props: ChatBox;
 } | {
     type: "floating-panel";
     key?: string;
@@ -339,6 +361,11 @@ export type CoreNode = {
     key?: string;
     props: Text;
 };
+export type DataList = {
+    dataEndpoint: string | null;
+    emptyLabel: string | null;
+    remote: RemoteAccess | null;
+};
 export type DateInput = {
     autoFocus: boolean;
     columnWidth: ColumnWidth;
@@ -393,9 +420,10 @@ export type Effect = ({
     type: "resetForm";
 } & ResetFormEffect) | ({
     type: "toast";
-} & ToastEffect);
-export type EffectType = "toast" | "callout" | "reloadComponent" | "reloadPage" | "redirect" | "download" | "openModal" | "closeModal" | "resetForm" | "localeChange";
-export type FieldType = "field.builder" | "field.checkbox" | "field.choice" | "field.date-input" | "field.file-upload" | "field.hidden-input" | "field.number-input" | "field.password-input" | "field.repeater" | "field.rich-editor" | "field.select" | "field.textarea" | "field.text-input";
+} & ToastEffect) | ({
+    type: "toggleSidebar";
+} & ToggleSidebarEffect);
+export type FieldType = "field.builder" | "field.checkbox" | "field.choice" | "field.date-input" | "field.file-upload" | "field.hidden-input" | "field.number-input" | "field.otp" | "field.password-input" | "field.repeater" | "field.rich-editor" | "field.select" | "field.textarea" | "field.text-input";
 export type FileUpload = {
     accept: string | null;
     columnWidth: ColumnWidth;
@@ -495,6 +523,10 @@ export type FormFieldNode = {
     type: "field.number-input";
     key?: string;
     props: NumberInput;
+} | {
+    type: "field.otp";
+    key?: string;
+    props: OtpInput;
 } | {
     type: "field.password-input";
     key?: string;
@@ -628,6 +660,11 @@ export type LayoutNode = {
     key?: string;
     props: Sidebar;
     schema?: Node[];
+} | {
+    type: "topbar";
+    key?: string;
+    props: Topbar;
+    schema?: Node[];
 };
 export type Link = {
     href: string | null;
@@ -635,6 +672,12 @@ export type Link = {
     method: HttpMethod | null;
     tabIndex: number | null;
 };
+export type ListenerPayload = {
+    readonly channel: string;
+    readonly visibility: ChannelVisibility;
+    readonly events: string[];
+    readonly effects: Effect[];
+};
 export type LocaleChangeEffect = {
     readonly locale: string;
 };
@@ -644,6 +687,8 @@ export type MenuItem = {
     icon: string | null;
     label: string;
     method: HttpMethod | null;
+    prefix: Affix | null;
+    suffix: Affix | null;
 };
 export type Modal = {
     closeLabel: string;
@@ -658,7 +703,7 @@ export type MoneyColumn = {
     maximumFractionDigits: number | null;
     minimumFractionDigits: number | null;
 };
-export type Node = FormNode | CoreNode | ActionNode | FragmentNode | TableNode | LayoutNode | ChatNode;
+export type Node = FormNode | CoreNode | ActionNode | FragmentNode | RemoteNode | TableNode | LayoutNode | ChatNode;
 export type NodeType = Node["type"];
 export type NumberColumn = {
     maximumFractionDigits: number | null;
@@ -688,10 +733,12 @@ export type NumberInput = {
     placeholder: string | null;
     prefillRefreshOn: string[] | null;
     prefillResetOn: string[] | null;
+    prefix: Affix | null;
     readOnly: boolean;
     required: boolean;
     slider: boolean;
     step: number | null;
+    suffix: Affix | null;
     tabIndex: number | null;
     tooltip: string | null;
     value: unknown;
@@ -705,6 +752,31 @@ export type Option = {
     readonly value: string;
 };
 export type Orientation = "horizontal" | "vertical";
+export type OtpInput = {
+    autoFocus: boolean;
+    columnWidth: ColumnWidth;
+    conditions: {
+        visible?: Condition[];
+        required?: Condition[];
+        readOnly?: Condition[];
+        disabled?: Condition[];
+    } | null;
+    dependsOnAny: boolean;
+    dependsOnKeys: string[] | null;
+    disabled: boolean;
+    editablePrefill: boolean;
+    helperText: string | null;
+    hidden: boolean;
+    label: string | null;
+    length: number;
+    name: string;
+    prefillRefreshOn: string[] | null;
+    prefillResetOn: string[] | null;
+    readOnly: boolean;
+    required: boolean;
+    tooltip: string | null;
+    value: unknown;
+};
 export type Outlet = Record<string, never>;
 export type PageContainer = "centered" | "default";
 export type PageLayout = "app" | "auth" | "none";
@@ -741,8 +813,10 @@ export type PasswordInput = {
     placeholder: string | null;
     prefillRefreshOn: string[] | null;
     prefillResetOn: string[] | null;
+    prefix: Affix | null;
     readOnly: boolean;
     required: boolean;
+    suffix: Affix | null;
     tabIndex: number | null;
     tooltip: string | null;
     value: unknown;
@@ -758,6 +832,21 @@ export type ReloadComponentEffect = {
     readonly component: string;
 };
 export type ReloadPageEffect = object;
+export type RemoteAccess = {
+    readonly source: string;
+    readonly audience: string;
+    readonly scopes: string[];
+    readonly nodeId: string;
+    readonly nodeType: string;
+    readonly tokenEndpoint: string;
+    readonly ref: string;
+};
+export type RemoteNode = {
+    type: "remote.data-list";
+    key?: string;
+    props: DataList;
+    schema?: Node[];
+};
 export type Repeater = {
     addLabel: string | null;
     columnWidth: ColumnWidth;
@@ -873,6 +962,7 @@ export type Select = {
     tooltip: string | null;
     value: unknown;
 };
+export type Side = "start" | "end";
 export type Sidebar = {
     collapsible: boolean;
     rememberState: boolean;
@@ -882,6 +972,7 @@ export type SortDirection = "asc" | "desc";
 export type Stack = {
     align: Align | null;
     direction: string | null;
+    float: Side | null;
     gap: Gap | null;
     height: Height | null;
     justify: Justify | null;
@@ -951,6 +1042,9 @@ export type Text = {
     text: string;
 };
 export type TextColumn = {
+    badge: {
+        colorKey: string;
+    } | null;
     copyable: boolean;
     date: {
         format: string | null;
@@ -959,6 +1053,7 @@ export type TextColumn = {
         href: string | null;
         external: boolean;
     } | null;
+    multiple: string | null;
 };
 export type TextInput = {
     autoComplete: string | null;
@@ -981,8 +1076,10 @@ export type TextInput = {
     placeholder: string | null;
     prefillRefreshOn: string[] | null;
     prefillResetOn: string[] | null;
+    prefix: Affix | null;
     readOnly: boolean;
     required: boolean;
+    suffix: Affix | null;
     tabIndex: number | null;
     tooltip: string | null;
     type: string | null;
@@ -1027,11 +1124,22 @@ export type ToastMessage = {
     dismissible: boolean;
     action: Node | null;
     variant: Variant;
-    message: string;
+    message: Translatable | string;
+};
+export type ToggleSidebarEffect = {
+    readonly target: string | null;
 };
 export type ToolCallPart = {
     args: Record<string, unknown>;
     name: string;
 };
+export type Topbar = {
+    sticky: boolean;
+};
+export type Translatable = {
+    payload: Record<string, string>;
+    replacements: Record<string, string | number | boolean>;
+    key: string;
+};
 export type Variant = "success" | "info" | "warning" | "error";
-export type Width = "full" | "sm" | "md" | "lg" | "fill";
+export type Width = "full" | "auto" | "sm" | "md" | "lg" | "fill";

package/dist/vite.js

@@ -3,7 +3,7 @@ import { svgSprite } from "@lattice-php/vite-svg-sprite";
 import { searchForWorkspaceRoot } from "vite";
 //#region resources/js/vite.ts
 function lattice(options = {}) {
-	const plugins = [corePlugin(options)];
+	const plugins = [corePlugin(options), optionalPeersPlugin()];
 	const iconOptions = resolveIconOptions(options);
 	if (iconOptions) plugins.push(svgSprite(iconOptions));
 	return plugins;
@@ -43,6 +43,37 @@ function corePlugin(options) {
 		}
 	};
 }
+var OPTIONAL_PEER_STUB_PREFIX = "\0lattice-optional-peer/";
+/**
+* Real-time listeners statically import their optional Echo peers. A consumer
+* that never uses real-time should still build, so stub a missing peer with
+* hooks that throw — the `RealtimeListeners` error boundary then degrades
+* gracefully and warns to install the peer, exactly as when it is absent.
+*/
+var OPTIONAL_PEER_STUBS = { "@laravel/echo-react": [
+	"const missing = () => {",
+	"  throw new Error(",
+	"    \"[lattice] Real-time listeners require @laravel/echo-react. Install it and call configureEcho().\",",
+	"  );",
+	"};",
+	"export const useEcho = missing;",
+	"export const useEchoPublic = missing;",
+	"export const useEchoPresence = missing;"
+].join("\n") };
+function optionalPeersPlugin() {
+	return {
+		name: "lattice:optional-peers",
+		enforce: "pre",
+		async resolveId(id) {
+			if (!Object.prototype.hasOwnProperty.call(OPTIONAL_PEER_STUBS, id)) return null;
+			return await this.resolve(id, void 0, { skipSelf: true }) ? null : `${OPTIONAL_PEER_STUB_PREFIX}${id}`;
+		},
+		load(id) {
+			if (!id.startsWith(OPTIONAL_PEER_STUB_PREFIX)) return null;
+			return OPTIONAL_PEER_STUBS[id.slice(23)] ?? null;
+		}
+	};
+}
 function resolveIconOptions(options) {
 	const icons = options.icons ?? true;
 	if (icons === false) return null;

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","names":[],"sources":["../resources/js/vite.ts"],"sourcesContent":["import path from \"node:path\";\nimport { svgSprite } from \"@lattice-php/vite-svg-sprite\";\nimport type { SvgSpriteOptions } from \"@lattice-php/vite-svg-sprite\";\nimport { searchForWorkspaceRoot } from \"vite\";\nimport type { Plugin, PluginOption, UserConfig } from \"vite\";\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?: SvgSpriteOptions[\"dts\"] | false;\n};\n\nexport type LatticeViteOptions = {\n  appRoot?: string;\n  icons?: boolean | LatticeViteIconsOptions;\n  root?: string;\n  source?: boolean;\n};\n\ntype Roots = {\n  appRoot: string;\n  root: string;\n};\n\nexport function lattice(options: LatticeViteOptions = {}): PluginOption[] {\n  const plugins: PluginOption[] = [corePlugin(options)];\n  const iconOptions = resolveIconOptions(options);\n\n  if (iconOptions) {\n    plugins.push(svgSprite(iconOptions));\n  }\n\n  return plugins;\n}\n\nexport function latticeConfig(options: LatticeViteOptions = {}): ConfigWithTest {\n  const { appRoot, root } = resolveRoots(options);\n\n  return {\n    resolve: {\n      alias: options.source\n        ? {\n            \"@lattice-php/lattice/css\": path.resolve(root, \"resources/css/lattice.css\"),\n            \"@lattice-php/lattice\": path.resolve(root, \"resources/js\"),\n          }\n        : {\n            react: path.resolve(appRoot, \"node_modules/react\"),\n            \"react-dom\": path.resolve(appRoot, \"node_modules/react-dom\"),\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[/\\\\]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\nfunction 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/lattice\",\n    augmentInterface: \"KnownIcons\",\n  };\n\n  return {\n    ...spriteOptions,\n    iconDirs: [path.resolve(root, \"resources/icons\"), ...dirs],\n    ...(dts === false ? {} : { dts: dts ?? defaultTypes }),\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":";;;;AAmCA,SAAgB,QAAQ,UAA8B,CAAC,GAAmB;CACxE,MAAM,UAA0B,CAAC,WAAW,OAAO,CAAC;CACpD,MAAM,cAAc,mBAAmB,OAAO;CAE9C,IAAI,aACF,QAAQ,KAAK,UAAU,WAAW,CAAC;CAGrC,OAAO;AACT;AAEA,SAAgB,cAAc,UAA8B,CAAC,GAAmB;CAC9E,MAAM,EAAE,SAAS,SAAS,aAAa,OAAO;CAE9C,OAAO;EACL,SAAS;GACP,OAAO,QAAQ,SACX;IACE,4BAA4B,KAAK,QAAQ,MAAM,2BAA2B;IAC1E,wBAAwB,KAAK,QAAQ,MAAM,cAAc;GAC3D,IACA;IACE,OAAO,KAAK,QAAQ,SAAS,oBAAoB;IACjD,aAAa,KAAK,QAAQ,SAAS,wBAAwB;GAC7D;GACJ,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;EACF,EACF,EACF,EACF;CACF;AACF;AAEA,SAAS,WAAW,SAAqC;CACvD,OAAO;EACL,MAAM;EACN,SAAS;GACP,OAAO,cAAc,OAAO;EAC9B;CACF;AACF;AAEA,SAAS,mBAAmB,SAAsD;CAChF,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,iBAAiB,GAAG,GAAG,IAAI;EACzD,GAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,KAAK,OAAO,aAAa;CACtD;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 path from \"node:path\";\nimport { svgSprite } from \"@lattice-php/vite-svg-sprite\";\nimport type { SvgSpriteOptions } from \"@lattice-php/vite-svg-sprite\";\nimport { searchForWorkspaceRoot } from \"vite\";\nimport type { Plugin, PluginOption, UserConfig } from \"vite\";\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?: SvgSpriteOptions[\"dts\"] | false;\n};\n\nexport type LatticeViteOptions = {\n  appRoot?: string;\n  icons?: boolean | LatticeViteIconsOptions;\n  root?: string;\n  source?: boolean;\n};\n\ntype Roots = {\n  appRoot: string;\n  root: string;\n};\n\nexport function lattice(options: LatticeViteOptions = {}): PluginOption[] {\n  const plugins: PluginOption[] = [corePlugin(options), optionalPeersPlugin()];\n  const iconOptions = resolveIconOptions(options);\n\n  if (iconOptions) {\n    plugins.push(svgSprite(iconOptions));\n  }\n\n  return plugins;\n}\n\nexport function latticeConfig(options: LatticeViteOptions = {}): ConfigWithTest {\n  const { appRoot, root } = resolveRoots(options);\n\n  return {\n    resolve: {\n      alias: options.source\n        ? {\n            \"@lattice-php/lattice/css\": path.resolve(root, \"resources/css/lattice.css\"),\n            \"@lattice-php/lattice\": path.resolve(root, \"resources/js\"),\n          }\n        : {\n            react: path.resolve(appRoot, \"node_modules/react\"),\n            \"react-dom\": path.resolve(appRoot, \"node_modules/react-dom\"),\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[/\\\\]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  ].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\nfunction 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/lattice\",\n    augmentInterface: \"KnownIcons\",\n  };\n\n  return {\n    ...spriteOptions,\n    iconDirs: [path.resolve(root, \"resources/icons\"), ...dirs],\n    ...(dts === false ? {} : { dts: dts ?? defaultTypes }),\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":";;;;AAmCA,SAAgB,QAAQ,UAA8B,CAAC,GAAmB;CACxE,MAAM,UAA0B,CAAC,WAAW,OAAO,GAAG,oBAAoB,CAAC;CAC3E,MAAM,cAAc,mBAAmB,OAAO;CAE9C,IAAI,aACF,QAAQ,KAAK,UAAU,WAAW,CAAC;CAGrC,OAAO;AACT;AAEA,SAAgB,cAAc,UAA8B,CAAC,GAAmB;CAC9E,MAAM,EAAE,SAAS,SAAS,aAAa,OAAO;CAE9C,OAAO;EACL,SAAS;GACP,OAAO,QAAQ,SACX;IACE,4BAA4B,KAAK,QAAQ,MAAM,2BAA2B;IAC1E,wBAAwB,KAAK,QAAQ,MAAM,cAAc;GAC3D,IACA;IACE,OAAO,KAAK,QAAQ,SAAS,oBAAoB;IACjD,aAAa,KAAK,QAAQ,SAAS,wBAAwB;GAC7D;GACJ,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;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;AACF,EAAE,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,mBAAmB,SAAsD;CAChF,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,iBAAiB,GAAG,GAAG,IAAI;EACzD,GAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,KAAK,OAAO,aAAa;CACtD;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lattice-php/lattice",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Server-driven React components for Laravel and Inertia.",
   "license": "MIT",
   "author": "Manuel Christlieb <manuel@christlieb.eu>",
@@ -127,10 +127,22 @@
       "types": "./dist/provider.d.ts",
       "import": "./dist/provider.js"
     },
+    "./realtime/*": {
+      "types": "./dist/realtime/*.d.ts",
+      "import": "./dist/realtime/*.js"
+    },
     "./registry": {
       "types": "./dist/registry.d.ts",
       "import": "./dist/registry.js"
     },
+    "./remote": {
+      "types": "./dist/remote/index.d.ts",
+      "import": "./dist/remote/index.js"
+    },
+    "./remote/*": {
+      "types": "./dist/remote/*.d.ts",
+      "import": "./dist/remote/*.js"
+    },
     "./table": {
       "types": "./dist/table/index.d.ts",
       "import": "./dist/table/index.js"
@@ -191,8 +203,8 @@
     "lint": "oxlint resources/js workbench/resources/js",
     "lint:fix": "oxlint resources/js workbench/resources/js --fix",
     "lint:github": "oxlint resources/js workbench/resources/js --format=github",
-    "format": "oxfmt --write \"resources/js/**/*.{ts,tsx}\" \"workbench/resources/js/**/*.{ts,tsx}\"",
-    "format:check": "oxfmt --check \"resources/js/**/*.{ts,tsx}\" \"workbench/resources/js/**/*.{ts,tsx}\"",
+    "format": "oxfmt --write \"resources/js/**/*.{ts,tsx}\" \"workbench/resources/js/**/*.{ts,tsx}\" \"docs/**/*.{ts,tsx,md,mdx}\"",
+    "format:check": "oxfmt --check \"resources/js/**/*.{ts,tsx}\" \"workbench/resources/js/**/*.{ts,tsx}\" \"docs/**/*.{ts,tsx,md,mdx}\"",
     "analyze": "SONDA=1 vite build && mkdir -p docs/public && cp docs/generated/bundle-report.html docs/public/bundle-report.html",
     "docs:dev": "npm run analyze && astro dev",
     "docs:build": "npm run analyze && astro build",
@@ -218,14 +230,26 @@
     "clsx": "^2.1.1",
     "i18next": "^26.3.1",
     "i18next-http-backend": "^4.0.0",
+    "input-otp": "^1.4.2",
     "recharts": "^3.8.1",
+    "starlight-llms-txt": "^0.10.0",
     "tailwind-merge": "^3.0.1"
   },
   "peerDependencies": {
     "@inertiajs/react": "^3.0.0",
+    "@laravel/echo-react": "^2.0.0",
+    "pusher-js": "^8.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@laravel/echo-react": {
+      "optional": true
+    },
+    "pusher-js": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@astrojs/react": "^5.0.7",
     "@astrojs/starlight": "^0.40.0",
@@ -233,6 +257,7 @@
     "@codecov/vite-plugin": "^2.0.1",
     "@inertiajs/react": "^3.0.0",
     "@inertiajs/vite": "^3.0.0",
+    "@laravel/echo-react": "^2.3.7",
     "@tailwindcss/vite": "^4.1.11",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
@@ -243,12 +268,17 @@
     "@vitejs/plugin-react": "^6.0.2",
     "@vitest/coverage-v8": "^4.1.8",
     "astro": "7.0.0-beta.3",
+    "astro-og-canvas": "^0.11.1",
+    "canvaskit-wasm": "^0.41.1",
     "jsdom": "^29.1.1",
+    "laravel-echo": "^2.3.7",
     "laravel-vite-plugin": "^3.0.0",
     "lucide-static": "^1.18.0",
+    "mermaid": "^11.15.0",
     "oxfmt": "^0.54.0",
     "oxlint": "^1.68.0",
     "playwright": "^1.60.0",
+    "pusher-js": "^8.5.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-scan": "^0.5.7",