@datarails-ai/dr-appspace-cli 0.11.4 → 0.12.1

package/dist/cli.js

@@ -13,7 +13,7 @@ import { fileURLToPath as fileURLToPath6 } from "url";
 // package.json
 var package_default = {
   name: "@datarails-ai/dr-appspace-cli",
-  version: "0.11.4",
+  version: "0.12.1",
   description: "Datarails App Space CLI \u2014 build, try, push and publish App Space apps",
   type: "module",
   engines: {
@@ -57,7 +57,7 @@ var package_default = {
 };
 
 // src/buildInfo.ts
-var BUILD_TIME = "2026-10-07T16:55:45.981Z";
+var BUILD_TIME = "2026-10-07T21:55:46.945Z";
 function formatBuildTime(iso) {
   if (iso === "") return "";
   const d = new Date(iso);
@@ -17549,6 +17549,7 @@ function validateContract(contract, catalog) {
   if (kind === "dashboard") {
     checkPeriodOverride(doc, problems);
     checkKinds(doc, problems);
+    checkDrillTargets(doc, problems);
     checkPairing(doc, problems);
     checkTransforms(doc, problems);
   } else {
@@ -18030,6 +18031,19 @@ function checkSources(doc, catalog, problems, skipped) {
       }
       report(held, ["data", "widgets", id, "source", key]);
     }
+    {
+      const held = source["period_field"];
+      const field = isObject4(held) ? held["field"] : held;
+      const epoch = isObject4(held) && held["format"] === "epoch";
+      if (typeof field === "string" && dated.has(field.toLowerCase()) && source["period_is_date"] !== true && !epoch) {
+        problems.push({
+          code: "period-needs-date",
+          pointer: pointer("data", "widgets", id, "source", "period_field"),
+          message: `${JSON.stringify(field)} is a date column, and this source does not say so \u2014 its window is not sent to FinanceOS, a drill reads rows from every period, and a clicked chart point matches no row.`,
+          fix: `Add "period_is_date": true to the source (next to period_field ${JSON.stringify(field)}); the page's window is then pushed down as Unix epoch seconds, with no "where" range needed.`
+        });
+      }
+    }
     for (const key of ["select", "dimensions", "measures"]) {
       for (const [index, name] of list2(source[key]).entries()) {
         if (isObject4(name)) {
@@ -18361,6 +18375,40 @@ function checkKinds(doc, problems) {
     });
   }
 }
+function checkDrillTargets(doc, problems) {
+  const widgets = obj(obj(doc["data"])["widgets"]);
+  for (const [id, raw] of Object.entries(widgets)) {
+    if (id.startsWith("_") || !isObject4(raw)) continue;
+    const row = raw;
+    if (row["data"] !== void 0 && row["data"] !== null) continue;
+    const drill = list2(row["drill"]).filter((name) => typeof name === "string");
+    if (drill.length === 0) continue;
+    const offered = new Set(drill.map((name) => name.toLowerCase()));
+    const listed = JSON.stringify(drill);
+    if (row["kind"] === "breakdown") {
+      const dimension = row["dimension"];
+      if (typeof dimension !== "string" || dimension === "") continue;
+      if (offered.has(dimension.toLowerCase())) continue;
+      problems.push({
+        code: "drill-needs-dimension",
+        pointer: pointer("data", "widgets", id, "drill"),
+        message: `this breakdown is cut by ${JSON.stringify(dimension)} and its drill list ${listed} does not name it, so no legend row answers a click \u2014 the card looks drillable and is not.`,
+        fix: `Put ${JSON.stringify(dimension)} first in drill \u2014 ${JSON.stringify([dimension, ...drill])}: the clicked slice is a value of the card's own dimension, and the levels after it are where the grid goes next.`
+      });
+      continue;
+    }
+    if (row["kind"] !== "table") continue;
+    const declared = list2(row["columns"]).map((column) => isObject4(column) ? column["key"] : void 0).filter((key) => typeof key === "string" && key !== "");
+    const keys2 = declared.length > 0 ? declared : list2(obj(row["source"])["dimensions"]).filter((key) => typeof key === "string");
+    if (keys2.length === 0 || keys2.some((key) => offered.has(key.toLowerCase()))) continue;
+    problems.push({
+      code: "drill-needs-dimension",
+      pointer: pointer("data", "widgets", id, "drill"),
+      message: `this table's drill list ${listed} names none of its columns (${keys2.map((key) => JSON.stringify(key)).join(", ")}), and a cell drills only when its column key is in drill \u2014 so no cell answers a click.`,
+      fix: `Add the column a reader clicks to drill \u2014 e.g. ${JSON.stringify([keys2[0], ...drill])} \u2014 naming the grid's own dimension column first.`
+    });
+  }
+}
 function checkPairing(doc, problems) {
   const data = doc["data"];
   if (!isObject4(data) || !isObject4(data["widgets"])) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datarails-ai/dr-appspace-cli",
-  "version": "0.11.4",
+  "version": "0.12.1",
   "description": "Datarails App Space CLI — build, try, push and publish App Space apps",
   "type": "module",
   "engines": {