@antelopejs/dms 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## v0.4.4
+
+[compare changes](https://github.com/AntelopeJS/dms/compare/v0.4.3...v0.4.4)
+
+### 🚀 Enhancements
+
+- **base:** Declare where a block's data comes from, and arrange the answer ([#15](https://github.com/AntelopeJS/dms/pull/15))
+
+### 🏡 Chore
+
+- **release:** @antelopejs/interface-dms v0.2.3 ([726ddbb](https://github.com/AntelopeJS/dms/commit/726ddbb))
+
+### ❤️ Contributors
+
+- Fabrice Cst <fabrice@altab.be>
+
 ## v0.4.3
 
 [compare changes](https://github.com/AntelopeJS/dms/compare/v0.4.2...v0.4.3)

package/dist/test/unit/interfaces/dms-base/form-catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/interfaces/dms-base/form-catalog.test.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const block_types_1 = require("@antelopejs/interface-dms/base/block-types");
+describe("[unit] interfaces/dms-base/form — its catalog entry", () => {
+    function entryBranches() {
+        const declared = (0, block_types_1.ListBlockTypes)().find((block) => block.type === "Form");
+        return declared?.config.fields?.items?.oneOf ?? [];
+    }
+    it("names both kinds of entry a form's fields can hold", () => {
+        (0, chai_1.expect)(entryBranches().map((branch) => branch.ui?.label)).to.deep.equal([
+            "Group",
+            "Field",
+        ]);
+    });
+    it("says a field's key and a group's can be derived from their label", () => {
+        const [group, field] = entryBranches();
+        (0, chai_1.expect)(field?.properties?.id?.ui?.derivedFrom).to.equal("label");
+        (0, chai_1.expect)(group?.properties?.id?.ui?.derivedFrom).to.equal("label");
+    });
+    it("says a field's default takes the field's own type", () => {
+        const [, field] = entryBranches();
+        (0, chai_1.expect)(field?.properties?.defaultValue?.ui?.typedBy).to.equal("type");
+    });
+    it("is placed showing its buttons, a setting of the advanced view", () => {
+        const config = (0, block_types_1.ListBlockTypes)().find((block) => block.type === "Form")?.config;
+        (0, chai_1.expect)(config?.showActions?.ui).to.include({
+            initial: true,
+            advanced: true,
+        });
+    });
+    it("leaves its addresses and methods to the advanced view", () => {
+        const config = (0, block_types_1.ListBlockTypes)().find((block) => block.type === "Form")?.config;
+        for (const key of [
+            "fetchUrl",
+            "fetchUrlMethod",
+            "submitUrl",
+            "submitUrlMethod",
+        ]) {
+            (0, chai_1.expect)(config?.[key]?.ui?.advanced, key).to.equal(true);
+        }
+    });
+    it("names what a group of fields is set up with", () => {
+        const [group] = entryBranches();
+        (0, chai_1.expect)(group?.properties?.label?.ui?.label).to.equal("Title");
+        (0, chai_1.expect)(group?.properties?.fields?.ui?.label).to.equal("Fields");
+    });
+    for (const type of ["Form", "ResourceForm"]) {
+        it(`puts the submit messages of a ${type} behind one switch`, () => {
+            const config = (0, block_types_1.ListBlockTypes)().find((block) => block.type === type)?.config;
+            (0, chai_1.expect)(config?.successMessage?.ui).to.include({
+                optIn: "Custom submit messages",
+                placeholder: "Data has been successfully saved",
+            });
+            (0, chai_1.expect)(config?.errorMessage?.ui).to.include({
+                optIn: "Custom submit messages",
+                placeholder: "An unknown error occurred",
+            });
+        });
+    }
+});
+//# sourceMappingURL=form-catalog.test.js.map

package/dist/test/unit/interfaces/dms-base/form-catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-catalog.test.js","sourceRoot":"","sources":["../../../../../src/test/unit/interfaces/dms-base/form-catalog.test.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/interfaces/dms-base/period-selector-catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/interfaces/dms-base/period-selector-catalog.test.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const block_types_1 = require("@antelopejs/interface-dms/base/block-types");
+function periodSelectorConfig() {
+    const declared = (0, block_types_1.ListBlockTypes)().find((block) => block.type === "PeriodSelector");
+    (0, chai_1.expect)(declared, "PeriodSelector is declared").to.not.equal(undefined);
+    return declared.config;
+}
+describe("[unit] interfaces/dms-base/period-selector — its catalog entry", () => {
+    it("names the ranges a range label can be given for", () => {
+        const labels = periodSelectorConfig().presetLabels;
+        (0, chai_1.expect)(labels?.type).to.equal("record");
+        (0, chai_1.expect)(labels?.ui?.widget, "no longer a JSON box").to.equal(undefined);
+        (0, chai_1.expect)(labels?.keys?.enum).to.include("last-30-days");
+        (0, chai_1.expect)(labels?.keys?.ui?.valueLabels?.["ytd"]).to.equal("Year to date");
+        (0, chai_1.expect)(labels?.values?.type).to.equal("string");
+    });
+    it("names the comparisons a comparison label can be given for", () => {
+        const labels = periodSelectorConfig().comparisonLabels;
+        (0, chai_1.expect)(labels?.keys?.enum).to.deep.equal([
+            "none",
+            "previous-period",
+            "previous-year",
+            "custom",
+        ]);
+        (0, chai_1.expect)(labels?.keys?.ui?.valueLabels?.["previous-period"]).to.equal("vs previous period");
+    });
+    it("names the values of the pickers that choose a range", () => {
+        const config = periodSelectorConfig();
+        (0, chai_1.expect)(config.defaultPreset?.ui?.label, "its own hints still apply").to.equal("Default range");
+        (0, chai_1.expect)(config.defaultPreset?.ui?.valueLabels?.["last-7-days"]).to.equal("Last 7 days");
+        (0, chai_1.expect)(config.presets?.items?.ui?.valueLabels?.["today"]).to.equal("Today");
+    });
+});
+//# sourceMappingURL=period-selector-catalog.test.js.map

package/dist/test/unit/interfaces/dms-base/period-selector-catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"period-selector-catalog.test.js","sourceRoot":"","sources":["../../../../../src/test/unit/interfaces/dms-base/period-selector-catalog.test.ts"],"names":[],"mappings":";;AAAA,+BAA8B;AAC9B,4EAA4E;AAE5E,SAAS,oBAAoB;IAC3B,MAAM,QAAQ,GAAG,IAAA,4BAAc,GAAE,CAAC,IAAI,CACpC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAC3C,CAAC;IACF,IAAA,aAAM,EAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACvE,OAAO,QAAS,CAAC,MAAM,CAAC;AAC1B,CAAC;AAOD,QAAQ,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC9E,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC,YAAY,CAAC;QAEnD,IAAA,aAAM,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAA,aAAM,EAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvE,IAAA,aAAM,EAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACtD,IAAA,aAAM,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACxE,IAAA,aAAM,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC,gBAAgB,CAAC;QAEvD,IAAA,aAAM,EAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YACvC,MAAM;YACN,iBAAiB;YACjB,eAAe;YACf,QAAQ;SACT,CAAC,CAAC;QACH,IAAA,aAAM,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CACjE,oBAAoB,CACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;QAEtC,IAAA,aAAM,EACJ,MAAM,CAAC,aAAa,EAAE,EAAE,EAAE,KAAK,EAC/B,2BAA2B,CAC5B,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5B,IAAA,aAAM,EAAC,MAAM,CAAC,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CACrE,aAAa,CACd,CAAC;QACF,IAAA,aAAM,EAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/unit/interfaces/dms-base/resource-form.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/interfaces/dms-base/resource-form.test.js

@@ -0,0 +1,117 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_data_api_1 = require("@antelopejs/interface-data-api");
+const metadata_1 = require("@antelopejs/interface-data-api/metadata");
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const chai_1 = require("chai");
+const block_types_1 = require("@antelopejs/interface-dms/base/block-types");
+const default_types_1 = require("@antelopejs/interface-dms/base/data-types/default-types");
+const factory_1 = require("@antelopejs/interface-dms/base/table-view/factory");
+const meta_1 = require("@antelopejs/interface-dms/base/table-view/meta");
+const resource_form_1 = require("@antelopejs/interface-dms/base/table-view/resource-form");
+const routes_1 = require("@antelopejs/interface-dms/base/table-view/routes");
+const http_1 = require("@antelopejs/interface-dms/base/types/http");
+const SCHEMA = "resource-form-test";
+const TABLE = "tickets";
+const LOCATION = "/resource-form-test";
+let Ticket = class Ticket extends interface_database_decorators_1.Table {
+};
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], Ticket.prototype, "title", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], Ticket.prototype, "reference", void 0);
+Ticket = __decorate([
+    (0, interface_database_decorators_1.RegisterTable)(TABLE, SCHEMA)
+], Ticket);
+class TicketModel extends (0, interface_database_decorators_1.BasicDataModel)(Ticket, TABLE) {
+}
+let TicketAPI = class TicketAPI extends (0, interface_data_api_1.DataController)(Ticket, routes_1.TableViewRoutes.All, (0, interface_api_1.Controller)(LOCATION)) {
+};
+__decorate([
+    (0, metadata_1.ModelReference)(),
+    (0, interface_database_decorators_1.Model)(TicketModel),
+    __metadata("design:type", TicketModel)
+], TicketAPI.prototype, "model", void 0);
+__decorate([
+    (0, meta_1.Column)({ name: "Title", type: new default_types_1.DefaultDataTypes.StringType() }),
+    (0, metadata_1.Access)(metadata_1.AccessMode.ReadWrite),
+    __metadata("design:type", String)
+], TicketAPI.prototype, "title", void 0);
+__decorate([
+    (0, meta_1.Column)({ name: "Reference", type: new default_types_1.DefaultDataTypes.StringType() }),
+    (0, metadata_1.Access)(metadata_1.AccessMode.ReadOnly),
+    __metadata("design:type", String)
+], TicketAPI.prototype, "reference", void 0);
+TicketAPI = __decorate([
+    (0, interface_data_api_1.RegisterDataController)()
+], TicketAPI);
+function optionsOf(builder) {
+    return builder.serializeSync().options;
+}
+function fieldIds(options) {
+    return options.fields.map((field) => field.id);
+}
+describe("[unit] interfaces/dms-base/resource-form — a form derived from its table", () => {
+    it("is the form a TableView opens for the mode", () => {
+        const table = (0, factory_1.TableView)(TicketAPI).serializeSync()
+            .options;
+        const created = optionsOf((0, resource_form_1.ResourceForm)(TicketAPI, { mode: "new" }));
+        (0, chai_1.expect)(created.submitUrl).to.equal(`${LOCATION}/new`);
+        (0, chai_1.expect)(created.submitUrlMethod).to.equal(http_1.HttpMethod.post);
+        const opened = table.formComponents.new?.options;
+        (0, chai_1.expect)(created.fetchUrl).to.equal(opened.fetchUrl);
+        (0, chai_1.expect)(fieldIds(created)).to.deep.equal(fieldIds(opened));
+    });
+    it("opens the row the page's query string names, in edit and view", () => {
+        const edited = optionsOf((0, resource_form_1.ResourceForm)(TicketAPI, { mode: "edit" }));
+        const shown = optionsOf((0, resource_form_1.ResourceForm)(TicketAPI, { mode: "view" }));
+        (0, chai_1.expect)(edited.fetchUrl).to.match(new RegExp(`^${LOCATION}/get\\?id=\\{\\{query\\.id\\}\\}&`));
+        (0, chai_1.expect)(edited.submitUrl).to.equal(`${LOCATION}/edit?id={{query.id}}`);
+        (0, chai_1.expect)(edited.submitUrlMethod).to.equal(http_1.HttpMethod.put);
+        (0, chai_1.expect)(shown.fetchUrl).to.equal(`${LOCATION}/get?id={{query.id}}`);
+    });
+    it("keeps the TableView's own pages on their :id segment", () => {
+        const table = (0, factory_1.TableView)(TicketAPI).serializeSync()
+            .options;
+        const opened = table.formComponents.edit?.options;
+        (0, chai_1.expect)(opened.submitUrl).to.equal(`${LOCATION}/edit?id={{params.id}}`);
+    });
+    it("reads a row without offering anywhere to send it", () => {
+        const shown = optionsOf((0, resource_form_1.ResourceForm)(TicketAPI, { mode: "view" }));
+        (0, chai_1.expect)(shown.submitUrl).to.equal(undefined);
+        (0, chai_1.expect)(shown.fields.every((field) => field.disabled)).to.equal(true);
+    });
+    it("carries its own wording and the row it was pointed at", () => {
+        const edited = optionsOf((0, resource_form_1.ResourceForm)(TicketAPI, {
+            mode: "edit",
+            title: "Edit the ticket",
+            submitLabel: "Save the ticket",
+            rowId: "{{params.ticket}}",
+        }));
+        (0, chai_1.expect)(edited.title).to.equal("Edit the ticket");
+        (0, chai_1.expect)(edited.submitLabel).to.equal("Save the ticket");
+        (0, chai_1.expect)(edited.submitUrl).to.equal(`${LOCATION}/edit?id={{params.ticket}}`);
+        (0, chai_1.expect)(edited, "the row token is the form's to resolve, not an option").to.not.have.property("rowId");
+    });
+    it("is declared as a block over a table, picked by mode", () => {
+        const declared = (0, block_types_1.ListBlockTypes)().find((block) => block.type === "ResourceForm");
+        (0, chai_1.expect)(declared?.controllerArg).to.equal(true);
+        (0, chai_1.expect)(declared?.config.mode?.enum).to.deep.equal(["new", "edit", "view"]);
+        (0, chai_1.expect)(declared?.config.fields, "fields come from the table").to.equal(undefined);
+    });
+});
+//# sourceMappingURL=resource-form.test.js.map

package/dist/test/unit/interfaces/dms-base/resource-form.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-form.test.js","sourceRoot":"","sources":["../../../../../src/test/unit/interfaces/dms-base/resource-form.test.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/interfaces/dms-base/table-and-card-catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/interfaces/dms-base/table-and-card-catalog.test.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const block_types_1 = require("@antelopejs/interface-dms/base/block-types");
+function configOf(type) {
+    const declared = (0, block_types_1.ListBlockTypes)().find((block) => block.type === type);
+    (0, chai_1.expect)(declared, `${type} is declared`).to.not.equal(undefined);
+    return declared.config;
+}
+describe("[unit] interfaces/dms-base/table-view — its row actions in the catalog", () => {
+    const actions = () => configOf("TableView").rowActions?.properties ?? {};
+    it("says the actions a table offers by itself are on", () => {
+        for (const action of ["add", "edit", "delete", "duplicate", "copyLink"]) {
+            (0, chai_1.expect)(actions()[action]?.default, action).to.equal(true);
+        }
+    });
+    it("says when an action depends on another one", () => {
+        (0, chai_1.expect)(actions().details?.default).to.equal(undefined);
+        (0, chai_1.expect)(actions().details?.description).to.match(/editing is off/);
+        (0, chai_1.expect)(actions().archive?.default).to.equal(true);
+        (0, chai_1.expect)(actions().archive?.description).to.match(/ghost delete/);
+    });
+    it("leaves row selection off until it is turned on", () => {
+        (0, chai_1.expect)(actions().hasSelection?.default).to.equal(undefined);
+    });
+});
+describe("[unit] interfaces/dms-base/chart-card — the chart it wraps, in the catalog", () => {
+    it("names the options of its chart it supplies itself", () => {
+        const supplied = configOf("ChartCard").chart?.ui?.supplies;
+        (0, chai_1.expect)(supplied).to.include.members([
+            "fetchUrl",
+            "fetchUrlMethod",
+            "periodScope",
+            "title",
+        ]);
+    });
+    it("keeps a chart's backend-only settings for the advanced view", () => {
+        const chart = configOf("ChartLine");
+        (0, chai_1.expect)(chart.realtimeTopic?.ui?.advanced).to.equal(true);
+        (0, chai_1.expect)(chart.syncGroup?.ui?.advanced).to.equal(true);
+        (0, chai_1.expect)(chart.annotations?.ui?.advanced).to.equal(true);
+        (0, chai_1.expect)(chart.showGrid?.ui?.advanced, "a setting anyone reads").to.equal(undefined);
+    });
+});
+describe("[unit] interfaces/dms-base/chart-card — the switches it draws on", () => {
+    it("says a card shows its variation and its legend", () => {
+        const card = configOf("ChartCard");
+        (0, chai_1.expect)(card.showDelta?.default).to.equal(true);
+        (0, chai_1.expect)(card.showLegend?.default).to.equal(true);
+    });
+    it("says a chart shows what it draws unless told not to", () => {
+        const chart = configOf("ChartColumn");
+        for (const option of ["showTooltip", "showGrid", "roundedCorners"]) {
+            (0, chai_1.expect)(chart[option]?.default, option).to.equal(true);
+        }
+        (0, chai_1.expect)(configOf("ChartLine").smooth?.default).to.equal(true);
+    });
+    it("leaves what it only does when asked unset", () => {
+        (0, chai_1.expect)(configOf("ChartColumn").stacked?.default).to.equal(undefined);
+    });
+});
+//# sourceMappingURL=table-and-card-catalog.test.js.map

package/dist/test/unit/interfaces/dms-base/table-and-card-catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-and-card-catalog.test.js","sourceRoot":"","sources":["../../../../../src/test/unit/interfaces/dms-base/table-and-card-catalog.test.ts"],"names":[],"mappings":"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"}

package/frontend-vue/layers/dms-ui/app/components/Placeholder.vue

@@ -5,19 +5,31 @@ interface PlaceholderProps {
   width?: string;
 }
 
+/** What a box nobody sized is worth showing at, when nothing stretches it. */
+const MIN_HEIGHT = "120px";
+
 const props = withDefaults(defineProps<PlaceholderProps>(), {
   label: undefined,
-  height: "120px",
+  height: undefined,
   width: undefined,
 });
+
+/**
+ * A placeholder stands in for content still to come, so it takes the room it is
+ * given: a height of its own would keep it short in a row sized by its tallest
+ * cell, and a layout laid out with these could not be read for what it will be.
+ * A given height still wins, and a floor keeps a lone one visible.
+ */
+const box = computed(() => ({
+  height: props.height,
+  minHeight: props.height ? undefined : MIN_HEIGHT,
+  width: props.width,
+}));
 </script>
 
 <template>
   <div
-    :style="{
-      height: props.height,
-      width: props.width,
-    }"
+    :style="box"
     class="border-accented relative flex items-center justify-center overflow-hidden rounded-md border border-dashed px-4 opacity-75"
   >
     <svg

package/frontend-vue/layers/dms-ui/app/components/chart/ChartCard.vue

@@ -1,7 +1,10 @@
 <script setup lang="ts">
 import { computed, provide, reactive, watchEffect } from "vue";
 import { useChartFetch } from "../../composables/chart/useChartFetch";
-import { formatValue } from "../../composables/chart/formatValue";
+import {
+  ABSENT_VALUE_TEXT,
+  formatValue,
+} from "../../composables/chart/formatValue";
 import { resolveChartColor } from "../../composables/chart/useChartTheme";
 import { useThemeRevision } from "../../composables/chart/useThemeRevision";
 import {
@@ -64,7 +67,7 @@ const { data, isLoading } = useChartFetch<ChartCardResponse>({
   watchSource: () => watchKey.value,
 });
 
-const value = computed(() => data.value?.value ?? 0);
+const value = computed(() => data.value?.value);
 const previousValue = computed(() => data.value?.previousValue);
 const delta = computed(() => data.value?.delta ?? null);
 
@@ -87,13 +90,15 @@ const cardComparisonSeries = computed<ChartSeries[]>(() =>
 );
 
 const formatted = computed(() =>
-  formatValue(
-    value.value,
-    props.valueFormat,
-    locale.value,
-    props.currencyCode,
-    props.valuePrecision,
-  ),
+  value.value === undefined
+    ? ABSENT_VALUE_TEXT
+    : formatValue(
+        value.value,
+        props.valueFormat,
+        locale.value,
+        props.currencyCode,
+        props.valuePrecision,
+      ),
 );
 
 const previousFormatted = computed(() =>

package/frontend-vue/layers/dms-ui/app/components/form/Form.vue

@@ -3,6 +3,7 @@ import type { FormProps } from "../../composables/form/types";
 import type { FormFieldValue } from "../../composables/form/types/value";
 import {
   cloneFormValue,
+  formShowsActions,
   isFieldMarkedRequired,
 } from "../../composables/form/useForm";
 import {
@@ -20,7 +21,12 @@ const REALTIME_ROW_TOPIC_PREFIX = "tableview:row:";
 const REALTIME_GET_SEGMENT = "/get";
 const REALTIME_EVENT_UPDATED = "updated";
 
-const props = defineProps<FormProps>();
+// `showActions` left out has to read as left out: Vue casts an absent boolean
+// prop to `false`, which would hide the buttons of every form not asking for
+// them.
+const props = withDefaults(defineProps<FormProps>(), {
+  showActions: undefined,
+});
 const form = useTemplateRef("form");
 
 // Inside a DynamicModal/DynamicDrawer the container already provides the
@@ -47,10 +53,7 @@ const {
   resolvedFetchUrl,
 } = useForm(props);
 
-const showActions = computed(
-  () =>
-    !!props.submitUrl && !toValue(allFields).every((field) => field.disabled),
-);
+const showActions = computed(() => formShowsActions(props, toValue(allFields)));
 
 const { addGuard } = useLeaveGuard();
 const { confirm } = useConfirm();

package/frontend-vue/layers/dms-ui/app/components/grid/Grid.vue

@@ -13,19 +13,29 @@ const props = withDefaults(defineProps<GridProps>(), {
   minColumnWidth: GRID_DEFAULT_MIN_COLUMN_WIDTH,
 });
 
-const rowColumnCounts = ref<number[]>([]);
+/**
+ * Keyed by row rather than appended to: a list that only grows keeps counting
+ * rows that have gone and widths that were never asked for, so the grid ends up
+ * reserving columns nothing fills.
+ */
+const rowColumnCounts = ref(new Map<symbol, number>());
 
 const maxColumns = computed(() => {
-  if (rowColumnCounts.value.length === 0) return 1;
-  return Math.max(...rowColumnCounts.value);
+  const counts = [...rowColumnCounts.value.values()].filter(
+    (count) => count > 0,
+  );
+  return counts.length === 0 ? 1 : Math.max(...counts);
 });
 
 const gapRef = computed(() => props.gap);
 const minColumnWidthRef = computed(() => props.minColumnWidth);
 
 provide<GridContext>(GRID_CONTEXT, {
-  registerRowColumnCount: (columnCount: number) => {
-    rowColumnCounts.value.push(columnCount);
+  setRowColumnCount: (row: symbol, columnCount: number) => {
+    rowColumnCounts.value.set(row, columnCount);
+  },
+  dropRow: (row: symbol) => {
+    rowColumnCounts.value.delete(row);
   },
   maxColumns,
   gap: gapRef,

package/frontend-vue/layers/dms-ui/app/components/grid/GridRow.vue

@@ -11,10 +11,13 @@ const props = defineProps<GridRowProps>();
 
 const gridContext = inject<GridContext>(GRID_CONTEXT);
 
-const columnCount = props.childCount || 0;
-if (gridContext) {
-  gridContext.registerRowColumnCount(columnCount);
-}
+/** The identity this row counts under, so its width dies with it. */
+const rowId = Symbol("grid-row");
+
+const columnCount = computed(() => props.childCount || 0);
+
+watchEffect(() => gridContext?.setRowColumnCount(rowId, columnCount.value));
+onUnmounted(() => gridContext?.dropRow(rowId));
 
 const rowStyle = computed(() => {
   const gap = gridContext?.gap.value ?? DEFAULT_GAP;

package/frontend-vue/layers/dms-ui/app/components/grid/constants.ts

@@ -1,7 +1,14 @@
 export const GRID_CONTEXT = Symbol("grid-context");
 
 export interface GridContext {
-  registerRowColumnCount: (count: number) => void;
+  /**
+   * A row states how many columns it holds, and says so again whenever that
+   * changes: a row built by hand never moves, but one an editor fills gains and
+   * loses children while the page is open.
+   */
+  setRowColumnCount: (row: symbol, count: number) => void;
+  /** A row that unmounts stops counting, so a stale width cannot outlive it. */
+  dropRow: (row: symbol) => void;
   maxColumns: ComputedRef<number>;
   gap: ComputedRef<string>;
   minColumnWidth: ComputedRef<string>;

package/frontend-vue/layers/dms-ui/app/components/kpi/KpiCard.vue

@@ -1,7 +1,10 @@
 <script setup lang="ts">
 import { computed } from "vue";
 import { useChartFetch } from "../../composables/chart/useChartFetch";
-import { formatValueParts } from "../../composables/chart/formatValue";
+import {
+  ABSENT_VALUE_PARTS,
+  formatValueParts,
+} from "../../composables/chart/formatValue";
 import { resolveSparklineAccent } from "../../composables/chart/resolveSparklineAccent";
 import type {
   KpiCardResponse,
@@ -69,18 +72,20 @@ const { data, isLoading } = useChartFetch<KpiCardResponse>({
   watchSource: () => watchKey.value,
 });
 
-const value = computed(() => data.value?.value ?? 0);
+const value = computed(() => data.value?.value);
 const delta = computed(() => data.value?.delta ?? null);
 const sparkline = computed(() => data.value?.sparkline ?? []);
 
 const formattedParts = computed(() =>
-  formatValueParts(
-    value.value,
-    props.valueFormat,
-    locale.value,
-    props.currencyCode,
-    props.valuePrecision,
-  ),
+  value.value === undefined
+    ? ABSENT_VALUE_PARTS
+    : formatValueParts(
+        value.value,
+        props.valueFormat,
+        locale.value,
+        props.currencyCode,
+        props.valuePrecision,
+      ),
 );
 
 const showTrend = computed(() => props.showDelta && delta.value !== null);

package/frontend-vue/layers/dms-ui/app/composables/chart/formatValue.ts

@@ -112,6 +112,21 @@ export interface FormattedValueParts {
   unitIsPrefix: boolean;
 }
 
+/**
+ * What a card prints where its figure would go when the query measured nothing.
+ *
+ * An em dash and not a zero: a zero is itself a measurement, so a card printing
+ * one for a period with no rows in it states a result nobody computed. No unit
+ * either — there is no quantity for it to qualify.
+ */
+export const ABSENT_VALUE_TEXT = "—";
+
+export const ABSENT_VALUE_PARTS: FormattedValueParts = {
+  value: ABSENT_VALUE_TEXT,
+  unit: "",
+  unitIsPrefix: false,
+};
+
 /** Splits the same formatted value into numeric and unit parts for KPI cards. */
 export function formatValueParts(
   value: number,

package/frontend-vue/layers/dms-ui/app/composables/chart/types.ts

@@ -82,7 +82,8 @@ export interface DonutRecord {
 }
 
 export interface ChartCardResponse {
-  value: number;
+  /** Absent when the query measured no group; the card shows no figure. */
+  value?: number;
   delta?: number;
   previousValue?: number;
   series: ChartSeries[];
@@ -90,7 +91,8 @@ export interface ChartCardResponse {
 }
 
 export interface KpiCardResponse {
-  value: number;
+  /** Absent when the query measured no group; the card shows no figure. */
+  value?: number;
   delta?: number;
   previousValue?: number;
   sparkline?: number[];

package/frontend-vue/layers/dms-ui/app/composables/form/types/props.ts

@@ -17,6 +17,8 @@ export interface FormProps extends FormComponentProps {
   submitUrl?: string;
   submitUrlMethod?: HttpMethod;
   submitLabel?: string;
+  /** Whether the buttons show; left out, once there is somewhere to submit to. */
+  showActions?: boolean;
   successMessage?: string;
   errorMessage?: string;
   schema?: Record<string, unknown>;

package/frontend-vue/layers/dms-ui/app/composables/form/useForm.ts

@@ -28,6 +28,23 @@ export function cloneFormValue(
   return JSON.parse(JSON.stringify(value));
 }
 
+/**
+ * Whether a form shows its reset and submit buttons.
+ *
+ * Asked for, they show whatever else holds — a form placed in the builder shows
+ * them before it has somewhere to submit to. Left to the form, they show once
+ * it has an address and a field someone can fill in.
+ */
+export function formShowsActions(
+  options: { showActions?: boolean; submitUrl?: string },
+  fields: ReadonlyArray<{ disabled?: boolean }>,
+): boolean {
+  return (
+    options.showActions ??
+    (!!options.submitUrl && !fields.every((field) => field.disabled))
+  );
+}
+
 export function computeResetState(
   state: Record<string, unknown>,
   initialValues: FormData,
@@ -137,6 +154,25 @@ export function replaceUrlVariables(
   return processedUrl;
 }
 
+/** Where a submit goes, or what it lacks to go anywhere. */
+export type SubmitTarget = { url: string } | { missing: "url" | "token" };
+
+/**
+ * Where a submit is sent. A form with no URL has nowhere to send it — it is a
+ * read-only one — and a URL naming a token the page does not carry, such as an
+ * edit form opened without the id of its row, is not a route either: loading
+ * already skips such a URL, and submitting to it wrote to a path that was never
+ * meant to exist.
+ */
+export function resolveSubmitTarget(
+  submitUrl: string | undefined,
+  context: ReplaceUrlVariablesContext,
+): SubmitTarget {
+  if (!submitUrl) return { missing: "url" };
+  const url = replaceUrlVariables(submitUrl, context);
+  return url.includes("{{") ? { missing: "token" } : { url };
+}
+
 function processBeforeStateMappers(
   data: FormData,
   fields: FormFieldOrGroup[],
@@ -496,16 +532,29 @@ export const useForm = (props: FormProps) => {
     }
   };
 
+  const showUnresolvedTargetToast = () => {
+    toast.add({
+      title: processI18n("$dms.form.error_title"),
+      description: processI18n("$dms.form.error_no_target"),
+      color: Color.error,
+    });
+  };
+
   const onSubmit = async (event: FormSubmitEvent<FormData>) => {
+    const target = resolveSubmitTarget(props.submitUrl, buildUrlContext());
+    if ("missing" in target) {
+      // A read-only form renders no submit button, but Enter in one of its
+      // fields still submits it: that does nothing. Falling back on `/` sent
+      // the values to the site root with a PUT and reported nothing.
+      if (target.missing === "token") showUnresolvedTargetToast();
+      return;
+    }
+    const submitUrl = target.url;
     const plainData = collectSubmitData(
       event,
       allFields.value,
       effectiveSubmitDefaults.value,
     );
-    const submitUrl = replaceUrlVariables(
-      props.submitUrl || "/",
-      buildUrlContext(),
-    );
 
     loading.value = true;
     try {

package/frontend-vue/layers/dms-ui/app/composables/tree/useTree.ts

@@ -106,12 +106,6 @@ export async function useTree<T = unknown>(props: TreeProps) {
     },
   });
 
-  if (!props.fetchUrl && !props.staticNodes) {
-    throw new Error(
-      "Either fetchUrl or staticNodes must be provided to useTree",
-    );
-  }
-
   const loadingNodes = ref<Set<string>>(new Set());
   // Shallow on purpose: `TreeItem` carries a string index signature and
   // recurses through `children`, so Vue's deep `UnwrapRef` on a tree node
@@ -194,12 +188,16 @@ export async function useTree<T = unknown>(props: TreeProps) {
     }
   }
 
+  // A tree with neither a URL nor nodes of its own holds nothing yet, which is
+  // what a block just placed on a page looks like: it is configured after it is
+  // placed, and the editor says what is still missing. Refusing to render at
+  // all would answer that gesture with a crash.
   const dataLoader = props.fetchUrl
     ? () =>
         $authFetch<TreeNode<T>[]>(props.fetchUrl!, {
           method: props.fetchUrlMethod || "GET",
         })
-    : () => Promise.resolve(props.staticNodes as TreeNode<T>[]);
+    : () => Promise.resolve((props.staticNodes ?? []) as TreeNode<T>[]);
 
   const { data, status, refresh } = await useDmsAsyncData(
     `tree-${props.componentId}-${props.pageId}-${props.componentId}`,

package/frontend-vue/layers/dms-ui/i18n/locales/ui-en-GB.json

@@ -161,6 +161,7 @@
       "success_message": "Data has been successfully saved",
       "error_title": "Error",
       "error_unknown": "An unknown error occurred",
+      "error_no_target": "This form does not know which item to save. Open it from a link that names one.",
       "no_data": "No data available",
       "empty_value": "—",
       "actions": "Actions",

package/frontend-vue/layers/dms-ui/i18n/locales/ui-fr-FR.json

@@ -161,6 +161,7 @@
       "success_message": "Les données ont été enregistrées avec succès",
       "error_title": "Erreur",
       "error_unknown": "Une erreur inconnue s'est produite",
+      "error_no_target": "Ce formulaire ne sait pas quel élément enregistrer. Ouvrez-le depuis un lien qui en désigne un.",
       "no_data": "Aucune donnée disponible",
       "empty_value": "—",
       "actions": "Actions",

package/frontend-vue/tests/chart-absent-value.test.ts

@@ -0,0 +1,78 @@
+import { createSSRApp, defineComponent, h, ref } from "vue";
+import { renderToString } from "vue/server-renderer";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import ChartCard from "../layers/dms-ui/app/components/chart/ChartCard.vue";
+import KpiCard from "../layers/dms-ui/app/components/kpi/KpiCard.vue";
+import { ABSENT_VALUE_TEXT } from "../layers/dms-ui/app/composables/chart/formatValue";
+
+// A period the query measured nothing in: the response carries its series and no
+// figure at all, which is what the contract answers rather than a zero.
+vi.mock("../layers/dms-ui/app/composables/chart/useChartFetch", () => ({
+  useChartFetch: () => ({
+    data: ref({ series: [{ name: "Revenue", data: [] }] }),
+    isLoading: ref(false),
+  }),
+}));
+
+const Slot = defineComponent({
+  setup:
+    (_, { slots }) =>
+    () =>
+      h("div", slots.default?.()),
+});
+
+const SLOT_COMPONENTS = [
+  "DmsCard",
+  "DmsClientOnly",
+  "UIcon",
+  "USkeleton",
+  "DmsTrendBadge",
+  "DmsSparkline",
+  "UBadge",
+];
+
+function stubNuxt() {
+  vi.stubGlobal("useI18n", () => ({
+    locale: ref("en-US"),
+    t: (key: string) => key,
+  }));
+  vi.stubGlobal("useTranslation", () => ({
+    processI18n: (text: string) => text,
+  }));
+  vi.stubGlobal("useComponentEvent", () => ({}));
+  vi.stubGlobal("useWatch", () => ({ state: ref({}) }));
+}
+
+type CardProps = InstanceType<typeof ChartCard>["$props"];
+
+async function renderCards() {
+  stubNuxt();
+  const props: CardProps = {
+    title: "Revenue",
+    componentId: "card",
+    pageId: "absent",
+    valueFormat: "currency",
+  };
+  const app = createSSRApp({
+    render: () => h("main", [h(ChartCard, props), h(KpiCard, props)]),
+  });
+  for (const name of SLOT_COMPONENTS) app.component(name, Slot);
+  return renderToString(app);
+}
+
+afterEach(() => vi.unstubAllGlobals());
+
+describe("a card whose query measured nothing", () => {
+  it("shows an absence where the figure goes, on both cards", async () => {
+    const html = await renderCards();
+    expect(html.split(ABSENT_VALUE_TEXT)).toHaveLength(3);
+  });
+
+  it("prints no zero, and no unit for a quantity there is none of", async () => {
+    const html = await renderCards();
+    expect(html, "a zero reads exactly like a measured figure").not.toContain(
+      "<span>0</span>",
+    );
+    expect(html).not.toContain("€");
+  });
+});

package/frontend-vue/tests/form-actions.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest";
+import { formShowsActions } from "../layers/dms-ui/app/composables/form/useForm";
+
+describe("formShowsActions", () => {
+  it("shows the buttons once the form has somewhere to submit to", () => {
+    expect(formShowsActions({ submitUrl: "/api/order/new" }, [{}])).toBe(true);
+    expect(formShowsActions({}, [{}])).toBe(false);
+  });
+
+  it("hides them on a form nothing in which can be filled in", () => {
+    expect(
+      formShowsActions({ submitUrl: "/api/order/new" }, [{ disabled: true }]),
+    ).toBe(false);
+  });
+
+  it("shows them when asked, before there is an address or a field", () => {
+    expect(formShowsActions({ showActions: true }, [])).toBe(true);
+  });
+
+  it("hides them when asked, whatever the form could submit", () => {
+    expect(
+      formShowsActions({ showActions: false, submitUrl: "/api/order/new" }, [
+        {},
+      ]),
+    ).toBe(false);
+  });
+});

package/frontend-vue/tests/form-submit-target.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from "vitest";
+import { resolveSubmitTarget } from "../layers/dms-ui/app/composables/form/useForm";
+
+const page = { routeParams: { id: "42" }, routeQuery: { id: "7" } };
+
+describe("resolveSubmitTarget", () => {
+  it("sends a submit where its URL points, tokens filled in", () => {
+    expect(resolveSubmitTarget("/api/ticket/edit?id={{query.id}}", page)).toEqual(
+      { url: "/api/ticket/edit?id=7" },
+    );
+    expect(resolveSubmitTarget("/api/ticket/edit?id={{params.id}}", page)).toEqual(
+      { url: "/api/ticket/edit?id=42" },
+    );
+  });
+
+  it("has nowhere to send a read-only form's values", () => {
+    expect(resolveSubmitTarget(undefined, page)).toEqual({ missing: "url" });
+    expect(resolveSubmitTarget("", page)).toEqual({ missing: "url" });
+  });
+
+  it("refuses a URL naming a row the page does not carry", () => {
+    expect(
+      resolveSubmitTarget("/api/ticket/edit?id={{query.id}}", {
+        routeQuery: {},
+      }),
+    ).toEqual({ missing: "token" });
+  });
+});

package/frontend-vue/tests/tree-without-source.test.ts

@@ -0,0 +1,79 @@
+// @vitest-environment jsdom
+/**
+ * A tree is configured after it is placed.
+ *
+ * The editor drops a block and the author points it at its data afterwards, so
+ * a tree with neither a URL nor nodes of its own is a page under construction,
+ * not a mistake. It used to throw during setup, which the canvas could only
+ * report as a crash on the block the author had just placed.
+ */
+import * as vue from "vue";
+import { ref } from "vue";
+import { describe, expect, it, vi } from "vitest";
+import type { TreeProps } from "../layers/dms-ui/app/composables/tree/types";
+
+// The layer's auto-imports, as the Nuxt build would supply them: Vue's own
+// first, then the DMS helpers the composable reaches for.
+for (const name of [
+  "ref",
+  "shallowRef",
+  "computed",
+  "watch",
+  "watchEffect",
+  "toValue",
+  "nextTick",
+] as const) {
+  vi.stubGlobal(name, vue[name]);
+}
+
+vi.stubGlobal(
+  "TreeEvents",
+  new Proxy({}, { get: (_target, key) => String(key) }),
+);
+vi.stubGlobal("createError", (payload: unknown) => new Error(String(payload)));
+vi.stubGlobal("useAuthFetch", () => ({
+  $authFetch: async () => [],
+}));
+vi.stubGlobal("useComponentEvent", () => ({ sendComponentEvent: () => {} }));
+vi.stubGlobal("useDefinedFunctions", () => ({ getFunction: () => undefined }));
+vi.stubGlobal("useTranslation", () => ({ processI18n: (text: string) => text }));
+vi.stubGlobal("useWatch", () => ({ isLoading: ref(false), state: ref({}) }));
+vi.stubGlobal("useToast", () => ({ add: () => {} }));
+vi.stubGlobal("useI18n", () => ({ t: (key: string) => key }));
+vi.stubGlobal("useEventedAction", () => ({ execute: async () => [] }));
+vi.stubGlobal(
+  "useDmsAsyncData",
+  async (_key: string, handler: () => Promise<unknown>) => ({
+    data: ref(await handler()),
+    status: ref("success"),
+    refresh: async () => {},
+  }),
+);
+
+const { useTree } = await import(
+  "../layers/dms-ui/app/composables/tree/useTree"
+);
+
+describe("a tree with no source yet", () => {
+  const props = (extra: Partial<TreeProps> = {}) =>
+    ({
+      selectionBehavior: "toggle",
+      componentId: "tree",
+      pageId: "page",
+      ...extra,
+    }) as TreeProps;
+
+  it("holds nothing, rather than refusing to render", async () => {
+    const tree = await useTree(props());
+
+    expect(tree.items.value).toEqual([]);
+  });
+
+  it("still reads the nodes it is given", async () => {
+    const tree = await useTree(
+      props({ staticNodes: [{ value: "one", label: "One" }] }),
+    );
+
+    expect(tree.items.value.map((node) => node.value)).toEqual(["one"]);
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AntelopeJS/dms.git"