Issue Codes

Every kernel of the engine reports a problem in one shape: Issue. Wording is not in the model: code is the stable key to branch on, params carries the values a sentence needs, and the UI layer looks the sentence up in the catalogue by code. So a host can branch on a code (to handle one kind of failure its own way) and reword by key (wording).

Guides: Writing a Definition (reading and fixing what admit reports); Fitting the View Engine into a Host (rewording by key).

Issue

• severity: error blocks apply and save; warning is reported without blocking — something is wrong, or the answer could be misread; note is something true about the answer a reader should know, with nothing wrong — the groups a view's own limit left out, say.
• path: where it is in the config, such as ['sort', 0, 'field'].
• params: the values a sentence needs. A number is a quantity, printed the way every other number on the surface is; a number that is a name (an id, a year, a row key) is handed over as a string and left as it came.

/ui's formatIssue(messages, issue, locale?) says one issue as a sentence; formatMessage fills one key's params.

export interface Issue {
  code: string;
  params?: Record<string, string | number>;
  path: IssuePath;
  severity: IssueSeverity;
}
export type IssueSeverity = 'error' | 'warning' | 'note';
export type IssuePath = (string | number)[];

Codes are public surface

The tables below are test/surface/issues.txt — every code the engine can raise — with the default wording the English catalogue gives each. Renaming or removing a code is a breaking change like removing an export, made only in a minor release and listed in its release notes; adding one is free.

The list holds the codes issue('…') raises directly and those raised through a helper: defineView's admission findings (definition.field.undescribed, definition.field.unlabelled, the definition.field.*-wider warnings and the rest), a board click's warnings, the base code of a failed command (view.open.failed and its kin).

A failed command's code may carry a suffix. When the store or a write fails, the engine appends what happened to the command's base code: the store's outcome .conflict, .not_found, .forbidden, .invalid, .unavailable, .unavailable.server, .unsupported, or the write's state .conflict, .unknown — view.open.failed.not_found, for one. The tables list only the combinations the catalogue words on their own; the rest fall back along the dots to the base code's sentence. So branch on a failure by prefix: issue.code.startsWith('view.open.failed').

{field}, {max} and the like in the wording are params placeholders; plural forms such as -one are not codes, and a count picks them.

analysis.*

Code	Default wording
analysis.alias.duplicate	The display name {alias} is used twice.
analysis.alias.invalid	{alias} is not a usable display name.
analysis.alias.not-a-segment	{alias} cannot contain a dot.
analysis.alias.reserved	{alias} uses a reserved prefix.
analysis.any.undeclared	{field} cannot be shown as a sample value.
analysis.capability.missing	{definition} does not offer an analysis view any more.
analysis.column.duplicate	This result lists {alias} twice.
analysis.column.unknown-alias	There is no {alias} in this result.
analysis.config.malformed	This analysis has no usable shape.
analysis.constant.not-finite	A constant must be a finite number.
analysis.count.undeclared	This dataset does not offer a record count.
analysis.date-diff.not-time	{field} holds no time a duration could run from or to.
analysis.date-diff.unit-unsupported	A time between two moments cannot be measured in {unit} here.
analysis.derived.currency-invalid	That is not a currency code.
analysis.derived.currency-unknown	Its operands are in no one currency: choose the currency it is in.
analysis.derived.decimals	Decimals are a whole number from 0 to {max}.
analysis.derived.format-invalid	A calculated metric reads as a number, a percent or money.
analysis.derived.moment-operand	{metric} is a point in time and cannot be calculated with.
analysis.derived.unknown-metric	The derived metric refers to {metric}, which is not declared before it.
analysis.distinctCount.undeclared	{field} does not offer distinct counts.
analysis.element.out-of-chain	The expansion of {path} belongs to another level of the chain.
analysis.element.undeclared	The expansion of {path} is not available.
analysis.elementFilter.empty	This filter has no conditions, so every item is expanded.
analysis.elementFilter.incomplete	Give {field} a value, or every item is expanded.
analysis.elementFilter.search	A search cannot decide which items are expanded: take {field} out of this condition.
analysis.elements.too-many	Too many expansions for this dataset.
analysis.expression.date-operand	{field} is a date and cannot be calculated with.
analysis.expression.divide-by-zero	This expression divides by zero.
analysis.expression.malformed	This metric has no usable expression.
analysis.expression.operand-unsupported	The source cannot calculate with {field}.
analysis.expression.too-deep	The expression nests deeper than {max} levels.
analysis.expression.too-many-nodes	The expressions exceed {max} entries.
analysis.expressions.undeclared	This dataset does not offer computed expressions.
analysis.field.outside-scope	The field {field} sits outside the expanded scope.
analysis.field.unknown	The field {field} is not available here.
analysis.first-last.order-by-required	Inside expanded entries, an opening or closing value needs a time to order the entries by.
analysis.first-last.undeclared	{field} offers no opening or closing value.
analysis.function.unsupported	{field} cannot be summarised as {fn}.
analysis.group.blank-missing-key	The placeholder for missing values is empty.
analysis.group.blank-time-zone	The time zone is empty.
analysis.group.dense-not-alone	A gap-filling time dimension must be the only dimension.
analysis.group.dense-unsupported	The source cannot fill the gaps of a time dimension.
analysis.group.interval-not-positive	A number range must be wider than zero.
analysis.group.missing-key-unsupported	{field} cannot hold a bucket for missing values; only single-valued text fields can.
analysis.group.part-unsupported	This dimension cannot group this way: {part}.
analysis.group.unit-unsupported	This dimension cannot group this way: {unit}.
analysis.group.unsupported	{field} cannot be grouped this way: {type}.
analysis.groups.too-many	Too many dimensions for this dataset.
analysis.having.malformed	This result filter has no usable shape.
analysis.having.metric-unsupported	The source cannot keep groups by {metric}.
analysis.having.requires-group	Filtering the result needs at least one dimension.
analysis.having.too-deep	The result filter nests deeper than {max} levels.
analysis.having.too-many-nodes	The result filter exceeds {max} entries.
analysis.having.undeclared	This dataset does not offer filtering the result.
analysis.having.unknown-metric	The filter refers to {metric}, which is not a usable metric.
analysis.label.blank	The display name is empty.
analysis.limit.out-of-range	Top N groups must be a whole number from 1 to {max}.
analysis.metric.currency-unchecked	{metric} is money in each record’s own currency, which the source cannot check, so its totals may add several currencies; group by {field} to see each currency.
analysis.metric.filter-field-unsupported	The source cannot use {field} in a metric's own condition.
analysis.metric.out-of-reach	The span of {metric} lies outside the dates picked, so it does not apply and is left empty.
analysis.metric.type-unknown	The metric type {type} is not available.
analysis.metricFilter.empty	This filter has no conditions, so the metric covers every record.
analysis.metricFilter.incomplete	Give {field} a value, or the metric covers every record.
analysis.metricFilter.not-scalar	{field} has no single value for a metric filter to test.
analysis.metrics.empty	An analysis needs at least one metric.
analysis.metrics.too-many	Too many metrics for this dataset.
analysis.percentile.out-of-range	A percentile must be between 0 and 100, exclusive.
analysis.percentile.undeclared	{field} does not offer percentiles.
analysis.result.at-limit	Showing the first {limit} groups; there may be more.
analysis.result.mixed-currency	{metric}: some groups hold records in several currencies, so their amounts are not added up; group by {field} to see each currency.
analysis.result.more-groups	Showing the first {limit} groups; there are more.
analysis.sort.duplicate	The sort already orders by {alias}.
analysis.sort.metric-unsupported	The source orders groups by their dimensions only, not by {alias}.
analysis.sort.requires-group	Sorting needs at least one dimension.
analysis.sort.too-many	A result sorts by at most {max} dimensions and metrics.
analysis.sort.unknown-alias	The sort orders by {alias}, which this result does not have.
analysis.split.whole-failed	Could not fold the smaller series into “Other”, so colours repeat:

binding.*

Code	Default wording
binding.definition.unknown	A binding names {id}, which no resource registers: what it binds is lost.

capability.*

Code	Default wording
capability.analysis.count	The source does not count records.
capability.analysis.dense	The source fills no gaps in a time dimension.
capability.analysis.element-unavailable	The source cannot aggregate over the elements of {path}.
capability.analysis.expressions	The source takes no formulas or derived metrics.
capability.analysis.field-narrowed	The source does not offer {dropped} on {field}.
capability.analysis.field-unavailable	The source cannot aggregate {field}.
capability.analysis.having	The source keeps no groups by a metric.
capability.analysis.metric-sort	The source orders groups by their dimensions only.
capability.analysis.unavailable	The source can aggregate none of what the analysis declares.
capability.descriptor.disagrees	{source} refused a query ({code}) its capability descriptor {version} admits: the service and its descriptor disagree.
capability.descriptor.unavailable	The capability descriptor of {source} could not be read; its views run on the definition alone.
capability.field.alias	The definition names {path} by its alias {field}: it is read as {path}.
capability.field.deprecated	The source deprecates {field}.
capability.field.deprecated-because	The source deprecates {field}:
capability.field.not-projectable	The source does not return {field}: its column reads empty.
capability.field.operators-narrowed	The source does not admit {operators} on {field}.
capability.field.options-undescribed	{field} lists {values}, which the source does not declare.
capability.field.protected	{field} is protected: shown, never filtered, sorted or searched by.
capability.field.summary-narrowed	The source cannot take the {summaries} summary of {field}.
capability.field.temporal-mismatch	{field} is declared as {declared}, but the source keeps it as {described}: its date conditions would be written wrong.
capability.field.unfilterable	The source admits no condition on {field}.
capability.field.unknown	The source does not list {field}: it is shown, but no condition, sort or summary uses it.
capability.field.unsortable	The source does not sort by {field}.
capability.record.cursor-appended	The source ends a cursor on {appended}, not on the row key {field}.
capability.record.paging	The record view pages by {paging}, which the source does not offer.
capability.record.row-key-unsortable	The source cannot sort by the row key {field}.
capability.search.as-terms	The source matches no phrase, so {field} searches by words.
capability.search.fields-narrowed	{field} cannot search {fields} on this source.
capability.search.unavailable	The source offers no search {field} can use.

chart.*

Code	Default wording
chart.as-table	The chosen chart cannot draw this result; it shows as a table.
chart.axis.scale-unknown	This axis scale is not available.
chart.boxplot.not-five-numbers	A boxplot needs one field’s minimum, three rising percentiles and maximum, under one condition.
chart.calendar.needs-day	A calendar lays out days: its dimension must be a date by day.
chart.candlestick.needs-date	A candlestick runs along a date dimension.
chart.candlestick.not-ohlc	A candlestick needs one field’s opening value, maximum, minimum and closing value, under one condition.
chart.cartesian.percent-not-additive	A 100% stack needs metrics that add up (a record count or a sum), not {metric}.
chart.colors.invalid	This is not a colour the chart can paint with.
chart.colors.malformed	The pinned chart colours must be listed one per series or category.
chart.combo.series-type-missing	Every series of a combo chart needs its own type.
chart.derived.kind-unknown	This computed line is not available.
chart.derived.metric-not-drawn	The computed line follows {metric}, which the chart does not draw.
chart.derived.window	A moving average runs over 2 to {max} periods.
chart.family.missing	The {type} chart has no {family} settings yet.
chart.funnel.duplicate-stage	A funnel stage is listed twice.
chart.funnel.metrics-need-no-group	A funnel staged by metrics can carry no dimension.
chart.funnel.not-additive	A funnel needs a metric that adds up (a record count or a sum), not {metric}.
chart.funnel.stages-need-category	A funnel’s stages are the values of a category, not dates or number ranges.
chart.funnel.too-few-stages	A funnel needs at least two stages.
chart.gauge.empty-scale	The scale must end above where it starts.
chart.gauge.needs-no-group	A gauge can carry no dimension.
chart.gauge.not-a-number	This needs a number.
chart.group.unconsumed	The chart does not use the dimension {alias}.
chart.group.unknown	The chart uses a dimension this analysis does not have.
chart.heatmap.same-axes	A heatmap needs two different axes.
chart.map.name-invalid	The map must be named.
chart.map.needs-region	A map’s regions are the values of a dimension, not ranges or dates.
chart.metric.moment	{alias} is a point in time; a chart does not draw or compare it.
chart.metric.needs-no-group	A metric card can carry no dimension.
chart.metric.trend-alias-mismatch	The trend must use the {alias} dimension.
chart.metric.trend-needs-one-date-group	A trend needs exactly one time dimension.
chart.metric.trend-not-additive	A trend headline needs a metric that adds up, or one calculated from such metrics — not {metric}.
chart.metric.unknown	The chart uses a metric this analysis does not have.
chart.parallel.duplicate-metric	Parallel coordinates list one metric twice.
chart.parallel.too-few-metrics	Parallel coordinates need three metrics or more.
chart.pie.maxSlices-too-small	Keep at least two slices.
chart.pie.not-additive	A pie’s slices are shares of a whole, so it needs a metric that adds up (a record count or a sum), not {metric}.
chart.radar.duplicate-metric	A radar lists one metric twice.
chart.radar.too-few-metrics	A radar needs three metrics or more.
chart.referenceBand.order	A target band runs from a smaller number to a larger one.
chart.referenceLine.empty-axis	A reference line needs a series on its axis.
chart.referenceLine.metric-not-drawn	The reference line is taken of {metric}, which is not drawn on its axis.
chart.referenceLine.statistic-unknown	This statistic is not available.
chart.referenceLine.value-missing	A reference line stands at a number or at a statistic.
chart.sankey.not-additive	A sankey’s bands add up to what flows through, so it needs a metric that adds up (a record count or a sum), not {metric}.
chart.sankey.same-levels	A sankey lists one dimension twice.
chart.sankey.too-few-levels	A sankey needs two dimensions or more.
chart.sankey.too-many-levels	A sankey draws at most four dimensions.
chart.scatter.same-metrics	A scatter plot needs two different metrics.
chart.splitBy.needs-one-series	A split chart shows exactly one metric.
chart.splitBy.same-as-x	The split cannot repeat the horizontal axis.
chart.sunburst.not-additive	A sunburst’s parts add up to their parent, so it needs a metric that adds up (a record count or a sum), not {metric}.
chart.sunburst.same-levels	A sunburst lists one dimension twice.
chart.sunburst.too-few-levels	A sunburst needs two dimensions or more.
chart.sunburst.too-many-levels	A sunburst draws at most four dimensions.
chart.themeRiver.needs-date	A theme river runs along a date dimension.
chart.themeRiver.not-additive	A theme river stacks its streams, so it needs a metric that adds up (a record count or a sum), not {metric}.
chart.themeRiver.same-axes	A theme river needs two different dimensions.
chart.tree.not-additive	A tree’s parts add up to their parent, so it needs a metric that adds up (a record count or a sum), not {metric}.
chart.tree.same-levels	A tree lists one dimension twice.
chart.tree.too-few-levels	A tree needs two dimensions or more.
chart.tree.too-many-levels	A tree draws at most four dimensions.
chart.treemap.not-additive	A treemap’s tiles are parts of a whole, so it needs a metric that adds up (a record count or a sum), not {metric}.
chart.treemap.same-levels	A treemap needs two different levels.
chart.type.unknown	This chart type is not available.
chart.waterfall.not-additive	A waterfall adds up its steps, so it needs a metric that adds up (a record count or a sum), not {metric}.

config.*

Code	Default wording
config.filter.invalid	The conditions of this view could not be read.
config.filterMode.not-simple	These conditions need the advanced editor to be shown in full.
config.filterMode.unknown	This view has an unknown filter mode.
config.invalid	This view could not be read.
config.refresh.missing	This view has no refresh setting.
config.refresh.not-an-integer	The refresh interval must be whole seconds.
config.refresh.too-long	The refresh interval cannot exceed {max} seconds.
config.refresh.too-short	The refresh interval must be at least {min} seconds.

dashboard.*

Code	Default wording
dashboard.binding.global-duplicate	{field} is mapped twice on this panel.
dashboard.binding.global-unknown	{field} is not a filter field of this dashboard.
dashboard.binding.kind-mismatch	A {global} field cannot filter a {panel} field.
dashboard.binding.missing	This panel does not carry the {field} filter, so it cannot be filtered with the others.
dashboard.binding.panel-unknown	“{filter}” is wired to a field the view this panel shows does not have.
dashboard.click.board-dimension-unknown	The click carries {field} to another dashboard, which this panel no longer groups by; pressing it opens the follow-up menu.
dashboard.click.board-filter-mismatch	“{filter}” on the dashboard a press opens cannot take {field}; pressing it opens the follow-up menu.
dashboard.click.board-filter-unknown	The dashboard a press opens no longer has the filter “{filter}”; pressing it opens the follow-up menu.
dashboard.click.board-gone	The dashboard a press opens was deleted, or you may not open it; pressing it opens the follow-up menu.
dashboard.click.board-not-a-board	What the click opens is not a dashboard; pressing it opens the follow-up menu.
dashboard.click.board-source-unknown	The click carries this dashboard’s filter “{filter}” to another dashboard, but this dashboard no longer has it; pressing it opens the follow-up menu.
dashboard.click.destination-unavailable	The view a press goes to was deleted, or you may not open it.
dashboard.click.destination-unsupported	A view destination is a record or an analysis view; for a dashboard, choose “Dashboard”.
dashboard.click.filter-ungrouped	This panel does not group by {field}, which “{filter}” is wired to, so a press has no value for it; pressing it opens the follow-up menu.
dashboard.click.filter-unknown	The filter this panel’s click sets is no longer on the dashboard; pressing it opens the follow-up menu.
dashboard.click.filter-unwired	“{filter}” is not wired to this panel, so a press cannot set it; pressing it opens the follow-up menu.
dashboard.click.invalid	This panel’s click setting cannot be read; pressing it opens the follow-up menu.
dashboard.click.unpressable	This panel has no groups to press — a record view, or an analysis over expanded elements — so its click setting does nothing.
dashboard.click.url-unknown-field	The click’s address names {field}, which this panel does not group by; pressing it opens the follow-up menu.
dashboard.click.url-unsafe	The click’s address is not http, https, mailto or inside this application; pressing it opens the follow-up menu.
dashboard.click.view-not-a-view	What a press goes to is not a record or an analysis view; pressing it opens the follow-up menu.
dashboard.click.view-undeclared	“{definition}” has no view like the one a press goes to; pressing it opens the follow-up menu.
dashboard.click.view-unknown	The view a press goes to cannot be found in this application; pressing it opens the follow-up menu.
dashboard.field.duplicate	The filter field {field} is declared twice.
dashboard.field.name-empty	A filter field needs a name.
dashboard.field.name-invalid	{field} is not a usable field name.
dashboard.field.not-multiple	The filter {field} takes one value, and this holds several.
dashboard.field.not-one-day	The filter {field} holds one day: a day off the calendar, or today, yesterday or the day before.
dashboard.field.one-day-not-date	The filter {field} is not a date filter, so it cannot be held to one day.
dashboard.field.options-empty	The filter {field} picks from a list of its own, and the list is empty.
dashboard.field.required-no-default	The filter {field} always has a value, so it needs a default to start at.
dashboard.fields.too-many	A dashboard holds at most {max} filters.
dashboard.filter.held	The page holds the filter {field}; it cannot be changed here.
dashboard.filter.unknown	This dashboard has no filter {field}.
dashboard.grid.unsupported	This dashboard is laid out on a grid that cannot be drawn here; panels are placed on {columns} columns.
dashboard.grouping.kept	This panel keeps its own time grouping: its data cannot be grouped the way the dashboard is.
dashboard.grouping.unit-duplicate	The time grouping offers {unit} twice.
dashboard.grouping.unit-unknown	{unit} is not a time grouping this dashboard offers.
dashboard.grouping.units-empty	The time grouping offers nothing to choose from.
dashboard.heading.too-long	A heading holds at most {max} characters.
dashboard.layout.invalid	This panel has an unusable position or size.
dashboard.layout.missing	This panel has no position.
dashboard.layout.out-of-grid	This panel reaches past the {columns} columns of the grid.
dashboard.link.label-empty	A link needs a label.
dashboard.links.too-many	A links panel holds at most {max} links.
dashboard.markdown.too-long	A text panel holds at most {max} characters.
dashboard.panel.definition-unknown	The data the analysis in this panel was built on is no longer available.
dashboard.panel.failed	The view this panel shows could not be opened.
dashboard.panel.id-duplicate	Two panels share the id {id}.
dashboard.panel.id-empty	A panel needs an id.
dashboard.panel.kind-unsupported	This panel points at something that is not a record or analysis view.
dashboard.panel.not-owned	Only an analysis that lives in this dashboard can be saved as a view.
dashboard.panel.not-referenced	This panel does not show a saved view you have open, so there is nothing to copy.
dashboard.panel.opens-elsewhere	The view this panel was set to open in the workbench, “{view}”, is over “{definition}”, not this panel's data, so it opens the panel's own view.
dashboard.panel.opens-invalid	The view this panel was set to open in the workbench is not named properly, so it opens the panel's own view.
dashboard.panel.opens-undeclared	“{definition}” has no view like the one this panel was set to open in the workbench, so it opens the panel's own view.
dashboard.panel.opens-unknown	The view this panel was set to open in the workbench cannot be found in this application, so it opens the panel's own view.
dashboard.panel.owned-invalid	The analysis this panel holds is not in the expected shape.
dashboard.panel.presentation-dropped	How this panel was set to look no longer fits its view, so it shows the view's own look.
dashboard.panel.scope-too-narrow	The view this panel shows is not open to everyone who reads this dashboard.
dashboard.panel.source-invalid	This panel should show either a saved view or an analysis of its own.
dashboard.panel.tab-unknown	This panel is on no tab of this dashboard, so it is shown on the first.
dashboard.panel.unavailable	The view this panel shows was deleted, or you do not have access to it.
dashboard.panel.unknown-kind	This type of panel is not available.
dashboard.panel.view-undeclared	“{definition}” has no view like the one this panel shows.
dashboard.panel.view-unknown	The view this panel shows cannot be found in this application.
dashboard.panels.too-many	A dashboard holds at most {max} panels.
dashboard.scope.unsupported	A dashboard takes no outer condition: lock or hide its filters instead.
dashboard.shape.invalid	This part of the dashboard is not in the expected shape.
dashboard.system.non-system-panels	These panels reference views that are not system views; publish those as system views first:
dashboard.tab.id-duplicate	Two tabs share the id {id}.
dashboard.tab.id-empty	A tab needs an id.
dashboard.tab.title-empty	A tab has no name, so it is called by its place.
dashboard.tabs.too-many	A dashboard holds at most {max} tabs.
dashboard.url.unsupported-scheme	Only http, https, mailto and relative links can be shown.
dashboard.width.unknown	This dashboard’s width “{width}” is not one this release knows, so it is shown full width. Choose fixed width or full width while editing.

definition.*

Code	Default wording
definition.analysis.date-part-not-temporal	{field} offers grouping by weekday or hour, but holds no date or time.
definition.analysis.date-part-unknown	{field} declares an unknown calendar part: {value}.
definition.analysis.default-limit-too-large	The default row limit exceeds the maximum.
definition.analysis.element-field-unknown	{path} declares no field named {field}.
definition.analysis.element-undeclared	The analysis expands {path}, which is not a field holding elements.
definition.analysis.elements-too-many	The analysis declares more than {max} nested levels.
definition.analysis.field-unknown	The analysis capability names {field}, which the definition does not declare.
definition.analysis.limit-invalid	An analysis limit must be a positive whole number.
definition.analysis.no-metric	The analysis capability offers no metric to start from.
definition.analysis.wider	The source does not offer {what} to analyses.
definition.descriptor.missing	No descriptor was given for the source {source}, so its capabilities go unchecked.
definition.field.analysis-wider	{field} does not offer {what} to analyses at its source.
definition.field.cell-invalid	{field} declares an unknown cell renderer: {value}.
definition.field.deprecated	{field} is deprecated by its source ({message}); say why it is kept.
definition.field.duplicate	The field {field} is declared twice.
definition.field.editor-removed	{field} declares an editor, which no longer exists; delete the member.
definition.field.element-search-fields-required	{field} searches inside an entry, so it has to name the entry fields it looks in.
definition.field.element-title-not-a-value	{field} titles its elements by {title}, which holds no value of its own to read.
definition.field.element-title-unknown	{field} titles its elements by {title}, which its elements do not declare.
definition.field.kind-unknown	The descriptor does not say what kind of value {field} holds; give it a kind.
definition.field.kind-unregistered	{field} uses the unregistered type {kind}.
definition.field.name-invalid	{field} is not a usable field name.
definition.field.not-elements	{field} is not an array whose entries the source lists.
definition.field.numeric-invalid	{field} declares a number format the engine cannot write: {value}.
definition.field.operator-wider	{field} does not take {operator} at its source.
definition.field.search-fields-unknown	{field} searches {missing}, which the definition does not declare.
definition.field.search-mode-invalid	{field} declares an unknown search mode: {value}.
definition.field.sort-wider	{field} does not sort at its source.
definition.field.string-comparison-invalid	{field} declares an unknown text comparison: {value}.
definition.field.summary-wider	{field} cannot be summarised by {fn} at its source.
definition.field.temporal-invalid	{field} declares a time storage the engine cannot write: {value}.
definition.field.temporal-misplaced	{field} declares a time storage, but its type {kind} writes no time.
definition.field.time-precision-invalid	{field} declares an unknown time precision: {value}.
definition.field.time-precision-misplaced	{field} declares a time precision, but reads as {cell}, which has no time of day.
definition.field.tone-invalid	{field} declares an unknown option tone: {value}.
definition.field.undescribed	{field} is not a path the source’s descriptor lists.
definition.field.unlabelled	{field} has no label of its own, so it is shown by its description or its path.
definition.fieldGroup.duplicate	The group {group} is declared twice.
definition.fieldGroup.field-duplicate	The group {group} lists {field}, which is already listed under another group.
definition.fieldGroup.field-unknown	The group {group} lists {field}, which the definition does not declare.
definition.fieldGroup.invalid	A field group needs an id and a label.
definition.id.separator	A definition id cannot contain {separator}.
definition.option.undescribed	{value} is not one of the values the source lists for {field}.
definition.record.layouts-empty	The record capability offers no layout.
definition.record.max-sort-fields-invalid	The sort bound must be a whole number of fields, not {value}.
definition.record.max-window-cursor	A paging window bounds pages, and this source pages by cursor.
definition.record.max-window-invalid	The paging window must be a whole number of rows above zero, not {value}.
definition.record.paging-wider	The source does not page by {paging}.
definition.record.row-field-not-a-path	The row field {field} is a search or metadata handle, not a value a row holds.
definition.record.row-field-unknown	The row field {field} is not a declared field.
definition.record.row-key-unknown	The row key {field} is not a declared field.
definition.record.row-key-unsortable	The row key {field} must be sortable: every page is ordered by it last, so a row never shows on two pages.
definition.source.unregistered	No source is registered for {source}: register this definition with its source.
definition.text.fallback	The words in force give none for the key {key}; the engine’s starting words say it instead.
definition.text.unknown	No words are given for the key {key}.
definition.timeField.not-time	The time field {field} is not a moment.
definition.timeField.unknown	The time field {field} is not a field of the definition.
definition.view.analysis-open	The analyses this view needs come from its source: its snapshot offers none, so it opens only where the source grants some.
definition.view.id-duplicate	Two views share the id {id}.
definition.view.id-separator	A view id cannot contain {separator}.
definition.view.kind-mismatch	A {kind} view does not belong to a {definition} definition.
definition.view.owned-invalid	The analysis panel {panel} holds is incomplete or set up wrong.

export.*

Code	Default wording
export.failed	The export failed.

filter.*

Code	Default wording
filter.element.duration	A time since another moment cannot be asked of one entry.
filter.element.root-filter	{field} asks about the whole record, so it cannot be asked of one entry.
filter.field.duplicate-in-group	{field} is already a condition in this group. Nest a group to ask it something else.
filter.field.holds-no-elements	{field} holds no entries to match against.
filter.field.reference-without-source	{field} is a reference field with no candidate source declared.
filter.field.unknown	The field {field} no longer exists.
filter.group.unknown-operator	A condition group must be AND or OR.
filter.kind.failed	The condition on "{label}" couldn't be checked; ask whoever maintains this view.
filter.kind.unknown-editor	The {kind} type asks for a {input} editor, which this engine does not have.
filter.kind.unregistered	No editor is registered for the {kind} type.
filter.node.invalid	This condition could not be read.
filter.operator.unsupported	{field} does not support {operator}.
filter.presence.empty-is-missing	On this source, an empty value of {field} counts as no value.
filter.tree.too-deep	The conditions nest deeper than {max} levels.
filter.tree.too-many-nodes	The conditions exceed {max} entries.
filter.value.duration-from-not-time	{field} holds no time.
filter.value.duration-from-unknown	The earlier time {field} is not a field here.
filter.value.duration-same-time	A time cannot be measured since itself.
filter.value.expected-boolean	Choose yes or no.
filter.value.expected-date	Enter a date.
filter.value.expected-deletion-state	Choose which records to show: not deleted, deleted only, or both.
filter.value.expected-duration	A time since needs an earlier time, a comparison, an amount and a unit.
filter.value.expected-entry-list	Choose or enter one or more entries.
filter.value.expected-id	Enter an id, or pick a candidate.
filter.value.expected-id-list	Enter one or more ids.
filter.value.expected-number	Enter a number.
filter.value.expected-number-list	Enter one or more numbers.
filter.value.expected-number-range	Enter a range of two numbers.
filter.value.expected-option-list	Choose one or more options.
filter.value.expected-predicate	Describe what an entry must match.
filter.value.expected-reference-list	Choose one or more records.
filter.value.expected-string	Enter a value.
filter.value.expected-string-list	Enter one or more values.
filter.value.expected-text	Type what to search for.
filter.value.expects-one	This condition takes a single value.
filter.value.inverted-range	The range starts after it ends.
filter.value.relative-too-large	A relative window can reach at most {max} units.
filter.value.required	This condition needs a value.
filter.value.unknown-option	{values} is no longer an option.
filter.value.unknown-time-zone	{timeZone} is not a time zone this browser knows.
filter.value.unparsable-date	That date cannot be read.

record.*

Code	Default wording
record.action.unfetched	Action “{action}” reads {field}, which is not fetched for the rows of this view. List it in the definition’s record.rowFields.
record.capability.missing	{definition} does not offer a record view any more.
record.card.invalid	The card settings could not be read.
record.column.duplicate	The column {field} is listed twice.
record.column.hidden-invalid	The column {field} is switched off as {hidden}, which is not how a column is switched off.
record.column.pin-invalid	The column {field} is pinned as {pinned}, which is not how a column is pinned.
record.column.width-invalid	The column {field} is {width} wide, which is not a number of pixels.
record.detail.failed	The whole record could not be read:
record.detail.forbidden	You do not have permission to read this record.
record.field.not-a-column	{field} is a search or metadata handle, not something a row holds.
record.field.unknown	The column {field} no longer exists.
record.filter.required	This data source lists records only under a condition: add one first.
record.layout.unsupported	The {layout} layout is not available here.
record.pageSize.not-positive	The page size must be a positive number.
record.pageSize.too-large	The page size cannot exceed {max}.
record.sort.direction-invalid	The sort on {field} reads neither ascending nor descending.
record.sort.duplicate	The sort already orders by {field}.
record.sort.invalid	The sort settings could not be read.
record.sort.not-sortable	{field} cannot be sorted on.
record.sort.parallel-arrays	The source cannot sort by {fields} together: keep one of them.
record.sort.too-many	A cursor view sorts on at most {max} fields.
record.summaries.invalid	The summary settings could not be read.
record.summary.duplicate	The {fn} summary of {field} is listed twice.
record.summary.unsupported	{field} does not offer the {fn} summary.
record.table.invalid	The table settings could not be read.

runtime.*

Code	Default wording
runtime.kind.not-declared	{definition} does not offer a {kind} view.
runtime.options.unresolved	No candidate source is configured for {source}.
runtime.query.failed	Could not load the data:
runtime.query.failed.any_requires_single_value	“Any value” needs a field that holds a single value.
runtime.query.failed.array_equality	{field} cannot be compared with a whole list here; match its items instead.
runtime.query.failed.body_not_object	The service could not read the query this view sent:
runtime.query.failed.count_requires_filter	Add a condition first: the service will not count every record.
runtime.query.failed.cursor_not_allowed	{field} cannot be used to page through this data.
runtime.query.failed.cursor_sort_duplicate	The sort names {field} twice; keep it once.
runtime.query.failed.cursor_sort_too_many	The sort has too many fields to page through this data; remove some.
runtime.query.failed.element_scope_required	{field} can only be filtered inside its list, with a condition on the list's elements.
runtime.query.failed.empty_body	The service received an empty query:
runtime.query.failed.event_projection_type_required	An event's payload cannot be shown without its type; keep the event type column.
runtime.query.failed.expensive_operator_disabled	The service does not allow this costly query here:
runtime.query.failed.explicit_entry_required	The query named no entry to run against:
runtime.query.failed.filter_too_large	The conditions are more than the service accepts in one query:
runtime.query.failed.first_last_requires_order_by	“First value” and “Last value” of {field} need a field to order by here: this data has no event time in that place.
runtime.query.failed.first_last_requires_single_value	“First value” and “Last value” need a field that holds a single value; {field} may hold several.
runtime.query.failed.identity_undefined	This data defines no record identity, so it cannot be paged through or picked by id.
runtime.query.failed.incomplete_projection	The service cannot return whole records here; choose the columns to show.
runtime.query.failed.invalid_cursor	This page can no longer be continued; start again from the first page.
runtime.query.failed.invalid_json	The service could not read the query this view sent:
runtime.query.failed.invalid_request	The service refused the query:
runtime.query.failed.invalid_value	A value in this query is missing or of the wrong kind:
runtime.query.failed.metric_filter_array_field	A metric's own condition cannot use the list field {field}.
runtime.query.failed.metric_filter_element_match	A metric's own condition cannot match list elements.
runtime.query.failed.metric_filter_search	A metric's own condition cannot use search.
runtime.query.failed.missing_key_requires_string	Only a single text field can group its missing values; {field} is not one.
runtime.query.failed.model_search_unsupported	This data does not support search.
runtime.query.failed.not_collection	{field} is not a list, so it cannot be checked for being empty.
runtime.query.failed.not_projectable	{field} cannot be shown as a column of this data.
runtime.query.failed.not_single_string	{field} is not a single text value, so it cannot be checked for being empty.
runtime.query.failed.parallel_array_sort	{field} and another list field in the sort cannot be sorted by together; keep one of them.
runtime.query.failed.protected_aggregation	{field} is protected and cannot be summarised.
runtime.query.failed.protected_comparison	{field} is protected and cannot be used to filter, sort or search.
runtime.query.failed.residual_groups_exceeded	This summary has too many groups for the service to filter or sort by a metric; narrow the data first.
runtime.query.failed.size_out_of_range	The service limits how many rows one request may read:
runtime.query.failed.sort_field_duplicate	{field} is sorted by twice; keep it once.
runtime.query.failed.sort_too_many	The sort has too many fields; remove some.
runtime.query.failed.storage_unsupported	The service's storage cannot run this:
runtime.query.failed.temporal_aggregation_unsupported	{field} does not store its time as a date or a timestamp, so it cannot be grouped or measured by time.
runtime.query.failed.temporal_configuration_conflict	The relative time on {field} does not agree with how the field keeps its time:
runtime.query.failed.temporal_representation_required	{field} is not stored as a known date or time, so a relative time cannot be asked of it.
runtime.query.failed.unknown_field	The service does not know the field {field}. The view may be ahead of the data; remove the condition, column or group on it.
runtime.query.failed.unknown_property	The service does not understand part of this query; it may be older than this view engine:
runtime.query.failed.unknown_type	The service does not know an operator or metric this view uses; it may be older than this view engine:
runtime.query.failed.unknown_value	The service does not know a value this view sent:
runtime.query.failed.unsupported_capability	{field} cannot be used this way on this data:
runtime.query.failed.value_mismatch	A value is not one {field} can hold.
runtime.query.forbidden	You do not have permission to view this data.
runtime.query.queue-full	Too many queries at once; try again in a moment.
runtime.query.too-many-nodes	These conditions make a query of {count} parts; the source takes at most {max}. Remove some conditions.
runtime.query.too-many-values	One condition lists {count} values; the source takes at most {max} in one condition.
runtime.query.unreachable	Could not load the data: the server could not be reached.
runtime.source.unresolved	No source is registered for {source}.
runtime.summary.page-only	The totals query failed, so the summary adds up only the rows on this page.

view.*

Code	Default wording
view.abandon.failed	That write could not be set aside.
view.change.notify-failed	A listener on view changes failed: {reason}. The list may be a revision behind.
view.changeAudience.failed	Who this view is for could not be changed.
view.changeAudience.forbidden	You may not change who this view is for; save a copy of your own instead.
view.changeAudience.invalid	Who this view is for could not be changed:
view.changeAudience.invalid.shared-boards	This view stays shared: shared dashboards show it ({boards}).
view.changeAudience.unsupported	This view store cannot move a view between personal and shared.
view.config.invalid	Fix what this view reports before saving it.
view.config.too-large	This view is too large to save: {size} KB, where the store keeps at most {max} KB.
view.create.forbidden	You may not create views here.
view.definition.invalid	The {id} definition has {issues} problem(s) and cannot be opened.
view.definition.not-found	No definition named {id}.
view.delete.failed	This view could not be deleted.
view.delete.forbidden	You may not delete this view; ask whoever owns it to remove it.
view.field.deprecated	This view uses {field}, which its data source deprecates.
view.field.deprecated-because	This view uses {field}, which its data source deprecates:
view.list.failed	The list of views could not be loaded.
view.list.failed.unavailable	The list of views could not be loaded: the server could not be reached.
view.list.failed.unavailable.server	The list of views could not be loaded: the server could not handle it ({reason}).
view.list.failed.unsupported	The list of views could not be loaded: this server has no view store.
view.list.reserved-id	The stored view {id} uses a reserved id and was skipped.
view.open.failed	This view could not be opened.
view.open.failed.forbidden	You do not have access to this view. Ask an administrator to grant it.
view.open.failed.not_found	This view no longer exists.
view.open.failed.unavailable	This view could not be loaded: the server could not be reached.
view.open.failed.unavailable.server	This view could not be loaded: the server could not handle it ({reason}).
view.open.failed.unsupported	This view could not be loaded: this server has no view store.
view.open.not-found	No view named {id}.
view.open.other-definition	This view belongs to another page, so this page cannot show it.
view.open.wrong-kind	This view is of another kind ({kind}), so this page cannot show it.
view.preferences.default-forbidden	You may not set the default view.
view.preferences.failed	Your view preferences could not be saved.
view.preferences.load-failed	Your view preferences could not be loaded; the views are in the server’s order.
view.preferences.reorder-forbidden	You may not reorder views.
view.publish.failed	This view could not be published as a system view.
view.publish.forbidden	You may not publish system views; ask an administrator.
view.rename.failed	This view could not be renamed.
view.rename.forbidden	You may not rename this view; save a copy of your own instead.
view.resolve.failed	That conflict could not be resolved.
view.retry.failed	That write could not be retried.
view.runtime.not-owned	This view is not open here any more.
view.save-as.failed	This view could not be saved as a copy.
view.save.failed	This view could not be saved.
view.save.forbidden	You may not save changes to this view; save a copy of your own instead.
view.system.read-only	A built-in view cannot be changed ({action}).
view.title.empty	A view needs a title.
view.title.too-long	A view’s title can be at most {max} characters.
view.write.conflict	Someone else saved this view first.
view.write.conflict-unreadable	Someone else saved first, and their version could not be read.
view.write.forbidden	You may not write to this view.
view.write.in-flight	This view is already being saved; wait for that to finish.
view.write.invalid	The server refused this write:
view.write.not-a-conflict	That write is {kind}, not a conflict.
view.write.not-pending	That write is already settled.
view.write.not_found	This view no longer exists.
view.write.storage	This browser could not keep the change: its storage is full or turned off.
view.write.unavailable	The server could not be reached.
view.write.unavailable.server	The server could not handle this write:
view.write.unknown-pending	The last {action} has not been confirmed yet. Retry it or abandon it before writing again.
view.write.unsupported	This server has no view store.

The full working version

• The list and its test: test/surface/issues.txt, test/fixtures/issueCodes.ts.
• The catalogue: src/ui/messages/en.ts; Issue is src/model/issue.ts.