@datarails-ai/dr-appspace-cli 0.12.35 → 0.12.36

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.12.35",
+  version: "0.12.36",
   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-26T12:46:38.741Z";
+var BUILD_TIME = "2026-10-26T13:45:46.965Z";
 function formatBuildTime(iso) {
   if (iso === "") return "";
   const d = new Date(iso);
@@ -10522,7 +10522,7 @@ function compile(contract, { kit, extra = {} } = {}) {
   for (const page of pages) {
     files[page.path] = pageFile(page, { contract: composed, pages, kit, problems });
   }
-  return { files, problems: problems.sort(byProblem2) };
+  return { files, problems: problems.sort(byProblem2), warnings: narrativeOrderWarnings(composed, applied) };
 }
 var RUNTIME_RENDERER2 = "runtime";
 function dashboardHandler(composed, handlerName, extra = {}) {
@@ -10598,6 +10598,43 @@ function missingExpressions(widgets) {
   }
   return problems;
 }
+function narrativeOrderWarnings(composed, applied) {
+  const picked = new Set(applied.filter((fill) => fill.what === "layout.order").map((fill) => fill.where));
+  const elements = isPlainObject6(composed?.elements) ? composed.elements : {};
+  const widgets = isPlainObject6(composed?.data?.widgets) ? composed.data.widgets : {};
+  const pages = [...Array.isArray(composed?.pages) ? composed.pages : []].sort((a, b) => natural3(a.path ?? "", b.path ?? ""));
+  const named13 = (value) => typeof value === "string" && value !== "";
+  const quoted3 = (ids) => ids.map((id) => JSON.stringify(id)).join(", ");
+  const warnings = [];
+  for (const page of pages) {
+    if (picked.has(page.path)) continue;
+    const sections = Array.isArray(page.sections) ? page.sections : [];
+    const sectionOf4 = (uid) => sections.findIndex((entry) => isPlainObject6(entry) && entry.id === elements[uid].section);
+    const cards = Object.keys(elements).filter((uid) => elements[uid]?.page === page.path && elements[uid]?.type === "widget").sort((a, b) => sectionOf4(a) - sectionOf4(b) || order(elements[a]) - order(elements[b]) || natural3(a, b));
+    const specOf2 = (uid) => {
+      const element = elements[uid];
+      const props = isPlainObject6(element.props) ? element.props : {};
+      return named13(element.id) ? element.id : named13(props.card) ? props.card : named13(props.id) ? props.id : uid;
+    };
+    cards.forEach((uid, at) => {
+      const own2 = specOf2(uid);
+      const row = widgets[own2];
+      const about = isPlainObject6(row) && row.kind === "narrative" && Array.isArray(row.about) ? row.about.filter((id) => named13(id) && id !== own2) : [];
+      if (about.length === 0) return;
+      const after = cards.slice(at + 1).filter((other) => sectionOf4(other) === sectionOf4(uid) && about.includes(specOf2(other)));
+      if (after.length === 0) return;
+      const later = [...new Set(after.map(specOf2))];
+      const last = specOf2(after[after.length - 1]);
+      const where2 = sectionOf4(uid) === -1 ? page.path : `section "${sections[sectionOf4(uid)].id}" of ${page.path}`;
+      warnings.push({
+        code: "narrative_before_about",
+        pointer: `/elements/${escapePointer3(uid)}/order`,
+        message: `narrative "${own2}" comes before ${quoted3(later)}, ${later.length === 1 ? "a card" : "cards"} it is about, on ${where2}: it reads the cards it is about as it loads, so its context gives ${quoted3(later)} as "(not loaded yet)". The page keeps the order you stated; move "${own2}" after "${last}"`
+      });
+    });
+  }
+  return warnings;
+}
 var DEFAULT_CAPABILITIES = { financeos: ["metrics:read", "raw:read"] };
 function manifestFile(contract, handlerName) {
   const app = contract.app ?? {};
@@ -11078,7 +11115,7 @@ function compileDashboard(contract, { kit = null, extra = {}, uiKit, charts, fmt
   files[handlerPath(composed, handlerName)] = handler.text;
   const shelf2 = { runtime: DASHBOARD_RUNTIME, widgets: DASHBOARD_WIDGETS, bar: DASHBOARD_BAR, assistant, markdown, uiKit, charts, fmt, appComponents, appControls };
   for (const page of whole.pages) files[page.path] = pageHtml(whole, page, elements, tree, shelf2);
-  return { files, problems, contract: whole, order: order2, warnings: [] };
+  return { files, problems, contract: whole, order: order2, warnings: narrativeOrderWarnings(composed, applied) };
 }
 function isRefusal(problem5) {
   return problem5.lossy !== false;

package/package.json

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