@finos/legend-cube-builder 0.0.2 → 0.0.4

package/lib/stores/source-picker/CubeSourcePickerTab.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { CubeContext } from '@finos/legend-cube';
+import type { GeneratorFn } from '@finos/legend-shared';
+export declare enum CubeSourcePickerTabKey {
+    MODEL = "model",
+    DIRECT_CONNECTION = "directConnection",
+    DATA_PRODUCT = "dataProduct",
+    INGEST = "ingest",
+    PROJECT = "project"
+}
+/**
+ * A tab of the source dialog (PLAN §6.1, §6.8): one way to find a source,
+ * e.g. a model's tables or a database connection's. The dialog opens one tab
+ * at a time and runs its Add; a cube's fixed context belongs to one tab,
+ * which then is the only one enabled.
+ */
+export interface CubeSourcePickerTab {
+    readonly key: CubeSourcePickerTabKey;
+    readonly label: string;
+    /** The host serves it; a tab it doesn't serve isn't shown */
+    readonly isAvailable: boolean;
+    /** Something is loading or being typed */
+    readonly isBusy: boolean;
+    readonly canConfirm: boolean;
+    /** Whether a cube's fixed context is this tab's, e.g. its saved connection */
+    ownsContext(context: CubeContext): boolean;
+    /** When the dialog opens on the tab, or the user switches to it */
+    open(): void;
+    /** When the dialog closes: answers still on their way are dropped */
+    close(): void;
+    /** Adds the picked source; gives whether it was added */
+    confirm(): GeneratorFn<boolean>;
+}
+//# sourceMappingURL=CubeSourcePickerTab.d.ts.map

package/lib/stores/source-picker/CubeSourcePickerTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeSourcePickerTab.d.ts","sourceRoot":"","sources":["../../../src/stores/source-picker/CubeSourcePickerTab.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,iBAAiB,qBAAqB;IACtC,YAAY,gBAAgB;IAC5B,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,sBAAsB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,8EAA8E;IAC9E,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;IAC3C,mEAAmE;IACnE,IAAI,IAAI,IAAI,CAAC;IACb,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;IACd,yDAAyD;IACzD,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/lib/stores/source-picker/CubeSourcePickerTab.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export var CubeSourcePickerTabKey;
+(function (CubeSourcePickerTabKey) {
+    CubeSourcePickerTabKey["MODEL"] = "model";
+    CubeSourcePickerTabKey["DIRECT_CONNECTION"] = "directConnection";
+    CubeSourcePickerTabKey["DATA_PRODUCT"] = "dataProduct";
+    CubeSourcePickerTabKey["INGEST"] = "ingest";
+    CubeSourcePickerTabKey["PROJECT"] = "project";
+})(CubeSourcePickerTabKey || (CubeSourcePickerTabKey = {}));
+//# sourceMappingURL=CubeSourcePickerTab.js.map

package/lib/stores/source-picker/CubeSourcePickerTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeSourcePickerTab.js","sourceRoot":"","sources":["../../../src/stores/source-picker/CubeSourcePickerTab.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,CAAN,IAAY,sBAMX;AAND,WAAY,sBAAsB;IAChC,yCAAe,CAAA;IACf,gEAAsC,CAAA;IACtC,sDAA4B,CAAA;IAC5B,2CAAiB,CAAA;IACjB,6CAAmB,CAAA;AACrB,CAAC,EANW,sBAAsB,KAAtB,sBAAsB,QAMjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos/legend-cube-builder",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Legend Cube builder: the canvas UI and the Legend engine adapter of the Legend Cube query builder",
   "keywords": [
     "legend",
@@ -45,12 +45,16 @@
   },
   "dependencies": {
     "@dagrejs/dagre": "1.1.4",
-    "@finos/legend-application": "16.0.126",
-    "@finos/legend-art": "7.1.166",
-    "@finos/legend-cube": "0.0.2",
-    "@finos/legend-graph": "32.7.4",
-    "@finos/legend-lego": "2.0.228",
-    "@finos/legend-shared": "11.0.31",
+    "@finos/legend-application": "16.0.128",
+    "@finos/legend-art": "7.1.168",
+    "@finos/legend-cube": "0.0.4",
+    "@finos/legend-graph": "32.7.6",
+    "@finos/legend-lego": "2.0.230",
+    "@finos/legend-server-depot": "6.1.24",
+    "@finos/legend-server-lakehouse": "0.3.90",
+    "@finos/legend-server-marketplace": "0.2.17",
+    "@finos/legend-shared": "11.0.32",
+    "@finos/legend-storage": "3.0.154",
     "@types/react": "19.0.10",
     "@types/react-dom": "19.0.4",
     "@xyflow/react": "12.4.4",
@@ -62,7 +66,7 @@
     "serializr": "3.0.3"
   },
   "devDependencies": {
-    "@finos/legend-dev-utils": "2.2.8",
+    "@finos/legend-dev-utils": "2.2.9",
     "@jest/globals": "29.7.0",
     "@testing-library/dom": "10.4.0",
     "@testing-library/react": "16.2.0",

package/src/__lib__/LegendCubeCommand.ts

@@ -24,6 +24,7 @@ import type { CommandConfigData } from '@finos/legend-application';
 export enum LEGEND_CUBE_COMMAND_KEY {
   EXECUTE = 'legend-cube.execute',
   UNDO = 'legend-cube.undo',
+  VALIDATE_EXPRESSIONS = 'legend-cube.validate-expressions',
 }
 
 /** Keys as `KeyboardEvent.code` names */
@@ -37,6 +38,10 @@ export const LEGEND_CUBE_COMMAND_CONFIG: CommandConfigData = {
     defaultKeyboardShortcut: 'Control+KeyZ',
     additionalKeyboardShortcuts: ['Meta+KeyZ'],
   },
+  [LEGEND_CUBE_COMMAND_KEY.VALIDATE_EXPRESSIONS]: {
+    title: "Validate the Extend's expressions",
+    defaultKeyboardShortcut: 'F10',
+  },
 };
 
 /** How the buttons' tooltips name the shortcuts */

package/src/__lib__/LegendCubeDataProductLabels.ts

@@ -0,0 +1,91 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { SchemaDiff } from '@finos/legend-cube';
+import { CubeDataProductEnvironmentType } from '../graph-manager/CubeDataProduct.js';
+import { CubeAccessPointGroupAccess } from '../graph-manager/CubeDataProductCatalog.js';
+import { getSchemaChangeList } from './LegendCubeLabels.js';
+
+// The text of data product sources (PLAN §6.8): the source dialog's Data
+// product tab and a data product source's panel
+
+/** The deployment classes' labels, as Data Cube shows them */
+export const CUBE_DATA_PRODUCT_ENVIRONMENT_LABELS: Readonly<
+  Record<CubeDataProductEnvironmentType, string>
+> = {
+  [CubeDataProductEnvironmentType.PRODUCTION]: 'Production',
+  [CubeDataProductEnvironmentType.PRODUCTION_PARALLEL]: 'Production (parallel)',
+};
+
+/** Said of a project deployed from a SNAPSHOT version */
+export const CUBE_SNAPSHOT_VERSION_LABEL =
+  'A SNAPSHOT version: its data and columns may change';
+
+export const CUBE_WAREHOUSE_APPLY_TITLE =
+  "Use this warehouse for the cube's next runs; it's remembered for your next cubes";
+
+/** The warning on an access point that changed since the cube was saved; its new columns are used */
+export const getAccessPointDriftWarning = (diff: SchemaDiff): string =>
+  `This access point changed since the cube was saved: ${getSchemaChangeList(diff)}`;
+
+/** The warning on an access point Cube couldn't re-check, which keeps its saved columns */
+export const getAccessPointRecheckWarning = (firstLine: string): string =>
+  `Could not re-check this access point, so it keeps its saved columns: ${firstLine}`;
+
+export const CUBE_DATA_PRODUCT_RECHECK_MESSAGE = {
+  NO_ANSWER: 'The data product catalog gave no columns for this access point',
+  NO_CATALOG: "This Legend deployment doesn't serve data products",
+} as const;
+
+/**
+ * Beside a run's error that says the cube's warehouse can't be used; it
+ * offers another only where the warehouse can be changed
+ */
+export const getCubeWarehouseErrorHint = (
+  warehouse: string,
+  canPickAnother: boolean,
+): string =>
+  canPickAnother
+    ? `The run couldn't use the warehouse ${warehouse}. Pick another one in a source's panel.`
+    : `The run couldn't use the warehouse ${warehouse}.`;
+
+/** A link to ask for access to an access point group in the marketplace */
+export const getCubeRequestAccessLabel = (
+  accessPointGroup: string | undefined,
+  dataProductName: string | undefined,
+): string =>
+  accessPointGroup && dataProductName
+    ? `Request access to ${accessPointGroup} in ${dataProductName}`
+    : 'Request access';
+
+/**
+ * The viewer's access to a group, as the marketplace says it; a group with
+ * no access, or refused, offers to request it instead
+ */
+export const CUBE_ACCESS_POINT_GROUP_ACCESS_LABELS: Readonly<
+  Partial<Record<CubeAccessPointGroupAccess, string>>
+> = {
+  [CubeAccessPointGroupAccess.ENTERPRISE]: 'Enterprise access',
+  [CubeAccessPointGroupAccess.APPROVED]: 'Entitled',
+  [CubeAccessPointGroupAccess.SUBMITTED_FOR_APPROVALS]:
+    'Submitted for approval',
+  [CubeAccessPointGroupAccess.PENDING_MANAGER_APPROVAL]:
+    'Pending manager approval',
+  [CubeAccessPointGroupAccess.PENDING_DATA_OWNER_APPROVAL]:
+    'Pending data owner approval',
+};
+
+export const CUBE_NO_ACCESS_LABEL = 'No access';

package/src/__lib__/LegendCubeDirectConnectionLabels.ts

@@ -0,0 +1,111 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {
+  CubeConnectionDatasourceKind,
+  type CubeConnectionSummary,
+} from '../graph-manager/CubeConnectionExplorer.js';
+
+// The text of the source picker's database connection tab (PLAN §6.8)
+
+/**
+ * The setup SQL the H2 form starts with (D5): a small sample database that
+ * first drops what it creates, since setup SQL runs on every connection
+ */
+export const CUBE_DIRECT_SAMPLE_SETUP_SQL = [
+  'drop schema if exists CUBE_SAMPLE cascade;',
+  'create schema CUBE_SAMPLE;',
+  'create table CUBE_SAMPLE.CUSTOMERS (CUSTOMER_ID VARCHAR(5) PRIMARY KEY, COMPANY_NAME VARCHAR(40) NOT NULL, COUNTRY VARCHAR(15));',
+  "insert into CUBE_SAMPLE.CUSTOMERS values ('ALFKI', 'Alfreds Futterkiste', 'Germany'), ('ANATR', 'Ana Trujillo Emparedados', 'Mexico'), ('BONAP', 'Bon app''', 'France');",
+  'create table CUBE_SAMPLE.ORDERS (ORDER_ID INT PRIMARY KEY, CUSTOMER_ID VARCHAR(5) NOT NULL, ORDER_DATE DATE, AMOUNT DECIMAL(10,2));',
+  "insert into CUBE_SAMPLE.ORDERS values (10248, 'ALFKI', '1997-07-04', 32.38), (10249, 'ANATR', '1997-07-05', 11.61), (10250, 'BONAP', '1997-07-08', 65.83), (10251, 'ALFKI', '1997-07-08', 41.34);",
+].join('\n');
+
+/** Pending labels: lower-case gerunds, shown as they are (spec §17.13) */
+export enum CUBE_DIRECT_PENDING_LABEL {
+  TESTING_CONNECTION = 'testing connection',
+  LISTING_TABLES = 'listing tables',
+}
+
+export const CUBE_DIRECT_MESSAGE = {
+  H2_NEEDS_SETUP_SQL:
+    'An H2 connection needs setup SQL: the engine creates the database from it',
+  CUBE_CHANGED:
+    'The cube changed while the table was loading; pick the table again.',
+  NO_SCHEMA_FOUND: 'The database has no schema Cube can read',
+  NO_TABLE_SCHEMA: 'The engine gave no schema for this table',
+} as const;
+
+const formatCount = (value: number): string => value.toLocaleString('en-US');
+
+/** The text of loading a CSV into an in-memory DuckDB connection */
+export const CUBE_CSV_MESSAGE = {
+  EMPTY: 'The CSV is empty: its first row must name the columns',
+  UNCLOSED_QUOTE: (line: number): string =>
+    `The quoted value that starts on line ${line} is never closed`,
+  RAGGED_ROW: (row: number, values: number, columns: number): string =>
+    `Row ${formatCount(row)} has ${formatCount(values)} ${values === 1 ? 'value' : 'values'}, but the header names ${formatCount(columns)} ${columns === 1 ? 'column' : 'columns'}`,
+  TOO_MANY_ROWS: (rows: number, max: number): string =>
+    `The CSV has ${formatCount(rows)} rows; Cube loads at most ${formatCount(max)}, since the cube saves them and every run loads them again`,
+  TOO_LONG: (max: number): string =>
+    `The CSV is too long: Cube loads at most ${formatCount(max)} characters`,
+  ADDED: (table: string, rows: number, columns: number): string =>
+    `Added table ${table}: ${formatCount(rows)} ${rows === 1 ? 'row' : 'rows'}, ${formatCount(columns)} ${columns === 1 ? 'column' : 'columns'}. Test the connection to list it.`,
+  UNREADABLE_FILE: (name: string): string =>
+    `Cube couldn't read the file ${name}`,
+} as const;
+
+export const CUBE_CSV_HELP_TEXT =
+  "Paste a CSV, or choose a file, with a header row. Cube adds it to the setup SQL as a table of the csv schema, guessing each column's type from its values; edit the SQL to change them. Up to 10,000 rows: the cube saves them.";
+
+export const CUBE_DIRECT_HELP_TEXT = {
+  SETUP_SQL:
+    "The engine runs these statements on every connection, so they should first drop what they create. A statement ends with a line ending in ';'. A statement that returns rows, such as a select, fails.",
+  DUCKDB_PATH:
+    "A DuckDB file on the engine's host; leave it empty for an in-memory database.",
+  FIXED_CONNECTION:
+    "All of the cube's tables come from this connection: to use another one, remove every node from the cube first.",
+} as const;
+
+export const CUBE_DIRECT_DATASOURCE_LABELS: Readonly<
+  Record<CubeConnectionDatasourceKind, string>
+> = {
+  [CubeConnectionDatasourceKind.LOCAL_H2]:
+    "an H2 database in the engine's H2 server",
+  [CubeConnectionDatasourceKind.DUCKDB_IN_MEMORY]:
+    'an in-memory DuckDB database',
+  [CubeConnectionDatasourceKind.DUCKDB_FILE]: 'a DuckDB file',
+};
+
+/** How many of a table's columns Cube leaves out, or nothing when it keeps them all */
+export const getHiddenColumnsLabel = (count: number): string | undefined =>
+  count === 0
+    ? undefined
+    : `${count} ${count === 1 ? 'column' : 'columns'} hidden`;
+
+/** What the page shows of a saved connection: never its setup SQL */
+export const getCubeConnectionSummaryLabel = (
+  summary: CubeConnectionSummary,
+): string =>
+  [
+    `${summary.databaseType}: ${CUBE_DIRECT_DATASOURCE_LABELS[summary.datasourceKind]}${summary.path ? ` (${summary.path})` : ''}`,
+    `${summary.setupSqlCount} setup ${summary.setupSqlCount === 1 ? 'statement' : 'statements'}`,
+    `authentication ${summary.authenticationKind}`,
+  ].join(', ');
+
+/** A direct connection shown where Cube can't describe it, e.g. on a host without an explorer */
+export const CUBE_DIRECT_CONNECTION_FALLBACK_LABEL =
+  'A direct database connection';

package/src/__lib__/LegendCubeHelpText.ts

@@ -15,21 +15,65 @@
  */
 
 import {
+  Concat,
+  DataProductAccessPointSource,
+  Difference,
+  IngestDatasetSource,
+  Distinct,
+  Drop,
+  Extend,
   Filter,
+  Group,
   Join,
+  Limit,
+  Partition,
   RelationalTableSource,
+  Rename,
+  Restrict,
+  Slice,
+  Sort,
   UnknownNode,
 } from '@finos/legend-cube';
 
-// The node editor's help text, verbatim from the original (spec §17.9). A
-// new node type adds its entry here.
+// The node editor's help text, verbatim from the original (spec §17.9), but
+// Slice's, which counts rows from 0 and leaves the stop row out (D5, PLAN
+// §11.4), and Concat's, which matches columns by position (PLAN §11.5, Q8).
+// A new node type adds its entry here.
 
 export const CUBE_NODE_HELP_TEXT: Readonly<Record<string, string>> = {
   [RelationalTableSource.TYPE]: 'Sources data from relational database table.',
+  /** Added by Cube: the original has no data product source (PLAN §6.8) */
+  [DataProductAccessPointSource.TYPE]:
+    'Sources data from an access point of a deployed data product.',
+  /** Added by Cube: the original has no ingest data set source (PLAN §6.7) */
+  [IngestDatasetSource.TYPE]:
+    'Sources data from a data set of a deployed ingest definition.',
+  [Concat.TYPE]:
+    'Combines the rows of the two previous data sets, keeping duplicates, in no particular order. Both must have the same columns: the same names, in the same order, with the same types.',
+  [Difference.TYPE]:
+    'Compares numeric values of specified columns from two previous data sets.',
+  [Distinct.TYPE]: 'Removes duplicate rows from the previous data set.',
+  [Drop.TYPE]:
+    'Reduces the number of rows in the previous data set, removing the specified number of rows from the beginning of the data set.',
+  [Extend.TYPE]:
+    'Extends outgoing data set with new columns produced by expressions.',
   [Filter.TYPE]:
     'Reduces the number of rows in the previous data set, keeping only rows matching the specified criteria.',
+  [Group.TYPE]:
+    'Aggregates the data from the previous data set using the specified columns and aggregation functions.',
   [Join.TYPE]:
     'Joins two previous data sets using specified columns as join keys.',
+  [Partition.TYPE]:
+    'Adds new columns with outputs of window functions for optional window partition and order.',
+  [Limit.TYPE]:
+    'Reduces the number of rows in the previous data set, keeping the specified number of rows from the beginning of the data set.',
+  [Rename.TYPE]:
+    'Renames specified columns in the previous data set to new names.',
+  [Restrict.TYPE]: 'Restricts outgoing data set to the specified columns only.',
+  [Slice.TYPE]:
+    'Reduces the number of rows in the previous data set, keeping only the rows from position "start" up to, but not including, position "stop", counting from 0.',
+  [Sort.TYPE]:
+    'Reorders rows of the previous data set by one or more columns, either in ascending or descending order per column.',
   [UnknownNode.TYPE]: 'Source or transformation unknown to the application.',
 };
 

package/src/__lib__/LegendCubeIngestLabels.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { SchemaDiff } from '@finos/legend-cube';
+import { getSchemaChangeList } from './LegendCubeLabels.js';
+
+// The text of ingest data set sources (PLAN §6.7): the source dialog's
+// Ingest tab and an ingest data set's panel
+
+export const getDataSetDriftWarning = (diff: SchemaDiff): string =>
+  `This data set changed since the cube was saved: ${getSchemaChangeList(diff)}`;
+
+export const getDataSetRecheckWarning = (firstLine: string): string =>
+  `Could not re-check this data set, so it keeps its saved columns: ${firstLine}`;
+
+export const CUBE_INGEST_RECHECK_MESSAGE = {
+  NO_ANSWER: 'The ingest catalog gave no columns for this data set',
+  NO_CATALOG: "This Legend deployment doesn't serve ingest data sets",
+} as const;
+
+/** How many of a producer deployment's definitions the tab leaves out, or nothing when it lists them all */
+export const getDroppedDefinitionsLabel = (
+  count: number,
+): string | undefined =>
+  count === 0
+    ? undefined
+    : `${count} ${count === 1 ? 'definition' : 'definitions'} not deployed from a project, or deployed to another environment, not shown`;