@lattice-php/lattice 0.4.0 → 0.6.0

package/dist/table/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","names":[],"sources":["../../resources/js/table/query.ts"],"sourcesContent":["import { translate } from \"@lattice-php/lattice/i18n\";\nimport { DEFAULT_COLUMN_WIDTH } from \"@lattice-php/lattice/core/column-sizing\";\nimport type { ColumnWidth } from \"@lattice-php/lattice/types/generated\";\nimport type { TableColumn, TableSort, TableState } from \"./types\";\n\nexport function getColumnSort(state: TableState, column: TableColumn): TableSort | undefined {\n  return state.sorts.find((currentSort) => currentSort.key === column.key);\n}\n\nexport function getColumnAriaSort(\n  sort: TableSort | undefined,\n): \"ascending\" | \"descending\" | undefined {\n  if (sort?.direction === \"asc\") {\n    return \"ascending\";\n  }\n\n  if (sort?.direction === \"desc\") {\n    return \"descending\";\n  }\n\n  return undefined;\n}\n\nexport function buildEndpoint(endpoint: string, state: TableState): string {\n  const url = new URL(endpoint, window.location.origin);\n\n  if (state.filters.length > 0) {\n    url.searchParams.set(\"filter\", serializeFilters(state));\n  }\n\n  if (state.sorts.length > 0) {\n    url.searchParams.set(\"sort\", serializeSorts(state));\n  }\n\n  appendTableFilters(url, state.tableFilters);\n\n  url.searchParams.set(\"page\", String(state.page));\n  url.searchParams.set(\"per_page\", String(state.perPage));\n\n  return `${url.pathname}${url.search}`;\n}\n\n/**\n * Serialize the dedicated table filters as Laravel-native bracket params:\n * `tf[key]=v`, repeated `tf[key][]=v` for multi-value, and `tf[key][sub]=v`\n * for structured values (e.g. a date range's from/until). Empty values are\n * dropped so an unset filter never reaches the server.\n */\nfunction appendTableFilters(url: URL, tableFilters: Record<string, unknown>): void {\n  for (const [key, value] of Object.entries(getTableFilterParams(tableFilters))) {\n    if (typeof value === \"string\") {\n      url.searchParams.set(`tf[${key}]`, value);\n\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        if (item != null && item !== \"\") {\n          url.searchParams.append(`tf[${key}][]`, String(item));\n        }\n      }\n\n      continue;\n    }\n\n    if (typeof value === \"object\" && value !== null) {\n      for (const [subKey, subValue] of Object.entries(value as Record<string, unknown>)) {\n        url.searchParams.set(`tf[${key}][${subKey}]`, String(subValue));\n      }\n    }\n  }\n}\n\nfunction getTableFilterParams(tableFilters: Record<string, unknown>): Record<string, unknown> {\n  const params: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(tableFilters)) {\n    const normalized = normalizeTableFilterValue(value);\n\n    if (normalized !== undefined) {\n      params[key] = normalized;\n    }\n  }\n\n  return params;\n}\n\nfunction normalizeTableFilterValue(value: unknown): unknown | undefined {\n  if (value == null || value === \"\") {\n    return undefined;\n  }\n\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (Array.isArray(value)) {\n    const items = value.filter((item) => item != null && item !== \"\").map(String);\n\n    return items.length > 0 ? items : undefined;\n  }\n\n  if (typeof value === \"object\") {\n    const entries = Object.entries(value)\n      .filter(([, subValue]) => subValue != null && subValue !== \"\")\n      .map(([subKey, subValue]) => [subKey, String(subValue)]);\n\n    return entries.length > 0 ? Object.fromEntries(entries) : undefined;\n  }\n\n  return String(value);\n}\n\nexport function getQueryParams(state: TableState): Record<string, unknown> {\n  const params: Record<string, unknown> = {};\n\n  if (state.filters.length > 0) {\n    params.filter = serializeFilters(state);\n  }\n\n  if (state.sorts.length > 0) {\n    params.sort = serializeSorts(state);\n  }\n\n  const tableFilters = getTableFilterParams(state.tableFilters);\n\n  if (Object.keys(tableFilters).length > 0) {\n    params.tf = tableFilters;\n  }\n\n  return params;\n}\n\nfunction serializeFilters(state: TableState): string {\n  return state.filters\n    .map((clause) => `${clause.field}:${clause.operator}:${encodeURIComponent(clause.value)}`)\n    .join(\",\");\n}\n\nfunction serializeSorts(state: TableState): string {\n  return state.sorts\n    .map((sort) => (sort.direction === \"desc\" ? `-${sort.key}` : sort.key))\n    .join(\",\");\n}\n\nconst operatorLabels: Record<string, string> = {\n  contains: \"contains\",\n  starts_with: \"starts with\",\n  ends_with: \"ends with\",\n  eq: \"equals\",\n  neq: \"not equals\",\n  gt: \">\",\n  gte: \"≥\",\n  lt: \"<\",\n  lte: \"≤\",\n  in: \"in\",\n  not_in: \"not in\",\n  before: \"before\",\n  after: \"after\",\n  empty: \"is empty\",\n  filled: \"is not empty\",\n};\n\nexport const VALUELESS_FILTER_OPERATORS = new Set<string>([\"empty\", \"filled\"]);\n\nexport function operatorLabel(operator: string): string {\n  return translate(\"lattice\", `operators.${operator}`, operatorLabels[operator] ?? operator);\n}\n\nexport function getSortDirectionLabel(direction: string): string {\n  return direction === \"desc\" ? \"descending\" : \"ascending\";\n}\n\nexport function nextSort(sorts: TableSort[], column: TableColumn): TableSort[] {\n  if (!column.sortable) {\n    return sorts;\n  }\n\n  const currentSort = sorts.find((sort) => sort.key === column.key);\n  const remainingSorts = sorts.filter((sort) => sort.key !== column.key);\n\n  if (!currentSort) {\n    return [...sorts, { key: column.key, direction: \"asc\" }];\n  }\n\n  if (currentSort.direction === \"asc\") {\n    return [...remainingSorts, { key: column.key, direction: \"desc\" }];\n  }\n\n  return remainingSorts;\n}\n\nexport function getVisiblePages(currentPage: number, lastPage: number): number[] {\n  if (lastPage <= 5) {\n    return Array.from({ length: lastPage }, (_, index) => index + 1);\n  }\n\n  const start = Math.max(1, Math.min(currentPage - 2, lastPage - 4));\n\n  return Array.from({ length: 5 }, (_, index) => start + index);\n}\n\nexport function getTableSizingColumns(columns: TableColumn[]) {\n  return columns.map((column) => ({\n    key: column.key,\n    label: column.label,\n    width: columnWidthOrDefault(column),\n  }));\n}\n\nfunction columnWidthOrDefault(column: TableColumn): ColumnWidth {\n  return (column.width ??\n    (column.type === \"column.stack\" ? \"xl\" : DEFAULT_COLUMN_WIDTH)) as ColumnWidth;\n}\n\nexport function getTableUtilityTracks(hasActions: boolean, hasSelection: boolean) {\n  // Utility tracks are fixed because the independent header/filter/body grids would drift with content-sized tracks.\n  return {\n    leadingTracks: hasSelection ? [\"3rem\"] : [],\n    trailingTracks: hasActions ? [\"10rem\"] : [],\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"query.js","names":[],"sources":["../../resources/js/table/query.ts"],"sourcesContent":["import { translate } from \"@lattice-php/lattice/i18n\";\nimport { DEFAULT_COLUMN_WIDTH } from \"@lattice-php/lattice/core/column-sizing\";\nimport type { ColumnWidth } from \"@lattice-php/lattice/types/generated\";\nimport { isEmptyMember } from \"./filter-values\";\nimport type { TableColumn, TableSort, TableState } from \"./types\";\n\nexport function getColumnSort(state: TableState, column: TableColumn): TableSort | undefined {\n  return state.sorts.find((currentSort) => currentSort.key === column.key);\n}\n\nexport function getColumnAriaSort(\n  sort: TableSort | undefined,\n): \"ascending\" | \"descending\" | undefined {\n  if (sort?.direction === \"asc\") {\n    return \"ascending\";\n  }\n\n  if (sort?.direction === \"desc\") {\n    return \"descending\";\n  }\n\n  return undefined;\n}\n\nexport function buildEndpoint(endpoint: string, state: TableState): string {\n  const url = new URL(endpoint, window.location.origin);\n\n  if (state.filters.length > 0) {\n    url.searchParams.set(\"filter\", serializeFilters(state));\n  }\n\n  if (state.sorts.length > 0) {\n    url.searchParams.set(\"sort\", serializeSorts(state));\n  }\n\n  appendTableFilters(url, state.tableFilters);\n\n  url.searchParams.set(\"page\", String(state.page));\n  url.searchParams.set(\"per_page\", String(state.perPage));\n\n  return `${url.pathname}${url.search}`;\n}\n\n/**\n * Serialize the dedicated table filters as Laravel-native bracket params:\n * `tf[key]=v`, repeated `tf[key][]=v` for multi-value, and `tf[key][sub]=v`\n * for structured values (e.g. a date range's from/until). Empty values are\n * dropped so an unset filter never reaches the server.\n */\nfunction appendTableFilters(url: URL, tableFilters: Record<string, unknown>): void {\n  for (const [key, value] of Object.entries(getTableFilterParams(tableFilters))) {\n    if (typeof value === \"string\") {\n      url.searchParams.set(`tf[${key}]`, value);\n\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        if (!isEmptyMember(item)) {\n          url.searchParams.append(`tf[${key}][]`, String(item));\n        }\n      }\n\n      continue;\n    }\n\n    if (typeof value === \"object\" && value !== null) {\n      for (const [subKey, subValue] of Object.entries(value as Record<string, unknown>)) {\n        url.searchParams.set(`tf[${key}][${subKey}]`, String(subValue));\n      }\n    }\n  }\n}\n\nfunction getTableFilterParams(tableFilters: Record<string, unknown>): Record<string, unknown> {\n  const params: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(tableFilters)) {\n    const normalized = normalizeTableFilterValue(value);\n\n    if (normalized !== undefined) {\n      params[key] = normalized;\n    }\n  }\n\n  return params;\n}\n\nfunction normalizeTableFilterValue(value: unknown): unknown | undefined {\n  if (isEmptyMember(value)) {\n    return undefined;\n  }\n\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (Array.isArray(value)) {\n    const items = value.filter((item) => !isEmptyMember(item)).map(String);\n\n    return items.length > 0 ? items : undefined;\n  }\n\n  if (typeof value === \"object\") {\n    const entries = Object.entries(value)\n      .filter(([, subValue]) => !isEmptyMember(subValue))\n      .map(([subKey, subValue]) => [subKey, String(subValue)]);\n\n    return entries.length > 0 ? Object.fromEntries(entries) : undefined;\n  }\n\n  return String(value);\n}\n\nexport function getQueryParams(state: TableState): Record<string, unknown> {\n  const params: Record<string, unknown> = {};\n\n  if (state.filters.length > 0) {\n    params.filter = serializeFilters(state);\n  }\n\n  if (state.sorts.length > 0) {\n    params.sort = serializeSorts(state);\n  }\n\n  const tableFilters = getTableFilterParams(state.tableFilters);\n\n  if (Object.keys(tableFilters).length > 0) {\n    params.tf = tableFilters;\n  }\n\n  return params;\n}\n\nfunction serializeFilters(state: TableState): string {\n  return state.filters\n    .map((clause) => `${clause.field}:${clause.operator}:${encodeURIComponent(clause.value)}`)\n    .join(\",\");\n}\n\nfunction serializeSorts(state: TableState): string {\n  return state.sorts\n    .map((sort) => (sort.direction === \"desc\" ? `-${sort.key}` : sort.key))\n    .join(\",\");\n}\n\nconst operatorLabels: Record<string, string> = {\n  contains: \"contains\",\n  starts_with: \"starts with\",\n  ends_with: \"ends with\",\n  eq: \"equals\",\n  neq: \"not equals\",\n  gt: \">\",\n  gte: \"≥\",\n  lt: \"<\",\n  lte: \"≤\",\n  in: \"in\",\n  not_in: \"not in\",\n  before: \"before\",\n  after: \"after\",\n  empty: \"is empty\",\n  filled: \"is not empty\",\n};\n\nexport const VALUELESS_FILTER_OPERATORS = new Set<string>([\"empty\", \"filled\"]);\n\nexport function operatorLabel(operator: string): string {\n  return translate(\"lattice\", `operators.${operator}`, operatorLabels[operator] ?? operator);\n}\n\nexport function getSortDirectionLabel(direction: string): string {\n  return direction === \"desc\" ? \"descending\" : \"ascending\";\n}\n\nexport function nextSort(sorts: TableSort[], column: TableColumn): TableSort[] {\n  if (!column.sortable) {\n    return sorts;\n  }\n\n  const currentSort = sorts.find((sort) => sort.key === column.key);\n  const remainingSorts = sorts.filter((sort) => sort.key !== column.key);\n\n  if (!currentSort) {\n    return [...sorts, { key: column.key, direction: \"asc\" }];\n  }\n\n  if (currentSort.direction === \"asc\") {\n    return [...remainingSorts, { key: column.key, direction: \"desc\" }];\n  }\n\n  return remainingSorts;\n}\n\nexport function getVisiblePages(currentPage: number, lastPage: number): number[] {\n  if (lastPage <= 5) {\n    return Array.from({ length: lastPage }, (_, index) => index + 1);\n  }\n\n  const start = Math.max(1, Math.min(currentPage - 2, lastPage - 4));\n\n  return Array.from({ length: 5 }, (_, index) => start + index);\n}\n\nexport function getTableSizingColumns(columns: TableColumn[]) {\n  return columns.map((column) => ({\n    key: column.key,\n    label: column.label,\n    width: columnWidthOrDefault(column),\n  }));\n}\n\nfunction columnWidthOrDefault(column: TableColumn): ColumnWidth {\n  return (column.width ??\n    (column.type === \"column.stack\" ? \"xl\" : DEFAULT_COLUMN_WIDTH)) as ColumnWidth;\n}\n\nexport function getTableUtilityTracks(hasActions: boolean, hasSelection: boolean) {\n  // Utility tracks are fixed because the independent header/filter/body grids would drift with content-sized tracks.\n  return {\n    leadingTracks: hasSelection ? [\"3rem\"] : [],\n    trailingTracks: hasActions ? [\"10rem\"] : [],\n  };\n}\n"],"mappings":";;;;AAMA,SAAgB,cAAc,OAAmB,QAA4C;CAC3F,OAAO,MAAM,MAAM,MAAM,gBAAgB,YAAY,QAAQ,OAAO,GAAG;AACzE;AAEA,SAAgB,kBACd,MACwC;CACxC,IAAI,MAAM,cAAc,OACtB,OAAO;CAGT,IAAI,MAAM,cAAc,QACtB,OAAO;AAIX;AAEA,SAAgB,cAAc,UAAkB,OAA2B;CACzE,MAAM,MAAM,IAAI,IAAI,UAAU,OAAO,SAAS,MAAM;CAEpD,IAAI,MAAM,QAAQ,SAAS,GACzB,IAAI,aAAa,IAAI,UAAU,iBAAiB,KAAK,CAAC;CAGxD,IAAI,MAAM,MAAM,SAAS,GACvB,IAAI,aAAa,IAAI,QAAQ,eAAe,KAAK,CAAC;CAGpD,mBAAmB,KAAK,MAAM,YAAY;CAE1C,IAAI,aAAa,IAAI,QAAQ,OAAO,MAAM,IAAI,CAAC;CAC/C,IAAI,aAAa,IAAI,YAAY,OAAO,MAAM,OAAO,CAAC;CAEtD,OAAO,GAAG,IAAI,WAAW,IAAI;AAC/B;;;;;;;AAQA,SAAS,mBAAmB,KAAU,cAA6C;CACjF,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,qBAAqB,YAAY,CAAC,GAAG;EAC7E,IAAI,OAAO,UAAU,UAAU;GAC7B,IAAI,aAAa,IAAI,MAAM,IAAI,IAAI,KAAK;GAExC;EACF;EAEA,IAAI,MAAM,QAAQ,KAAK,GAAG;GACxB,KAAK,MAAM,QAAQ,OACjB,IAAI,CAAC,cAAc,IAAI,GACrB,IAAI,aAAa,OAAO,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC;GAIxD;EACF;EAEA,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,KAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,KAAgC,GAC9E,IAAI,aAAa,IAAI,MAAM,IAAI,IAAI,OAAO,IAAI,OAAO,QAAQ,CAAC;CAGpE;AACF;AAEA,SAAS,qBAAqB,cAAgE;CAC5F,MAAM,SAAkC,CAAC;CAEzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,YAAY,GAAG;EACvD,MAAM,aAAa,0BAA0B,KAAK;EAElD,IAAI,eAAe,KAAA,GACjB,OAAO,OAAO;CAElB;CAEA,OAAO;AACT;AAEA,SAAS,0BAA0B,OAAqC;CACtE,IAAI,cAAc,KAAK,GACrB;CAGF,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxB,MAAM,QAAQ,MAAM,QAAQ,SAAS,CAAC,cAAc,IAAI,CAAC,EAAE,IAAI,MAAM;EAErE,OAAO,MAAM,SAAS,IAAI,QAAQ,KAAA;CACpC;CAEA,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,UAAU,OAAO,QAAQ,KAAK,EACjC,QAAQ,GAAG,cAAc,CAAC,cAAc,QAAQ,CAAC,EACjD,KAAK,CAAC,QAAQ,cAAc,CAAC,QAAQ,OAAO,QAAQ,CAAC,CAAC;EAEzD,OAAO,QAAQ,SAAS,IAAI,OAAO,YAAY,OAAO,IAAI,KAAA;CAC5D;CAEA,OAAO,OAAO,KAAK;AACrB;AAEA,SAAgB,eAAe,OAA4C;CACzE,MAAM,SAAkC,CAAC;CAEzC,IAAI,MAAM,QAAQ,SAAS,GACzB,OAAO,SAAS,iBAAiB,KAAK;CAGxC,IAAI,MAAM,MAAM,SAAS,GACvB,OAAO,OAAO,eAAe,KAAK;CAGpC,MAAM,eAAe,qBAAqB,MAAM,YAAY;CAE5D,IAAI,OAAO,KAAK,YAAY,EAAE,SAAS,GACrC,OAAO,KAAK;CAGd,OAAO;AACT;AAEA,SAAS,iBAAiB,OAA2B;CACnD,OAAO,MAAM,QACV,KAAK,WAAW,GAAG,OAAO,MAAM,GAAG,OAAO,SAAS,GAAG,mBAAmB,OAAO,KAAK,GAAG,EACxF,KAAK,GAAG;AACb;AAEA,SAAS,eAAe,OAA2B;CACjD,OAAO,MAAM,MACV,KAAK,SAAU,KAAK,cAAc,SAAS,IAAI,KAAK,QAAQ,KAAK,GAAI,EACrE,KAAK,GAAG;AACb;AAEA,IAAM,iBAAyC;CAC7C,UAAU;CACV,aAAa;CACb,WAAW;CACX,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,QAAQ;CACR,QAAQ;CACR,OAAO;CACP,OAAO;CACP,QAAQ;AACV;AAEA,IAAa,6BAA6B,IAAI,IAAY,CAAC,SAAS,QAAQ,CAAC;AAE7E,SAAgB,cAAc,UAA0B;CACtD,OAAO,UAAU,WAAW,aAAa,YAAY,eAAe,aAAa,QAAQ;AAC3F;AAEA,SAAgB,sBAAsB,WAA2B;CAC/D,OAAO,cAAc,SAAS,eAAe;AAC/C;AAEA,SAAgB,SAAS,OAAoB,QAAkC;CAC7E,IAAI,CAAC,OAAO,UACV,OAAO;CAGT,MAAM,cAAc,MAAM,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;CAChE,MAAM,iBAAiB,MAAM,QAAQ,SAAS,KAAK,QAAQ,OAAO,GAAG;CAErE,IAAI,CAAC,aACH,OAAO,CAAC,GAAG,OAAO;EAAE,KAAK,OAAO;EAAK,WAAW;CAAM,CAAC;CAGzD,IAAI,YAAY,cAAc,OAC5B,OAAO,CAAC,GAAG,gBAAgB;EAAE,KAAK,OAAO;EAAK,WAAW;CAAO,CAAC;CAGnE,OAAO;AACT;AAEA,SAAgB,gBAAgB,aAAqB,UAA4B;CAC/E,IAAI,YAAY,GACd,OAAO,MAAM,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,UAAU,QAAQ,CAAC;CAGjE,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,cAAc,GAAG,WAAW,CAAC,CAAC;CAEjE,OAAO,MAAM,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,UAAU,QAAQ,KAAK;AAC9D;AAEA,SAAgB,sBAAsB,SAAwB;CAC5D,OAAO,QAAQ,KAAK,YAAY;EAC9B,KAAK,OAAO;EACZ,OAAO,OAAO;EACd,OAAO,qBAAqB,MAAM;CACpC,EAAE;AACJ;AAEA,SAAS,qBAAqB,QAAkC;CAC9D,OAAQ,OAAO,UACZ,OAAO,SAAS,iBAAiB,OAAA;AACtC;AAEA,SAAgB,sBAAsB,YAAqB,cAAuB;CAEhF,OAAO;EACL,eAAe,eAAe,CAAC,MAAM,IAAI,CAAC;EAC1C,gBAAgB,aAAa,CAAC,OAAO,IAAI,CAAC;CAC5C;AACF"}

package/dist/toast/toaster.js

@@ -1,9 +1,9 @@
 import { cn } from "../lib/utils.js";
 import { Icon } from "../icons/sprite.js";
-import { useT } from "../i18n/instance.js";
+import { RenderNode } from "../core/renderer.js";
 import { resolveTranslatable } from "../i18n/translatable.js";
 import { onToast } from "./toast.js";
-import { RenderNode } from "../core/renderer.js";
+import { useT } from "../i18n/instance.js";
 import { variantStyles } from "./variant-styles.js";
 import { useEffect, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";

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;
@@ -91,7 +90,6 @@ export type Builder = {
 };
 export type BulkAction = {
     confirmation: Confirmation | null;
-    effects: Effect[];
     endpoint: string | null;
     form: Node | null;
     icon: string | null;
@@ -103,7 +101,9 @@ export type BulkAction = {
 };
 export type Button = {
     buttonType: ButtonType;
+    effects: Effect[];
     href: string | null;
+    icon: string | null;
     label: string;
     variant: ButtonVariant | null;
 };
@@ -148,10 +148,10 @@ 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;
 };
@@ -161,6 +161,10 @@ export type ChatMessage = {
     readonly parts: Node[];
 };
 export type ChatNode = {
+    type: "chat.box";
+    key?: string;
+    props: ChatBox;
+} | {
     type: "chat.part.text";
     key?: string;
     props: TextPart;
@@ -296,10 +300,6 @@ export type CoreNode = {
     type: "chart";
     key?: string;
     props: Chart;
-} | {
-    type: "chat.box";
-    key?: string;
-    props: ChatBox;
 } | {
     type: "floating-panel";
     key?: string;
@@ -393,6 +393,7 @@ export type DateInput = {
     tooltip: string | null;
     value: unknown;
 };
+export type DateTimeStyle = "full" | "long" | "medium" | "short";
 export type DownloadEffect = {
     readonly url: string;
 };
@@ -420,9 +421,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;
@@ -522,6 +524,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;
@@ -606,6 +612,7 @@ export type I18nConfig = {
     readonly saveMissing: boolean;
     readonly locales: string[];
     readonly preloadLocales: string[];
+    readonly timezone: string | null;
 };
 export type Icon = {
     class: string | null;
@@ -747,6 +754,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";
@@ -811,20 +843,7 @@ export type RemoteAccess = {
     readonly tokenEndpoint: string;
     readonly ref: string;
 };
-export type RemoteChatBox = {
-    conversationId: string | null;
-    fill: boolean;
-    historyEndpoint: string | null;
-    placeholder: string | null;
-    remote: RemoteAccess | null;
-    streamEndpoint: string | null;
-    title: string | null;
-};
 export type RemoteNode = {
-    type: "remote.chat-box";
-    key?: string;
-    props: RemoteChatBox;
-} | {
     type: "remote.data-list";
     key?: string;
     props: DataList;
@@ -1025,14 +1044,19 @@ export type Text = {
     text: string;
 };
 export type TextColumn = {
+    badge: {
+        colorKey: string;
+    } | null;
     copyable: boolean;
     date: {
-        format: string | null;
+        dateStyle: string | null;
+        timeStyle: string | null;
     } | null;
     link: {
         href: string | null;
         external: boolean;
     } | null;
+    multiple: string | null;
 };
 export type TextInput = {
     autoComplete: string | null;
@@ -1105,6 +1129,9 @@ export type ToastMessage = {
     variant: Variant;
     message: Translatable | string;
 };
+export type ToggleSidebarEffect = {
+    readonly target: string | null;
+};
 export type ToolCallPart = {
     args: Record<string, unknown>;
     name: string;

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.4.0",
+  "version": "0.6.0",
   "description": "Server-driven React components for Laravel and Inertia.",
   "license": "MIT",
   "author": "Manuel Christlieb <manuel@christlieb.eu>",
@@ -135,6 +135,14 @@
       "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"
@@ -195,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",
@@ -222,7 +230,9 @@
     "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": {
@@ -264,6 +274,7 @@
     "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",

package/dist/remote/components/chat-box.d.ts

@@ -1,3 +0,0 @@
-import { RendererComponent } from '../../core/types';
-export declare const RemoteChatBox: RendererComponent<"remote.chat-box">;
-export default RemoteChatBox;

package/dist/remote/components/chat-box.js

@@ -1,65 +0,0 @@
-import { cn } from "../../lib/utils.js";
-import { testIdentity } from "../../core/test-id.js";
-import { useT } from "../../i18n/instance.js";
-import { remoteJson } from "../../core/api.js";
-import { createRemoteNdjsonChatTransport, ndjsonChatTransport } from "../../chat/transport.js";
-import { useChat } from "../../chat/use-chat.js";
-import { MessageList } from "../../chat/components/message-list.js";
-import { PromptInput } from "../../chat/components/prompt-input.js";
-import { useCallback, useEffect, useMemo, useRef } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
-//#region resources/js/remote/components/chat-box.tsx
-var RemoteChatBox = ({ node }) => {
-	const props = node.props;
-	const { t } = useT("lattice");
-	const transport = useMemo(() => props.remote ? createRemoteNdjsonChatTransport(props.remote) : ndjsonChatTransport, [props.remote]);
-	const { messages, status, error, sendMessage, setMessages } = useChat({
-		endpoint: props.streamEndpoint ?? "",
-		transport
-	});
-	const seededRef = useRef(false);
-	const seedHistory = useCallback(async () => {
-		if (seededRef.current || !props.historyEndpoint || !props.remote) return;
-		seededRef.current = true;
-		setMessages((await remoteJson(props.historyEndpoint, { remote: props.remote })).messages);
-	}, [
-		props.historyEndpoint,
-		props.remote,
-		setMessages
-	]);
-	useEffect(() => {
-		seedHistory().catch(() => {});
-	}, [seedHistory]);
-	const disabled = status === "submitted" || status === "streaming" || !props.remote || !props.streamEndpoint;
-	const visibleError = error;
-	return /* @__PURE__ */ jsxs("div", {
-		className: cn("flex flex-col overflow-hidden border border-lt-border bg-lt-bg", props.fill ? "sticky top-0 h-full min-h-[28rem] w-full" : "h-[28rem] w-80 rounded-lt shadow-lt-lg"),
-		"data-test": testIdentity("chat-box"),
-		children: [
-			/* @__PURE__ */ jsx("div", {
-				className: "flex items-center border-b border-lt-border px-3 py-2",
-				children: /* @__PURE__ */ jsx("span", {
-					className: "text-sm font-medium text-lt-fg",
-					children: props.title ?? t("chat.title", "Chat")
-				})
-			}),
-			/* @__PURE__ */ jsx("div", {
-				className: "flex-1 overflow-y-auto",
-				children: /* @__PURE__ */ jsx(MessageList, { messages })
-			}),
-			visibleError ? /* @__PURE__ */ jsx("div", {
-				className: "border-t border-lt-danger/40 px-3 py-2 text-xs text-lt-danger",
-				children: visibleError
-			}) : null,
-			/* @__PURE__ */ jsx(PromptInput, {
-				disabled,
-				onSubmit: sendMessage,
-				placeholder: props.placeholder ?? void 0
-			})
-		]
-	});
-};
-//#endregion
-export { RemoteChatBox, RemoteChatBox as default };
-
-//# sourceMappingURL=chat-box.js.map

package/dist/remote/components/chat-box.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat-box.js","names":[],"sources":["../../../resources/js/remote/components/chat-box.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { remoteJson } from \"@lattice-php/lattice/core/api\";\nimport { testIdentity } from \"@lattice-php/lattice/core/test-id\";\nimport type { RendererComponent } from \"@lattice-php/lattice/core/types\";\nimport type { RemoteChatBox as RemoteChatBoxProps } from \"@lattice-php/lattice/types/generated\";\nimport { useT } from \"@lattice-php/lattice/i18n\";\nimport { cn } from \"@lattice-php/lattice/lib/utils\";\nimport {\n  createRemoteNdjsonChatTransport,\n  ndjsonChatTransport,\n} from \"@lattice-php/lattice/chat/transport\";\nimport { useChat } from \"@lattice-php/lattice/chat/use-chat\";\nimport type { ChatMessage } from \"@lattice-php/lattice/chat/types\";\nimport { MessageList } from \"@lattice-php/lattice/chat/components/message-list\";\nimport { PromptInput } from \"@lattice-php/lattice/chat/components/prompt-input\";\n\ntype ChatHistoryResponse = { messages: ChatMessage[] };\n\nexport const RemoteChatBox: RendererComponent<\"remote.chat-box\"> = ({ node }) => {\n  const props: RemoteChatBoxProps = node.props;\n  const { t } = useT(\"lattice\");\n  const transport = useMemo(\n    () => (props.remote ? createRemoteNdjsonChatTransport(props.remote) : ndjsonChatTransport),\n    [props.remote],\n  );\n  const { messages, status, error, sendMessage, setMessages } = useChat({\n    endpoint: props.streamEndpoint ?? \"\",\n    transport,\n  });\n\n  const seededRef = useRef(false);\n\n  const seedHistory = useCallback(async (): Promise<void> => {\n    if (seededRef.current || !props.historyEndpoint || !props.remote) {\n      return;\n    }\n\n    seededRef.current = true;\n\n    const payload = await remoteJson<ChatHistoryResponse>(props.historyEndpoint, {\n      remote: props.remote,\n    });\n\n    setMessages(payload.messages);\n  }, [props.historyEndpoint, props.remote, setMessages]);\n\n  useEffect(() => {\n    void seedHistory().catch(() => {});\n  }, [seedHistory]);\n\n  const busy = status === \"submitted\" || status === \"streaming\";\n  const disabled = busy || !props.remote || !props.streamEndpoint;\n  const visibleError = error;\n\n  return (\n    <div\n      className={cn(\n        \"flex flex-col overflow-hidden border border-lt-border bg-lt-bg\",\n        props.fill\n          ? \"sticky top-0 h-full min-h-[28rem] w-full\"\n          : \"h-[28rem] w-80 rounded-lt shadow-lt-lg\",\n      )}\n      data-test={testIdentity(\"chat-box\")}\n    >\n      <div className=\"flex items-center border-b border-lt-border px-3 py-2\">\n        <span className=\"text-sm font-medium text-lt-fg\">\n          {props.title ?? t(\"chat.title\", \"Chat\")}\n        </span>\n      </div>\n      <div className=\"flex-1 overflow-y-auto\">\n        <MessageList messages={messages} />\n      </div>\n      {visibleError ? (\n        <div className=\"border-t border-lt-danger/40 px-3 py-2 text-xs text-lt-danger\">\n          {visibleError}\n        </div>\n      ) : null}\n      <PromptInput\n        disabled={disabled}\n        onSubmit={sendMessage}\n        placeholder={props.placeholder ?? undefined}\n      />\n    </div>\n  );\n};\n\nexport default RemoteChatBox;\n"],"mappings":";;;;;;;;;;;AAkBA,IAAa,iBAAuD,EAAE,WAAW;CAC/E,MAAM,QAA4B,KAAK;CACvC,MAAM,EAAE,MAAM,KAAK,SAAS;CAC5B,MAAM,YAAY,cACT,MAAM,SAAS,gCAAgC,MAAM,MAAM,IAAI,qBACtE,CAAC,MAAM,MAAM,CACf;CACA,MAAM,EAAE,UAAU,QAAQ,OAAO,aAAa,gBAAgB,QAAQ;EACpE,UAAU,MAAM,kBAAkB;EAClC;CACF,CAAC;CAED,MAAM,YAAY,OAAO,KAAK;CAE9B,MAAM,cAAc,YAAY,YAA2B;EACzD,IAAI,UAAU,WAAW,CAAC,MAAM,mBAAmB,CAAC,MAAM,QACxD;EAGF,UAAU,UAAU;EAMpB,aAAY,MAJU,WAAgC,MAAM,iBAAiB,EAC3E,QAAQ,MAAM,OAChB,CAAC,GAEmB,QAAQ;CAC9B,GAAG;EAAC,MAAM;EAAiB,MAAM;EAAQ;CAAW,CAAC;CAErD,gBAAgB;EACd,YAAiB,EAAE,YAAY,CAAC,CAAC;CACnC,GAAG,CAAC,WAAW,CAAC;CAGhB,MAAM,WADO,WAAW,eAAe,WAAW,eACzB,CAAC,MAAM,UAAU,CAAC,MAAM;CACjD,MAAM,eAAe;CAErB,OACE,qBAAC,OAAD;EACE,WAAW,GACT,kEACA,MAAM,OACF,6CACA,wCACN;EACA,aAAW,aAAa,UAAU;YAPpC;GASE,oBAAC,OAAD;IAAK,WAAU;cACb,oBAAC,QAAD;KAAM,WAAU;eACb,MAAM,SAAS,EAAE,cAAc,MAAM;IAClC,CAAA;GACH,CAAA;GACL,oBAAC,OAAD;IAAK,WAAU;cACb,oBAAC,aAAD,EAAuB,SAAW,CAAA;GAC/B,CAAA;GACJ,eACC,oBAAC,OAAD;IAAK,WAAU;cACZ;GACE,CAAA,IACH;GACJ,oBAAC,aAAD;IACY;IACV,UAAU;IACV,aAAa,MAAM,eAAe,KAAA;GACnC,CAAA;EACE;;AAET"}