Warp Matrix changelog
Update with composer update qalainau/filament-warp-matrix, then run php artisan filament:assets.
1.0.0 Nov 20, 2026
Added
Matrixform field: a row × column grid with one value where the axes meet — stock by size and color, prices by quantity and customer rank, permissions by role. Saved as[row key => [column key => value]]in a JSON column. Keys of axes that were removed are kept unlesspruneUnknownKeys().- Axes:
rows()andcolumns()from arrays, nested arrays (groups with a two-level header), collections, queries, relationships, model classes (label,key,group,description) or closures that follow other fields withGet. Axes made from models are limited to the current tenant (scopeAxesToTenant(false)to stop it).rowHeaderLabel()andemptyStateText(). - Cells:
numeric()(decimals,min,max, typed and pasted the way the language writes numbers),text(),checkbox()andselect(), withprefix(),suffix(),cellPlaceholder(),cellWidth()andmaxHeight(). - Checkbox grids:
bulkToggleable()(click a heading to check a whole row or column) andexclusivePerRow()/exclusivePerColumn(). - Cells that can't be typed in, and combinations that don't exist:
disabledCells()keeps the stored value, and the server does not accept a change;hiddenCells()are never read, saved or counted. - Totals:
totals(),totalsUsing()(sum, average, count, min, max) andtotalLabel(), updated as people type. - Row and column keys with dots (
products.view) work everywhere. While the value is on the Livewire component, the keys are written with.as~dand~as~t, so that the browser's changes reach the right cell; what is saved and whatgetState()returns use the keys as they are.decodeState()turns the live state ofafterStateUpdated()or$get()back. - Typing aids: keyboard movement, pasting a range from Excel or Google Sheets (with a count of what was left out), a Copy table button, filling a row, a column or the whole table with one value, and highlighting of the row and column you are in. Each can be turned off with
keyboardNavigation(),pasteable(),copyable()andfillable(). - One row per cell:
relationship()saves to aHasManyorMorphManyrelationship — one row per cell, in one transaction, only the cells that changed, through Eloquent models.mutateCellDataUsing()adds attributes to new rows, andmodifyQueryUsingnarrows the rows. MatrixStoreandMatrixSaveResult: read and write cell rows from a page without a record (a settings page, role × permission), andMatrix::store()/saveToStore()to connect it to the field. Tenant-aware (scopeToTenant()).- Validation: the cell type is checked on the server, plus
required()andcellRules(). Cells with a problem get a red border, and the message names the cell ("M × Red: enter 0 or more."). MatrixEntry: the same table read-only for infolists, with totals calculated on the server,cellColor(),heatmap()andemptyCellText().- On a narrow screen, a soft shadow on the edge of the table shows that it scrolls sideways (form field and
MatrixEntry, light and dark). - Works in resource forms, action modals,
Repeateritems,Wizardsteps and tabs. - Laravel Boost guidelines and skill (
warp-matrix-development). - The interface in English, Japanese, German, French, Spanish, Italian, Brazilian Portuguese, Korean and Chinese (simplified and traditional).