@lattice-php/lattice 0.2.0 → 0.4.0

package/dist/table/filter-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-values.js","names":[],"sources":["../../resources/js/table/filter-values.ts"],"sourcesContent":["import type { FilterData, Option } from \"@lattice-php/lattice/types/generated\";\n\n/**\n * Whether a table-filter value should clear the filter rather than apply it —\n * an empty string, empty list, or an object whose every member is empty.\n */\nexport function isEmptyFilterValue(value: unknown): boolean {\n  if (value == null || value === \"\") {\n    return true;\n  }\n\n  if (Array.isArray(value)) {\n    return value.length === 0;\n  }\n\n  if (typeof value === \"object\") {\n    return Object.values(value).every((member) => member == null || member === \"\");\n  }\n\n  return false;\n}\n\nexport function isActiveFilterValue(value: unknown): boolean {\n  return !isEmptyFilterValue(value);\n}\n\n/**\n * Read a string entry from a filter's loose `props` bag, falling back when the\n * key is absent or not a string.\n */\nexport function stringProp(filter: FilterData, key: string, fallback: string): string {\n  const value = filter.props[key];\n\n  return typeof value === \"string\" ? value : fallback;\n}\n\nexport function filterOptions(filter: FilterData): Option[] {\n  const value = filter.props.options;\n\n  return Array.isArray(value) ? (value as Option[]) : [];\n}\n"],"mappings":";;;;;AAMA,SAAgB,mBAAmB,OAAyB;CAC1D,IAAI,SAAS,QAAQ,UAAU,IAC7B,OAAO;CAGT,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,WAAW;CAG1B,IAAI,OAAO,UAAU,UACnB,OAAO,OAAO,OAAO,KAAK,EAAE,OAAO,WAAW,UAAU,QAAQ,WAAW,EAAE;CAG/E,OAAO;AACT;AAEA,SAAgB,oBAAoB,OAAyB;CAC3D,OAAO,CAAC,mBAAmB,KAAK;AAClC;;;;;AAMA,SAAgB,WAAW,QAAoB,KAAa,UAA0B;CACpF,MAAM,QAAQ,OAAO,MAAM;CAE3B,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAgB,cAAc,QAA8B;CAC1D,MAAM,QAAQ,OAAO,MAAM;CAE3B,OAAO,MAAM,QAAQ,KAAK,IAAK,QAAqB,CAAC;AACvD"}

package/dist/table/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","names":[],"sources":["../../resources/js/table/format.ts"],"sourcesContent":["import type { TextColumnProps } from \"@lattice/lattice/types/generated\";\nimport type { TableColumn, TableRow } from \"./types\";\n\nexport function formatCell(value: unknown, column?: TableColumn): string {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n\n  const date = (column?.props as TextColumnProps | null)?.date;\n\n  if (date) {\n    return formatDate(value, date.format ?? null);\n  }\n\n  if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n\n  return JSON.stringify(value);\n}\n\nfunction formatDate(value: unknown, format: string | null): string {\n  const date = new Date(String(value));\n\n  if (Number.isNaN(date.getTime())) {\n    return formatCell(value);\n  }\n\n  if (!format) {\n    return new Intl.DateTimeFormat(undefined, {\n      dateStyle: \"medium\",\n      timeStyle: \"short\",\n    }).format(date);\n  }\n\n  const replacements: Record<string, string> = {\n    Y: String(date.getFullYear()),\n    y: String(date.getFullYear()).slice(-2),\n    m: String(date.getMonth() + 1).padStart(2, \"0\"),\n    n: String(date.getMonth() + 1),\n    d: String(date.getDate()).padStart(2, \"0\"),\n    j: String(date.getDate()),\n    H: String(date.getHours()).padStart(2, \"0\"),\n    G: String(date.getHours()),\n    i: String(date.getMinutes()).padStart(2, \"0\"),\n    s: String(date.getSeconds()).padStart(2, \"0\"),\n  };\n\n  return format.replace(/[YymndjHGis]/g, (token) => replacements[token] ?? token);\n}\n\nexport function resolveLink(column: TableColumn, row: TableRow, value: unknown): string | null {\n  const link = (column.props as TextColumnProps | null)?.link;\n\n  if (!link) {\n    return null;\n  }\n\n  const href = link.href ?? String(value ?? \"\");\n\n  if (href === \"\") {\n    return null;\n  }\n\n  return href.replace(/\\{([^}]+)\\}/g, (_, key: string) => {\n    if (key === \"value\") {\n      return encodeURIComponent(String(value ?? \"\"));\n    }\n\n    return encodeURIComponent(String(row[key] ?? \"\"));\n  });\n}\n"],"mappings":";AAGA,SAAgB,WAAW,OAAgB,QAA8B;CACvE,IAAI,UAAU,QAAQ,UAAU,KAAA,GAC9B,OAAO;CAGT,MAAM,QAAQ,QAAQ,QAAkC;CAExD,IAAI,MACF,OAAO,WAAW,OAAO,KAAK,UAAU,IAAI;CAG9C,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAC7E,OAAO,OAAO,KAAK;CAGrB,OAAO,KAAK,UAAU,KAAK;AAC7B;AAEA,SAAS,WAAW,OAAgB,QAA+B;CACjE,MAAM,OAAO,IAAI,KAAK,OAAO,KAAK,CAAC;CAEnC,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,GAC7B,OAAO,WAAW,KAAK;CAGzB,IAAI,CAAC,QACH,OAAO,IAAI,KAAK,eAAe,KAAA,GAAW;EACxC,WAAW;EACX,WAAW;CACb,CAAC,EAAE,OAAO,IAAI;CAGhB,MAAM,eAAuC;EAC3C,GAAG,OAAO,KAAK,YAAY,CAAC;EAC5B,GAAG,OAAO,KAAK,YAAY,CAAC,EAAE,MAAM,EAAE;EACtC,GAAG,OAAO,KAAK,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;EAC9C,GAAG,OAAO,KAAK,SAAS,IAAI,CAAC;EAC7B,GAAG,OAAO,KAAK,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;EACzC,GAAG,OAAO,KAAK,QAAQ,CAAC;EACxB,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG;EAC1C,GAAG,OAAO,KAAK,SAAS,CAAC;EACzB,GAAG,OAAO,KAAK,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;EAC5C,GAAG,OAAO,KAAK,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;CAC9C;CAEA,OAAO,OAAO,QAAQ,kBAAkB,UAAU,aAAa,UAAU,KAAK;AAChF;AAEA,SAAgB,YAAY,QAAqB,KAAe,OAA+B;CAC7F,MAAM,OAAQ,OAAO,OAAkC;CAEvD,IAAI,CAAC,MACH,OAAO;CAGT,MAAM,OAAO,KAAK,QAAQ,OAAO,SAAS,EAAE;CAE5C,IAAI,SAAS,IACX,OAAO;CAGT,OAAO,KAAK,QAAQ,iBAAiB,GAAG,QAAgB;EACtD,IAAI,QAAQ,SACV,OAAO,mBAAmB,OAAO,SAAS,EAAE,CAAC;EAG/C,OAAO,mBAAmB,OAAO,IAAI,QAAQ,EAAE,CAAC;CAClD,CAAC;AACH"}
+{"version":3,"file":"format.js","names":[],"sources":["../../resources/js/table/format.ts"],"sourcesContent":["import type { ColumnPropsOf, TableColumn, TableRow } from \"./types\";\n\nexport function formatCell(value: unknown, column?: TableColumn): string {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n\n  const date = (column?.props as ColumnPropsOf<\"column.text\"> | null)?.date;\n\n  if (date) {\n    return formatDate(value, date.format ?? null);\n  }\n\n  if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n\n  return JSON.stringify(value);\n}\n\nfunction formatDate(value: unknown, format: string | null): string {\n  const date = new Date(String(value));\n\n  if (Number.isNaN(date.getTime())) {\n    return formatCell(value);\n  }\n\n  if (!format) {\n    return new Intl.DateTimeFormat(undefined, {\n      dateStyle: \"medium\",\n      timeStyle: \"short\",\n    }).format(date);\n  }\n\n  const replacements: Record<string, string> = {\n    Y: String(date.getFullYear()),\n    y: String(date.getFullYear()).slice(-2),\n    m: String(date.getMonth() + 1).padStart(2, \"0\"),\n    n: String(date.getMonth() + 1),\n    d: String(date.getDate()).padStart(2, \"0\"),\n    j: String(date.getDate()),\n    H: String(date.getHours()).padStart(2, \"0\"),\n    G: String(date.getHours()),\n    i: String(date.getMinutes()).padStart(2, \"0\"),\n    s: String(date.getSeconds()).padStart(2, \"0\"),\n  };\n\n  return format.replace(/[YymndjHGis]/g, (token) => replacements[token] ?? token);\n}\n\nexport function resolveLink(column: TableColumn, row: TableRow, value: unknown): string | null {\n  const link = (column.props as ColumnPropsOf<\"column.text\"> | null)?.link;\n\n  if (!link) {\n    return null;\n  }\n\n  const href = link.href ?? String(value ?? \"\");\n\n  if (href === \"\") {\n    return null;\n  }\n\n  return href.replace(/\\{([^}]+)\\}/g, (_, key: string) => {\n    if (key === \"value\") {\n      return encodeURIComponent(String(value ?? \"\"));\n    }\n\n    return encodeURIComponent(String(row[key] ?? \"\"));\n  });\n}\n"],"mappings":";AAEA,SAAgB,WAAW,OAAgB,QAA8B;CACvE,IAAI,UAAU,QAAQ,UAAU,KAAA,GAC9B,OAAO;CAGT,MAAM,QAAQ,QAAQ,QAA+C;CAErE,IAAI,MACF,OAAO,WAAW,OAAO,KAAK,UAAU,IAAI;CAG9C,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAC7E,OAAO,OAAO,KAAK;CAGrB,OAAO,KAAK,UAAU,KAAK;AAC7B;AAEA,SAAS,WAAW,OAAgB,QAA+B;CACjE,MAAM,OAAO,IAAI,KAAK,OAAO,KAAK,CAAC;CAEnC,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,GAC7B,OAAO,WAAW,KAAK;CAGzB,IAAI,CAAC,QACH,OAAO,IAAI,KAAK,eAAe,KAAA,GAAW;EACxC,WAAW;EACX,WAAW;CACb,CAAC,EAAE,OAAO,IAAI;CAGhB,MAAM,eAAuC;EAC3C,GAAG,OAAO,KAAK,YAAY,CAAC;EAC5B,GAAG,OAAO,KAAK,YAAY,CAAC,EAAE,MAAM,EAAE;EACtC,GAAG,OAAO,KAAK,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;EAC9C,GAAG,OAAO,KAAK,SAAS,IAAI,CAAC;EAC7B,GAAG,OAAO,KAAK,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;EACzC,GAAG,OAAO,KAAK,QAAQ,CAAC;EACxB,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG;EAC1C,GAAG,OAAO,KAAK,SAAS,CAAC;EACzB,GAAG,OAAO,KAAK,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;EAC5C,GAAG,OAAO,KAAK,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;CAC9C;CAEA,OAAO,OAAO,QAAQ,kBAAkB,UAAU,aAAa,UAAU,KAAK;AAChF;AAEA,SAAgB,YAAY,QAAqB,KAAe,OAA+B;CAC7F,MAAM,OAAQ,OAAO,OAA+C;CAEpE,IAAI,CAAC,MACH,OAAO;CAGT,MAAM,OAAO,KAAK,QAAQ,OAAO,SAAS,EAAE;CAE5C,IAAI,SAAS,IACX,OAAO;CAGT,OAAO,KAAK,QAAQ,iBAAiB,GAAG,QAAgB;EACtD,IAAI,QAAQ,SACV,OAAO,mBAAmB,OAAO,SAAS,EAAE,CAAC;EAG/C,OAAO,mBAAmB,OAAO,IAAI,QAAQ,EAAE,CAAC;CAClD,CAAC;AACH"}

package/dist/table/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../resources/js/table/index.ts"],"sourcesContent":["import { createPlugin, lazyComponent } from \"@lattice/lattice/core/registry\";\nimport type { RendererComponentModule } from \"@lattice/lattice/core/types\";\n\nexport const tableComponents = createPlugin({\n  components: {\n    // The table renders an enriched TableNode (rows/pagination/state the server\n    // hydrates onto it); the registry erases per-component node types here.\n    table: lazyComponent(\n      () => import(\"./components/table\") as unknown as Promise<RendererComponentModule<\"table\">>,\n    ),\n  },\n  name: \"lattice/table\",\n});\n"],"mappings":";;AAGA,IAAa,kBAAkB,aAAa;CAC1C,YAAY,EAGV,OAAO,oBACC,OAAO,wBACf,EACF;CACA,MAAM;AACR,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../resources/js/table/index.ts"],"sourcesContent":["import { createPlugin, lazyComponent } from \"@lattice-php/lattice/core/registry\";\nimport type { RendererComponentModule } from \"@lattice-php/lattice/core/types\";\n\nexport const tableComponents = createPlugin({\n  components: {\n    // The table renders an enriched TableNode (rows/pagination/state the server\n    // hydrates onto it); the registry erases per-component node types here.\n    table: lazyComponent(\n      () => import(\"./components/table\") as unknown as Promise<RendererComponentModule<\"table\">>,\n    ),\n  },\n  name: \"lattice/table\",\n});\n"],"mappings":";;AAGA,IAAa,kBAAkB,aAAa;CAC1C,YAAY,EAGV,OAAO,oBACC,OAAO,wBACf,EACF;CACA,MAAM;AACR,CAAC"}

package/dist/table/payload.js

@@ -11,8 +11,19 @@ function getRows(value) {
 	if (!Array.isArray(value)) return [];
 	return value.filter((row) => typeof row === "object" && row !== null && !Array.isArray(row));
 }
+var EMPTY_PAGINATION = {
+	mode: "none",
+	currentPage: null,
+	lastPage: null,
+	perPage: null,
+	total: null,
+	from: null,
+	to: null,
+	hasMore: false,
+	nextPage: null
+};
 function getPagination(value) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return EMPTY_PAGINATION;
 	return value;
 }
 function flattenColumns(columns) {
@@ -23,16 +34,26 @@ function getState(value) {
 		filters: [],
 		sorts: [],
 		page: 1,
-		perPage: 25
+		perPage: 25,
+		tableFilters: {}
 	};
 	const state = value;
 	return {
 		filters: getFilters(state.filters),
 		sorts: Array.isArray(state.sorts) ? state.sorts : [],
 		page: typeof state.page === "number" ? state.page : 1,
-		perPage: typeof state.perPage === "number" ? state.perPage : 25
+		perPage: typeof state.perPage === "number" ? state.perPage : 25,
+		tableFilters: getTableFilters(state.tableFilters)
 	};
 }
+/**
+* The wire serializes an empty filter map as `[]` and a populated one as an
+* object, so coerce both to a plain `key => value` record.
+*/
+function getTableFilters(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
+	return value;
+}
 function getRowKey(row, index) {
 	const key = row.id ?? row.uuid ?? row.key ?? index;
 	return String(key);

package/dist/table/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","names":[],"sources":["../../resources/js/table/payload.ts"],"sourcesContent":["import type { Node } from \"@lattice/lattice/core/types\";\nimport type { FilterClause, TableColumn, TablePagination, TableRow, TableState } from \"./types\";\n\nfunction getFilters(value: unknown): FilterClause[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n\n  return value.filter(\n    (clause): clause is FilterClause =>\n      typeof clause === \"object\" &&\n      clause !== null &&\n      typeof clause.field === \"string\" &&\n      typeof clause.operator === \"string\" &&\n      typeof clause.value === \"string\",\n  );\n}\n\nexport function getColumns(value: unknown): TableColumn[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n\n  return value.filter(\n    (column): column is TableColumn =>\n      typeof column === \"object\" &&\n      column !== null &&\n      \"key\" in column &&\n      \"label\" in column &&\n      typeof column.key === \"string\" &&\n      typeof column.label === \"string\",\n  );\n}\n\nexport function getRows(value: unknown): TableRow[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n\n  return value.filter(\n    (row): row is TableRow => typeof row === \"object\" && row !== null && !Array.isArray(row),\n  );\n}\n\nexport function getPagination(value: unknown): TablePagination {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return {};\n  }\n\n  return value as TablePagination;\n}\n\nexport function flattenColumns(columns: TableColumn[]): TableColumn[] {\n  return columns.flatMap((column) => [column, ...flattenColumns(column.columns ?? [])]);\n}\n\nexport function getState(value: unknown): TableState {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return {\n      filters: [],\n      sorts: [],\n      page: 1,\n      perPage: 25,\n    };\n  }\n\n  const state = value as Partial<TableState>;\n\n  return {\n    filters: getFilters(state.filters),\n    sorts: Array.isArray(state.sorts) ? state.sorts : [],\n    page: typeof state.page === \"number\" ? state.page : 1,\n    perPage: typeof state.perPage === \"number\" ? state.perPage : 25,\n  };\n}\n\nexport function getRowKey(row: TableRow, index: number): string {\n  const key = row.id ?? row.uuid ?? row.key ?? index;\n\n  return String(key);\n}\n\nexport function getRowActions(row: TableRow): Node[] {\n  return Array.isArray(row.actions) ? (row.actions as Node[]) : [];\n}\n"],"mappings":";AAGA,SAAS,WAAW,OAAgC;CAClD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACtB,OAAO,CAAC;CAGV,OAAO,MAAM,QACV,WACC,OAAO,WAAW,YAClB,WAAW,QACX,OAAO,OAAO,UAAU,YACxB,OAAO,OAAO,aAAa,YAC3B,OAAO,OAAO,UAAU,QAC5B;AACF;AAEA,SAAgB,WAAW,OAA+B;CACxD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACtB,OAAO,CAAC;CAGV,OAAO,MAAM,QACV,WACC,OAAO,WAAW,YAClB,WAAW,QACX,SAAS,UACT,WAAW,UACX,OAAO,OAAO,QAAQ,YACtB,OAAO,OAAO,UAAU,QAC5B;AACF;AAEA,SAAgB,QAAQ,OAA4B;CAClD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACtB,OAAO,CAAC;CAGV,OAAO,MAAM,QACV,QAAyB,OAAO,QAAQ,YAAY,QAAQ,QAAQ,CAAC,MAAM,QAAQ,GAAG,CACzF;AACF;AAEA,SAAgB,cAAc,OAAiC;CAC7D,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,OAAO,CAAC;CAGV,OAAO;AACT;AAEA,SAAgB,eAAe,SAAuC;CACpE,OAAO,QAAQ,SAAS,WAAW,CAAC,QAAQ,GAAG,eAAe,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;AACtF;AAEA,SAAgB,SAAS,OAA4B;CACnD,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,OAAO;EACL,SAAS,CAAC;EACV,OAAO,CAAC;EACR,MAAM;EACN,SAAS;CACX;CAGF,MAAM,QAAQ;CAEd,OAAO;EACL,SAAS,WAAW,MAAM,OAAO;EACjC,OAAO,MAAM,QAAQ,MAAM,KAAK,IAAI,MAAM,QAAQ,CAAC;EACnD,MAAM,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;EACpD,SAAS,OAAO,MAAM,YAAY,WAAW,MAAM,UAAU;CAC/D;AACF;AAEA,SAAgB,UAAU,KAAe,OAAuB;CAC9D,MAAM,MAAM,IAAI,MAAM,IAAI,QAAQ,IAAI,OAAO;CAE7C,OAAO,OAAO,GAAG;AACnB;AAEA,SAAgB,cAAc,KAAuB;CACnD,OAAO,MAAM,QAAQ,IAAI,OAAO,IAAK,IAAI,UAAqB,CAAC;AACjE"}
+{"version":3,"file":"payload.js","names":[],"sources":["../../resources/js/table/payload.ts"],"sourcesContent":["import type { Node } from \"@lattice-php/lattice/core/types\";\nimport type { FilterClause, TableColumn, TablePagination, TableRow, TableState } from \"./types\";\n\nfunction getFilters(value: unknown): FilterClause[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n\n  return value.filter(\n    (clause): clause is FilterClause =>\n      typeof clause === \"object\" &&\n      clause !== null &&\n      typeof clause.field === \"string\" &&\n      typeof clause.operator === \"string\" &&\n      typeof clause.value === \"string\",\n  );\n}\n\nexport function getColumns(value: unknown): TableColumn[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n\n  return value.filter(\n    (column): column is TableColumn =>\n      typeof column === \"object\" &&\n      column !== null &&\n      \"key\" in column &&\n      \"label\" in column &&\n      typeof column.key === \"string\" &&\n      typeof column.label === \"string\",\n  );\n}\n\nexport function getRows(value: unknown): TableRow[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n\n  return value.filter(\n    (row): row is TableRow => typeof row === \"object\" && row !== null && !Array.isArray(row),\n  );\n}\n\nconst EMPTY_PAGINATION: TablePagination = {\n  mode: \"none\",\n  currentPage: null,\n  lastPage: null,\n  perPage: null,\n  total: null,\n  from: null,\n  to: null,\n  hasMore: false,\n  nextPage: null,\n};\n\nexport function getPagination(value: unknown): TablePagination {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return EMPTY_PAGINATION;\n  }\n\n  return value as TablePagination;\n}\n\nexport function flattenColumns(columns: TableColumn[]): TableColumn[] {\n  return columns.flatMap((column) => [column, ...flattenColumns(column.columns ?? [])]);\n}\n\nexport function getState(value: unknown): TableState {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return {\n      filters: [],\n      sorts: [],\n      page: 1,\n      perPage: 25,\n      tableFilters: {},\n    };\n  }\n\n  const state = value as Partial<TableState>;\n\n  return {\n    filters: getFilters(state.filters),\n    sorts: Array.isArray(state.sorts) ? state.sorts : [],\n    page: typeof state.page === \"number\" ? state.page : 1,\n    perPage: typeof state.perPage === \"number\" ? state.perPage : 25,\n    tableFilters: getTableFilters(state.tableFilters),\n  };\n}\n\n/**\n * The wire serializes an empty filter map as `[]` and a populated one as an\n * object, so coerce both to a plain `key => value` record.\n */\nfunction getTableFilters(value: unknown): Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return {};\n  }\n\n  return value as Record<string, unknown>;\n}\n\nexport function getRowKey(row: TableRow, index: number): string {\n  const key = row.id ?? row.uuid ?? row.key ?? index;\n\n  return String(key);\n}\n\nexport function getRowActions(row: TableRow): Node[] {\n  return Array.isArray(row.actions) ? (row.actions as Node[]) : [];\n}\n"],"mappings":";AAGA,SAAS,WAAW,OAAgC;CAClD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACtB,OAAO,CAAC;CAGV,OAAO,MAAM,QACV,WACC,OAAO,WAAW,YAClB,WAAW,QACX,OAAO,OAAO,UAAU,YACxB,OAAO,OAAO,aAAa,YAC3B,OAAO,OAAO,UAAU,QAC5B;AACF;AAEA,SAAgB,WAAW,OAA+B;CACxD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACtB,OAAO,CAAC;CAGV,OAAO,MAAM,QACV,WACC,OAAO,WAAW,YAClB,WAAW,QACX,SAAS,UACT,WAAW,UACX,OAAO,OAAO,QAAQ,YACtB,OAAO,OAAO,UAAU,QAC5B;AACF;AAEA,SAAgB,QAAQ,OAA4B;CAClD,IAAI,CAAC,MAAM,QAAQ,KAAK,GACtB,OAAO,CAAC;CAGV,OAAO,MAAM,QACV,QAAyB,OAAO,QAAQ,YAAY,QAAQ,QAAQ,CAAC,MAAM,QAAQ,GAAG,CACzF;AACF;AAEA,IAAM,mBAAoC;CACxC,MAAM;CACN,aAAa;CACb,UAAU;CACV,SAAS;CACT,OAAO;CACP,MAAM;CACN,IAAI;CACJ,SAAS;CACT,UAAU;AACZ;AAEA,SAAgB,cAAc,OAAiC;CAC7D,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,OAAO;CAGT,OAAO;AACT;AAEA,SAAgB,eAAe,SAAuC;CACpE,OAAO,QAAQ,SAAS,WAAW,CAAC,QAAQ,GAAG,eAAe,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;AACtF;AAEA,SAAgB,SAAS,OAA4B;CACnD,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,OAAO;EACL,SAAS,CAAC;EACV,OAAO,CAAC;EACR,MAAM;EACN,SAAS;EACT,cAAc,CAAC;CACjB;CAGF,MAAM,QAAQ;CAEd,OAAO;EACL,SAAS,WAAW,MAAM,OAAO;EACjC,OAAO,MAAM,QAAQ,MAAM,KAAK,IAAI,MAAM,QAAQ,CAAC;EACnD,MAAM,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;EACpD,SAAS,OAAO,MAAM,YAAY,WAAW,MAAM,UAAU;EAC7D,cAAc,gBAAgB,MAAM,YAAY;CAClD;AACF;;;;;AAMA,SAAS,gBAAgB,OAAyC;CAChE,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,OAAO,CAAC;CAGV,OAAO;AACT;AAEA,SAAgB,UAAU,KAAe,OAAuB;CAC9D,MAAM,MAAM,IAAI,MAAM,IAAI,QAAQ,IAAI,OAAO;CAE7C,OAAO,OAAO,GAAG;AACnB;AAEA,SAAgB,cAAc,KAAuB;CACnD,OAAO,MAAM,QAAQ,IAAI,OAAO,IAAK,IAAI,UAAqB,CAAC;AACjE"}

package/dist/table/query.d.ts

@@ -1,3 +1,4 @@
+import { ColumnWidth } from '../types/generated';
 import { TableColumn, TableSort, TableState } from './types';
 export declare function getColumnSort(state: TableState, column: TableColumn): TableSort | undefined;
 export declare function getColumnAriaSort(sort: TableSort | undefined): "ascending" | "descending" | undefined;
@@ -8,4 +9,12 @@ export declare function operatorLabel(operator: string): string;
 export declare function getSortDirectionLabel(direction: string): string;
 export declare function nextSort(sorts: TableSort[], column: TableColumn): TableSort[];
 export declare function getVisiblePages(currentPage: number, lastPage: number): number[];
-export declare function getColumnGridTemplate(columns: TableColumn[], hasActions: boolean, hasSelection: boolean): string;
+export declare function getTableSizingColumns(columns: TableColumn[]): {
+    key: string;
+    label: string;
+    width: ColumnWidth;
+}[];
+export declare function getTableUtilityTracks(hasActions: boolean, hasSelection: boolean): {
+    leadingTracks: string[];
+    trailingTracks: string[];
+};

package/dist/table/query.js

@@ -1,4 +1,5 @@
 import { translate } from "../i18n/instance.js";
+import "../core/column-sizing.js";
 //#region resources/js/table/query.ts
 function getColumnSort(state, column) {
 	return state.sorts.find((currentSort) => currentSort.key === column.key);
@@ -11,14 +12,57 @@ function buildEndpoint(endpoint, state) {
 	const url = new URL(endpoint, window.location.origin);
 	if (state.filters.length > 0) url.searchParams.set("filter", serializeFilters(state));
 	if (state.sorts.length > 0) url.searchParams.set("sort", serializeSorts(state));
+	appendTableFilters(url, state.tableFilters);
 	url.searchParams.set("page", String(state.page));
 	url.searchParams.set("per_page", String(state.perPage));
 	return `${url.pathname}${url.search}`;
 }
+/**
+* Serialize the dedicated table filters as Laravel-native bracket params:
+* `tf[key]=v`, repeated `tf[key][]=v` for multi-value, and `tf[key][sub]=v`
+* for structured values (e.g. a date range's from/until). Empty values are
+* dropped so an unset filter never reaches the server.
+*/
+function appendTableFilters(url, tableFilters) {
+	for (const [key, value] of Object.entries(getTableFilterParams(tableFilters))) {
+		if (typeof value === "string") {
+			url.searchParams.set(`tf[${key}]`, value);
+			continue;
+		}
+		if (Array.isArray(value)) {
+			for (const item of value) if (item != null && item !== "") url.searchParams.append(`tf[${key}][]`, String(item));
+			continue;
+		}
+		if (typeof value === "object" && value !== null) for (const [subKey, subValue] of Object.entries(value)) url.searchParams.set(`tf[${key}][${subKey}]`, String(subValue));
+	}
+}
+function getTableFilterParams(tableFilters) {
+	const params = {};
+	for (const [key, value] of Object.entries(tableFilters)) {
+		const normalized = normalizeTableFilterValue(value);
+		if (normalized !== void 0) params[key] = normalized;
+	}
+	return params;
+}
+function normalizeTableFilterValue(value) {
+	if (value == null || value === "") return;
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) {
+		const items = value.filter((item) => item != null && item !== "").map(String);
+		return items.length > 0 ? items : void 0;
+	}
+	if (typeof value === "object") {
+		const entries = Object.entries(value).filter(([, subValue]) => subValue != null && subValue !== "").map(([subKey, subValue]) => [subKey, String(subValue)]);
+		return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+	}
+	return String(value);
+}
 function getQueryParams(state) {
 	const params = {};
 	if (state.filters.length > 0) params.filter = serializeFilters(state);
 	if (state.sorts.length > 0) params.sort = serializeSorts(state);
+	const tableFilters = getTableFilterParams(state.tableFilters);
+	if (Object.keys(tableFilters).length > 0) params.tf = tableFilters;
 	return params;
 }
 function serializeFilters(state) {
@@ -70,13 +114,23 @@ function getVisiblePages(currentPage, lastPage) {
 	const start = Math.max(1, Math.min(currentPage - 2, lastPage - 4));
 	return Array.from({ length: 5 }, (_, index) => start + index);
 }
-function getColumnGridTemplate(columns, hasActions, hasSelection) {
-	const tracks = columns.map((column) => column.type === "stack" ? "minmax(13rem, 2fr)" : "minmax(7rem, 1fr)");
-	if (hasActions) tracks.push("10rem");
-	if (hasSelection) tracks.unshift("3rem");
-	return tracks.join(" ");
+function getTableSizingColumns(columns) {
+	return columns.map((column) => ({
+		key: column.key,
+		label: column.label,
+		width: columnWidthOrDefault(column)
+	}));
+}
+function columnWidthOrDefault(column) {
+	return column.width ?? (column.type === "column.stack" ? "xl" : "md");
+}
+function getTableUtilityTracks(hasActions, hasSelection) {
+	return {
+		leadingTracks: hasSelection ? ["3rem"] : [],
+		trailingTracks: hasActions ? ["10rem"] : []
+	};
 }
 //#endregion
-export { VALUELESS_FILTER_OPERATORS, buildEndpoint, getColumnAriaSort, getColumnGridTemplate, getColumnSort, getQueryParams, getSortDirectionLabel, getVisiblePages, nextSort, operatorLabel };
+export { VALUELESS_FILTER_OPERATORS, buildEndpoint, getColumnAriaSort, getColumnSort, getQueryParams, getSortDirectionLabel, getTableSizingColumns, getTableUtilityTracks, getVisiblePages, nextSort, operatorLabel };
 
 //# sourceMappingURL=query.js.map

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/lattice/i18n\";\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  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\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  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 getColumnGridTemplate(\n  columns: TableColumn[],\n  hasActions: boolean,\n  hasSelection: boolean,\n): string {\n  const tracks: string[] = columns.map((column) =>\n    column.type === \"stack\" ? \"minmax(13rem, 2fr)\" : \"minmax(7rem, 1fr)\",\n  );\n\n  // Selection and action tracks use fixed widths, not max-content: the header,\n  // filter, and body rows are independent grids, so a content-sized track would\n  // resolve to a different width in each one, changing the free space left for\n  // the 1fr columns and drifting them out of alignment across rows.\n  if (hasActions) {\n    tracks.push(\"10rem\");\n  }\n\n  if (hasSelection) {\n    tracks.unshift(\"3rem\");\n  }\n\n  return tracks.join(\" \");\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 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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"}

package/dist/table/registry.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { ColumnPropsOf, TableColumn, TableRow } from './types';
+export type ColumnCellArgs<TType extends string = string> = {
+    /** The full wire column (key, label, type, nested columns). */
+    column: TableColumn;
+    /** The column's `props`, resolved to the type's shape. */
+    props: ColumnPropsOf<TType>;
+    row: TableRow;
+    value: unknown;
+};
+export type ColumnCellComponent<TType extends string = string> = (args: ColumnCellArgs<TType>) => ReactNode;
+export type ColumnRegistry = Record<string, ColumnCellComponent>;
+/**
+ * Registers a typed column cell, erasing the type parameter so it fits the
+ * registry. Mirrors `eagerComponent`/`lazyComponent` for the component registry:
+ * author against `ColumnCellComponent<"my.type">` for typed `props`, register
+ * through this.
+ */
+export declare function columnCell<TType extends string>(cell: ColumnCellComponent<TType>): ColumnCellComponent;

package/dist/table/registry.js

@@ -0,0 +1,14 @@
+//#region resources/js/table/registry.ts
+/**
+* Registers a typed column cell, erasing the type parameter so it fits the
+* registry. Mirrors `eagerComponent`/`lazyComponent` for the component registry:
+* author against `ColumnCellComponent<"my.type">` for typed `props`, register
+* through this.
+*/
+function columnCell(cell) {
+	return cell;
+}
+//#endregion
+export { columnCell };
+
+//# sourceMappingURL=registry.js.map

package/dist/table/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../resources/js/table/registry.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { ColumnPropsOf, TableColumn, TableRow } from \"./types\";\n\nexport type ColumnCellArgs<TType extends string = string> = {\n  /** The full wire column (key, label, type, nested columns). */\n  column: TableColumn;\n  /** The column's `props`, resolved to the type's shape. */\n  props: ColumnPropsOf<TType>;\n  row: TableRow;\n  value: unknown;\n};\n\nexport type ColumnCellComponent<TType extends string = string> = (\n  args: ColumnCellArgs<TType>,\n) => ReactNode;\n\nexport type ColumnRegistry = Record<string, ColumnCellComponent>;\n\n/**\n * Registers a typed column cell, erasing the type parameter so it fits the\n * registry. Mirrors `eagerComponent`/`lazyComponent` for the component registry:\n * author against `ColumnCellComponent<\"my.type\">` for typed `props`, register\n * through this.\n */\nexport function columnCell<TType extends string>(\n  cell: ColumnCellComponent<TType>,\n): ColumnCellComponent {\n  return cell as ColumnCellComponent;\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,WACd,MACqB;CACrB,OAAO;AACT"}

package/dist/table/types.d.ts

@@ -1,5 +1,6 @@
-import { ActionNode, ColumnData, ColumnFilter, ColumnPropsMap, ColumnType, FilterClause as WireFilterClause, Op, PaginationType, Table, TableSort } from '../types/generated';
-export type { ColumnData, ColumnFilter, ColumnType, TableSort };
+import { ResolveProps } from '../core/types';
+import { ActionNode, ColumnData, ColumnFilter, ColumnPropsMap, ColumnType, FilterClause as WireFilterClause, Op, Table, TablePagination, TableQuery, TableSort } from '../types/generated';
+export type { ColumnData, ColumnFilter, ColumnType, TablePagination, TableSort };
 export type TableColumn = ColumnData;
 export type TableRow = Record<string, unknown>;
 /**
@@ -10,22 +11,12 @@ export type TableRow = Record<string, unknown>;
 export type FilterClause = Omit<WireFilterClause, "operator"> & {
     operator: Op;
 };
-export type TableState = {
+/**
+ * The wire `TableQuery` state, with `filters` narrowed to the client `FilterClause`
+ * (known `Op` operator) instead of the wire's free-string operator.
+ */
+export type TableState = Omit<TableQuery, "filters"> & {
     filters: FilterClause[];
-    sorts: TableSort[];
-    page: number;
-    perPage: number;
-};
-export type TablePagination = {
-    currentPage?: number;
-    hasMore?: boolean;
-    lastPage?: number;
-    mode?: PaginationType;
-    nextPage?: number | null;
-    perPage?: number;
-    total?: number;
-    from?: number | null;
-    to?: number | null;
 };
 export type TableResponse = {
     data?: TableRow[];
@@ -55,9 +46,8 @@ export type TableNode = {
  */
 export interface ColumnProps {
 }
-type BuiltInColumnPropsOf<TType extends string> = TType extends keyof ColumnPropsMap ? ColumnPropsMap[TType] : never;
 /**
  * Resolves a column `type` to its props: consumer augmentations (`ColumnProps`)
  * first, then the generated built-ins, then a loose bag.
  */
-export type ColumnPropsOf<TType extends string> = TType extends keyof ColumnProps ? ColumnProps[TType] : [BuiltInColumnPropsOf<TType>] extends [never] ? Record<string, unknown> | undefined : BuiltInColumnPropsOf<TType>;
+export type ColumnPropsOf<TType extends string> = ResolveProps<ColumnProps, ColumnPropsMap, TType, Record<string, unknown> | undefined>;

package/dist/table/use-table.d.ts

@@ -1,13 +1,19 @@
+import { Option } from '../types/generated';
 import { FilterClause, TableColumn, TableNode, TableSort, TableState } from './types';
 export declare function useTable(node: TableNode): {
-    columns: import('./types').ColumnData[];
+    columns: import('../types/generated').ColumnData[];
     rows: import('./types').TableRow[];
-    pagination: import('./types').TablePagination;
+    pagination: import('../types/generated').TablePagination;
     state: TableState;
     filters: FilterClause[];
+    tableFilters: Record<string, unknown>;
     addFilter: (clause: FilterClause) => void;
     updateFilter: (index: number, clause: FilterClause) => void;
     removeFilter: (index: number) => void;
+    replaceColumnFilters: (field: string, clauses: FilterClause[]) => void;
+    setTableFilter: (key: string, value: unknown) => void;
+    resetFilters: () => void;
+    searchFilterOptions: (filterKey: string, query: string) => Promise<Option[]>;
     processing: boolean;
     hasLoaded: boolean;
     infiniteLoaderRef: import('react').RefObject<HTMLDivElement | null>;

package/dist/table/use-table.js

@@ -1,5 +1,6 @@
-import { withRefHeader } from "../core/component-ref.js";
 import { LATTICE_EVENT } from "../events/event-names.js";
+import { apiFetch, apiJson } from "../core/api.js";
+import { isEmptyFilterValue } from "./filter-values.js";
 import { getColumns, getPagination, getRows, getState } from "./payload.js";
 import { buildEndpoint, nextSort } from "./query.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
@@ -10,8 +11,10 @@ function useTable(node) {
 	const componentRef = typeof node.props?.ref === "string" ? node.props.ref : "";
 	const isLazy = node.props?.lazy === true;
 	const initialState = useMemo(() => getState(node.props?.state), [node.props?.state]);
-	const [rows, setRows] = useState(() => getRows(node.props?.data));
-	const [pagination, setPagination] = useState(() => getPagination(node.props?.pagination));
+	const initialRows = useMemo(() => getRows(node.props?.data), [node.props?.data]);
+	const initialPagination = useMemo(() => getPagination(node.props?.pagination), [node.props?.pagination]);
+	const [rows, setRows] = useState(initialRows);
+	const [pagination, setPagination] = useState(initialPagination);
 	const [state, setState] = useState(initialState);
 	const [processing, setProcessing] = useState(isLazy);
 	const [hasLoaded, setHasLoaded] = useState(!isLazy);
@@ -22,10 +25,7 @@ function useTable(node) {
 		if (!endpoint) return;
 		setProcessing(true);
 		try {
-			const result = await (await fetch(buildEndpoint(endpoint, nextState), { headers: {
-				Accept: "application/json",
-				...withRefHeader(componentRef)
-			} })).json();
+			const result = await apiJson(buildEndpoint(endpoint, nextState), { ref: componentRef });
 			const resultState = getState(result.state);
 			const resultRows = getRows(result.data);
 			setRows((currentRows) => append ? [...currentRows, ...resultRows] : resultRows);
@@ -68,6 +68,43 @@ function useTable(node) {
 	function removeFilter(index) {
 		applyFilters(state.filters.filter((_, current) => current !== index));
 	}
+	function replaceColumnFilters(field, clauses) {
+		applyFilters([...state.filters.filter((clause) => clause.field !== field), ...clauses]);
+	}
+	function setTableFilter(key, value) {
+		const next = { ...state.tableFilters };
+		if (isEmptyFilterValue(value)) delete next[key];
+		else next[key] = value;
+		const nextState = {
+			...state,
+			tableFilters: next,
+			page: 1
+		};
+		setState(nextState);
+		load(nextState);
+	}
+	function resetFilters() {
+		const nextState = {
+			...state,
+			filters: [],
+			tableFilters: {},
+			page: 1
+		};
+		setState(nextState);
+		load(nextState);
+	}
+	const searchFilterOptions = useCallback(async (filterKey, query) => {
+		if (!endpoint) return [];
+		const url = new URL(endpoint, window.location.origin);
+		url.searchParams.set("_search", filterKey);
+		url.searchParams.set("q", query);
+		const response = await apiFetch(`${url.pathname}${url.search}`, {
+			ref: componentRef,
+			throwOnError: false
+		});
+		if (!response.ok) return [];
+		return (await response.json()).options ?? [];
+	}, [endpoint, componentRef]);
 	function goToPage(page) {
 		load({
 			...state,
@@ -88,6 +125,18 @@ function useTable(node) {
 		processing,
 		state
 	]);
+	useEffect(() => {
+		setRows(initialRows);
+		setPagination(initialPagination);
+		setState(initialState);
+		setProcessing(isLazy);
+		setHasLoaded(!isLazy);
+	}, [
+		initialRows,
+		initialPagination,
+		initialState,
+		isLazy
+	]);
 	useEffect(() => {
 		if (!isLazy || hasLoaded) return;
 		load(state);
@@ -128,9 +177,14 @@ function useTable(node) {
 		pagination,
 		state,
 		filters: state.filters,
+		tableFilters: state.tableFilters,
 		addFilter,
 		updateFilter,
 		removeFilter,
+		replaceColumnFilters,
+		setTableFilter,
+		resetFilters,
+		searchFilterOptions,
 		processing,
 		hasLoaded,
 		infiniteLoaderRef,

package/dist/table/use-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-table.js","names":[],"sources":["../../resources/js/table/use-table.ts"],"sourcesContent":["import { withRefHeader } from \"@lattice/lattice/core/component-ref\";\nimport { LATTICE_EVENT, type ReloadComponentEvent } from \"@lattice/lattice/events/event-names\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { getColumns, getPagination, getRows, getState } from \"./payload\";\nimport { buildEndpoint, nextSort } from \"./query\";\nimport type {\n  FilterClause,\n  TableColumn,\n  TableNode,\n  TableResponse,\n  TableSort,\n  TableState,\n} from \"./types\";\n\nexport function useTable(node: TableNode) {\n  const columns = useMemo(() => getColumns(node.props?.columns), [node.props?.columns]);\n  const endpoint = typeof node.props?.endpoint === \"string\" ? node.props.endpoint : null;\n  const componentRef = typeof node.props?.ref === \"string\" ? node.props.ref : \"\";\n  const isLazy = node.props?.lazy === true;\n  const initialState = useMemo(() => getState(node.props?.state), [node.props?.state]);\n  const [rows, setRows] = useState(() => getRows(node.props?.data));\n  const [pagination, setPagination] = useState(() => getPagination(node.props?.pagination));\n  const [state, setState] = useState(initialState);\n  const [processing, setProcessing] = useState(isLazy);\n  const [hasLoaded, setHasLoaded] = useState(!isLazy);\n  const infiniteLoaderRef = useRef<HTMLDivElement | null>(null);\n  const currentPage = pagination.currentPage ?? state.page;\n  const isInfinite = (pagination.mode ?? \"table\") === \"infinite\";\n\n  const load = useCallback(\n    async (nextState: TableState, append = false): Promise<void> => {\n      if (!endpoint) {\n        return;\n      }\n\n      setProcessing(true);\n\n      try {\n        const response = await fetch(buildEndpoint(endpoint, nextState), {\n          headers: {\n            Accept: \"application/json\",\n            ...withRefHeader(componentRef),\n          },\n        });\n        const result = (await response.json()) as TableResponse;\n        const resultState = getState(result.state);\n        const resultRows = getRows(result.data);\n\n        setRows((currentRows) => (append ? [...currentRows, ...resultRows] : resultRows));\n        setPagination(getPagination(result.pagination));\n        setState(resultState);\n        setHasLoaded(true);\n      } finally {\n        setProcessing(false);\n      }\n    },\n    [endpoint, componentRef],\n  );\n\n  function sort(column: TableColumn): void {\n    void load({\n      ...state,\n      page: 1,\n      sorts: nextSort(state.sorts, column),\n    });\n  }\n\n  function clearSort(sort: TableSort): void {\n    void load({\n      ...state,\n      page: 1,\n      sorts: state.sorts.filter((currentSort) => currentSort.key !== sort.key),\n    });\n  }\n\n  function applyFilters(next: FilterClause[]): void {\n    const nextState = { ...state, filters: next, page: 1 };\n\n    setState(nextState);\n    void load(nextState);\n  }\n\n  function addFilter(clause: FilterClause): void {\n    applyFilters([...state.filters, clause]);\n  }\n\n  function updateFilter(index: number, clause: FilterClause): void {\n    applyFilters(state.filters.map((current, position) => (position === index ? clause : current)));\n  }\n\n  function removeFilter(index: number): void {\n    applyFilters(state.filters.filter((_, current) => current !== index));\n  }\n\n  function goToPage(page: number): void {\n    void load({\n      ...state,\n      page,\n    });\n  }\n\n  const loadMore = useCallback((): void => {\n    if (processing || !pagination.hasMore) {\n      return;\n    }\n\n    void load(\n      {\n        ...state,\n        page: pagination.nextPage ?? currentPage + 1,\n      },\n      true,\n    );\n  }, [currentPage, load, pagination.hasMore, pagination.nextPage, processing, state]);\n\n  useEffect(() => {\n    if (!isLazy || hasLoaded) {\n      return;\n    }\n\n    void load(state);\n  }, [hasLoaded, isLazy, load, state]);\n\n  useEffect(() => {\n    function reload(event: Event): void {\n      const detail = (event as ReloadComponentEvent).detail;\n\n      if (detail?.component !== node.id) {\n        return;\n      }\n\n      void load(state);\n    }\n\n    window.addEventListener(LATTICE_EVENT.reloadComponent, reload);\n\n    return () => window.removeEventListener(LATTICE_EVENT.reloadComponent, reload);\n  }, [load, node.id, state]);\n\n  useEffect(() => {\n    if (\n      !isInfinite ||\n      !pagination.hasMore ||\n      processing ||\n      !infiniteLoaderRef.current ||\n      typeof IntersectionObserver === \"undefined\"\n    ) {\n      return;\n    }\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        if (entries.some((entry) => entry.isIntersecting)) {\n          loadMore();\n        }\n      },\n      {\n        rootMargin: \"240px\",\n      },\n    );\n\n    observer.observe(infiniteLoaderRef.current);\n\n    return () => observer.disconnect();\n  }, [isInfinite, loadMore, pagination.hasMore, processing]);\n\n  return {\n    columns,\n    rows,\n    pagination,\n    state,\n    filters: state.filters,\n    addFilter,\n    updateFilter,\n    removeFilter,\n    processing,\n    hasLoaded,\n    infiniteLoaderRef,\n    sort,\n    clearSort,\n    goToPage,\n    loadMore,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-table.js","names":[],"sources":["../../resources/js/table/use-table.ts"],"sourcesContent":["import { apiFetch, apiJson } from \"@lattice-php/lattice/core/api\";\nimport { LATTICE_EVENT, type ReloadComponentEvent } from \"@lattice-php/lattice/events/event-names\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { Option } from \"@lattice-php/lattice/types/generated\";\nimport { isEmptyFilterValue } from \"./filter-values\";\nimport { getColumns, getPagination, getRows, getState } from \"./payload\";\nimport { buildEndpoint, nextSort } from \"./query\";\nimport type {\n  FilterClause,\n  TableColumn,\n  TableNode,\n  TableResponse,\n  TableSort,\n  TableState,\n} from \"./types\";\n\nexport function useTable(node: TableNode) {\n  const columns = useMemo(() => getColumns(node.props?.columns), [node.props?.columns]);\n  const endpoint = typeof node.props?.endpoint === \"string\" ? node.props.endpoint : null;\n  const componentRef = typeof node.props?.ref === \"string\" ? node.props.ref : \"\";\n  const isLazy = node.props?.lazy === true;\n  const initialState = useMemo(() => getState(node.props?.state), [node.props?.state]);\n  const initialRows = useMemo(() => getRows(node.props?.data), [node.props?.data]);\n  const initialPagination = useMemo(\n    () => getPagination(node.props?.pagination),\n    [node.props?.pagination],\n  );\n  const [rows, setRows] = useState(initialRows);\n  const [pagination, setPagination] = useState(initialPagination);\n  const [state, setState] = useState(initialState);\n  const [processing, setProcessing] = useState(isLazy);\n  const [hasLoaded, setHasLoaded] = useState(!isLazy);\n  const infiniteLoaderRef = useRef<HTMLDivElement | null>(null);\n  const currentPage = pagination.currentPage ?? state.page;\n  const isInfinite = (pagination.mode ?? \"table\") === \"infinite\";\n\n  const load = useCallback(\n    async (nextState: TableState, append = false): Promise<void> => {\n      if (!endpoint) {\n        return;\n      }\n\n      setProcessing(true);\n\n      try {\n        const result = await apiJson<TableResponse>(buildEndpoint(endpoint, nextState), {\n          ref: componentRef,\n        });\n        const resultState = getState(result.state);\n        const resultRows = getRows(result.data);\n\n        setRows((currentRows) => (append ? [...currentRows, ...resultRows] : resultRows));\n        setPagination(getPagination(result.pagination));\n        setState(resultState);\n        setHasLoaded(true);\n      } finally {\n        setProcessing(false);\n      }\n    },\n    [endpoint, componentRef],\n  );\n\n  function sort(column: TableColumn): void {\n    void load({\n      ...state,\n      page: 1,\n      sorts: nextSort(state.sorts, column),\n    });\n  }\n\n  function clearSort(sort: TableSort): void {\n    void load({\n      ...state,\n      page: 1,\n      sorts: state.sorts.filter((currentSort) => currentSort.key !== sort.key),\n    });\n  }\n\n  function applyFilters(next: FilterClause[]): void {\n    const nextState = { ...state, filters: next, page: 1 };\n\n    setState(nextState);\n    void load(nextState);\n  }\n\n  function addFilter(clause: FilterClause): void {\n    applyFilters([...state.filters, clause]);\n  }\n\n  function updateFilter(index: number, clause: FilterClause): void {\n    applyFilters(state.filters.map((current, position) => (position === index ? clause : current)));\n  }\n\n  function removeFilter(index: number): void {\n    applyFilters(state.filters.filter((_, current) => current !== index));\n  }\n\n  function replaceColumnFilters(field: string, clauses: FilterClause[]): void {\n    applyFilters([...state.filters.filter((clause) => clause.field !== field), ...clauses]);\n  }\n\n  function setTableFilter(key: string, value: unknown): void {\n    const next = { ...state.tableFilters };\n\n    if (isEmptyFilterValue(value)) {\n      delete next[key];\n    } else {\n      next[key] = value;\n    }\n\n    const nextState = { ...state, tableFilters: next, page: 1 };\n\n    setState(nextState);\n    void load(nextState);\n  }\n\n  function resetFilters(): void {\n    const nextState = { ...state, filters: [], tableFilters: {}, page: 1 };\n\n    setState(nextState);\n    void load(nextState);\n  }\n\n  const searchFilterOptions = useCallback(\n    async (filterKey: string, query: string): Promise<Option[]> => {\n      if (!endpoint) {\n        return [];\n      }\n\n      const url = new URL(endpoint, window.location.origin);\n      url.searchParams.set(\"_search\", filterKey);\n      url.searchParams.set(\"q\", query);\n\n      const response = await apiFetch(`${url.pathname}${url.search}`, {\n        ref: componentRef,\n        throwOnError: false,\n      });\n\n      if (!response.ok) {\n        return [];\n      }\n\n      const result = (await response.json()) as { options?: Option[] };\n\n      return result.options ?? [];\n    },\n    [endpoint, componentRef],\n  );\n\n  function goToPage(page: number): void {\n    void load({\n      ...state,\n      page,\n    });\n  }\n\n  const loadMore = useCallback((): void => {\n    if (processing || !pagination.hasMore) {\n      return;\n    }\n\n    void load(\n      {\n        ...state,\n        page: pagination.nextPage ?? currentPage + 1,\n      },\n      true,\n    );\n  }, [currentPage, load, pagination.hasMore, pagination.nextPage, processing, state]);\n\n  useEffect(() => {\n    setRows(initialRows);\n    setPagination(initialPagination);\n    setState(initialState);\n    setProcessing(isLazy);\n    setHasLoaded(!isLazy);\n  }, [initialRows, initialPagination, initialState, isLazy]);\n\n  useEffect(() => {\n    if (!isLazy || hasLoaded) {\n      return;\n    }\n\n    void load(state);\n  }, [hasLoaded, isLazy, load, state]);\n\n  useEffect(() => {\n    function reload(event: Event): void {\n      const detail = (event as ReloadComponentEvent).detail;\n\n      if (detail?.component !== node.id) {\n        return;\n      }\n\n      void load(state);\n    }\n\n    window.addEventListener(LATTICE_EVENT.reloadComponent, reload);\n\n    return () => window.removeEventListener(LATTICE_EVENT.reloadComponent, reload);\n  }, [load, node.id, state]);\n\n  useEffect(() => {\n    if (\n      !isInfinite ||\n      !pagination.hasMore ||\n      processing ||\n      !infiniteLoaderRef.current ||\n      typeof IntersectionObserver === \"undefined\"\n    ) {\n      return;\n    }\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        if (entries.some((entry) => entry.isIntersecting)) {\n          loadMore();\n        }\n      },\n      {\n        rootMargin: \"240px\",\n      },\n    );\n\n    observer.observe(infiniteLoaderRef.current);\n\n    return () => observer.disconnect();\n  }, [isInfinite, loadMore, pagination.hasMore, processing]);\n\n  return {\n    columns,\n    rows,\n    pagination,\n    state,\n    filters: state.filters,\n    tableFilters: state.tableFilters,\n    addFilter,\n    updateFilter,\n    removeFilter,\n    replaceColumnFilters,\n    setTableFilter,\n    resetFilters,\n    searchFilterOptions,\n    processing,\n    hasLoaded,\n    infiniteLoaderRef,\n    sort,\n    clearSort,\n    goToPage,\n    loadMore,\n  };\n}\n"],"mappings":"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"}

package/dist/toast/callout.d.ts

@@ -0,0 +1,6 @@
+import { Callout } from '../types/generated';
+export type { Callout };
+/** Coerce a raw callout value (effect detail `{ callout: {...} }`) into a Callout. */
+export declare function normalizeCallout(detail: unknown): Callout | null;
+/** Subscribe to the `lattice:callout` bus. Returns an unsubscribe function. */
+export declare function onCallout(callback: (callout: Callout) => void): () => void;

package/dist/toast/callout.js

@@ -0,0 +1,31 @@
+import { LATTICE_EVENT } from "../events/event-names.js";
+import { isVariant } from "./toast.js";
+//#region resources/js/toast/callout.ts
+/** Coerce a raw callout value (effect detail `{ callout: {...} }`) into a Callout. */
+function normalizeCallout(detail) {
+	if (typeof detail !== "object" || detail === null) return null;
+	const value = detail.callout;
+	if (typeof value !== "object" || value === null) return null;
+	const callout = value;
+	if (typeof callout.message !== "string" || callout.message === "") return null;
+	return {
+		action: callout.action ?? null,
+		dismissible: callout.dismissible !== false,
+		message: callout.message,
+		title: typeof callout.title === "string" ? callout.title : null,
+		variant: isVariant(callout.variant) ? callout.variant : "info"
+	};
+}
+/** Subscribe to the `lattice:callout` bus. Returns an unsubscribe function. */
+function onCallout(callback) {
+	const listener = (event) => {
+		const callout = normalizeCallout(event.detail);
+		if (callout) callback(callout);
+	};
+	window.addEventListener(LATTICE_EVENT.callout, listener);
+	return () => window.removeEventListener(LATTICE_EVENT.callout, listener);
+}
+//#endregion
+export { normalizeCallout, onCallout };
+
+//# sourceMappingURL=callout.js.map

package/dist/toast/callout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callout.js","names":[],"sources":["../../resources/js/toast/callout.ts"],"sourcesContent":["import type { Callout } from \"@lattice-php/lattice/types/generated\";\nimport { LATTICE_EVENT } from \"@lattice-php/lattice/events/event-names\";\nimport { isVariant } from \"@lattice-php/lattice/toast/toast\";\n\nexport type { Callout };\n\n/** Coerce a raw callout value (effect detail `{ callout: {...} }`) into a Callout. */\nexport function normalizeCallout(detail: unknown): Callout | null {\n  if (typeof detail !== \"object\" || detail === null) {\n    return null;\n  }\n\n  const value = (detail as { callout?: unknown }).callout;\n\n  if (typeof value !== \"object\" || value === null) {\n    return null;\n  }\n\n  const callout = value as Record<string, unknown>;\n\n  if (typeof callout.message !== \"string\" || callout.message === \"\") {\n    return null;\n  }\n\n  return {\n    action: (callout.action as Callout[\"action\"]) ?? null,\n    dismissible: callout.dismissible !== false,\n    message: callout.message,\n    title: typeof callout.title === \"string\" ? callout.title : null,\n    variant: isVariant(callout.variant) ? callout.variant : \"info\",\n  };\n}\n\n/** Subscribe to the `lattice:callout` bus. Returns an unsubscribe function. */\nexport function onCallout(callback: (callout: Callout) => void): () => void {\n  const listener = (event: Event): void => {\n    const callout = normalizeCallout((event as CustomEvent).detail);\n\n    if (callout) {\n      callback(callout);\n    }\n  };\n\n  window.addEventListener(LATTICE_EVENT.callout, listener);\n\n  return () => window.removeEventListener(LATTICE_EVENT.callout, listener);\n}\n"],"mappings":";;;;AAOA,SAAgB,iBAAiB,QAAiC;CAChE,IAAI,OAAO,WAAW,YAAY,WAAW,MAC3C,OAAO;CAGT,MAAM,QAAS,OAAiC;CAEhD,IAAI,OAAO,UAAU,YAAY,UAAU,MACzC,OAAO;CAGT,MAAM,UAAU;CAEhB,IAAI,OAAO,QAAQ,YAAY,YAAY,QAAQ,YAAY,IAC7D,OAAO;CAGT,OAAO;EACL,QAAS,QAAQ,UAAgC;EACjD,aAAa,QAAQ,gBAAgB;EACrC,SAAS,QAAQ;EACjB,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ;EAC3D,SAAS,UAAU,QAAQ,OAAO,IAAI,QAAQ,UAAU;CAC1D;AACF;;AAGA,SAAgB,UAAU,UAAkD;CAC1E,MAAM,YAAY,UAAuB;EACvC,MAAM,UAAU,iBAAkB,MAAsB,MAAM;EAE9D,IAAI,SACF,SAAS,OAAO;CAEpB;CAEA,OAAO,iBAAiB,cAAc,SAAS,QAAQ;CAEvD,aAAa,OAAO,oBAAoB,cAAc,SAAS,QAAQ;AACzE"}

package/dist/toast/index.d.ts

@@ -1 +1,5 @@
+export { normalizeCallout, onCallout } from './callout';
+export type { Callout } from './callout';
 export { Toaster } from './toaster';
+export { isVariant, normalizeToast, normalizeToastMessage, onToast, showToast } from './toast';
+export type { ToastMessage, Variant } from './toast';

package/dist/toast/index.js

@@ -1,2 +1,4 @@
+import { isVariant, normalizeToast, normalizeToastMessage, onToast, showToast } from "./toast.js";
+import { normalizeCallout, onCallout } from "./callout.js";
 import { Toaster } from "./toaster.js";
-export { Toaster };
+export { Toaster, isVariant, normalizeCallout, normalizeToast, normalizeToastMessage, onCallout, onToast, showToast };

package/dist/toast/toast.d.ts

@@ -0,0 +1,14 @@
+import { ToastMessage, Variant } from '../types/generated';
+export type { ToastMessage, Variant };
+export declare function isVariant(value: unknown): value is Variant;
+/**
+ * Coerce a raw toast value (server flash payload or event detail) into a
+ * ToastMessage, defaulting optional fields, or null when it is malformed.
+ */
+export declare function normalizeToastMessage(value: unknown): ToastMessage | null;
+/** Coerce a `lattice:toast` event detail (`{ toast: {...} }`) into a ToastMessage. */
+export declare function normalizeToast(detail: unknown): ToastMessage | null;
+/** Emit a toast onto the shared `lattice:toast` bus. */
+export declare function showToast(toast: ToastMessage): void;
+/** Subscribe to the shared toast bus. Returns an unsubscribe function. */
+export declare function onToast(callback: (toast: ToastMessage) => void): () => void;