@datarails-ai/dr-appspace-cli 0.12.10 → 0.12.12

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.10",
+  version: "0.12.12",
   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-14T19:37:21.073Z";
+var BUILD_TIME = "2026-10-14T20:08:09.415Z";
 function formatBuildTime(iso) {
   if (iso === "") return "";
   const d = new Date(iso);
@@ -6435,7 +6435,7 @@ function endOfRegex(text3, start) {
 // ../flows/insights-builder/kit/contract/extract.mjs
 var CONTRACT_V = 1;
 var GENERATED_BY = "dashboard-kit/contract@1";
-var KIT_REGIONS = /* @__PURE__ */ new Set(["header", "asof", "refresh", "nav", "filters", "controls", "band"]);
+var KIT_REGIONS = /* @__PURE__ */ new Set(["header", "asof", "refresh", "theme", "nav", "filters", "controls", "band"]);
 var DASHBOARD_KIND = "dashboard";
 var BAND_ROLE = "band";
 var GRID_CLASSES = /* @__PURE__ */ new Set(["dr-dash", "dr-grid"]);
@@ -17261,7 +17261,7 @@ var contract_schema_default = {
               properties: {
                 file: { type: "string" },
                 tokens: { type: "object", additionalProperties: { type: "string" } },
-                preset: { type: "string", enum: ["default", "slate", "warm", "contrast", "presentation"], description: "OPTIONAL. A named look from the pinned ui-kit (presentation is refused: ui-kit/v4 shipped without it); absent means default. The compiler fills pages[].theme/density where a page states none from this and app.theme.density, and drops both keys from the filled contract it compares (mirrors fillHeaders)." },
+                preset: { type: "string", enum: ["default", "slate", "warm", "contrast", "presentation"], description: "OPTIONAL. A named look from the pinned ui-kit (presentation is refused: ui-kit/v4 shipped without it); absent means default. A dashboard is built light: slate composes as default, because dark is the viewer's Dark mode switch (the theme region). The compiler fills pages[].theme/density where a page states none from this and app.theme.density, and drops both keys from the filled contract it compares (mirrors fillHeaders)." },
                 density: { type: "string", enum: ["comfortable", "compact"], description: "OPTIONAL. app.theme.density; absent means comfortable. Distinct from pages[].density, which is the compiled data-dr-density string." }
               }
             }
@@ -17277,7 +17277,7 @@ var contract_schema_default = {
         module: { type: "string", description: "dr-widgets, dr-insights, dr-fmt, echarts, ui-kit" },
         version: { type: "string", description: "1.1.1 for a vendor module, v3 for the ui-kit" },
         file: { type: "string" },
-        path: { type: "string", description: "the platform-root path, e.g. vendor/dr-widgets@1.2.1/widgets.js" },
+        path: { type: "string", description: "the platform-root path, e.g. vendor/dr-widgets@1.2.3/widgets.js" },
         rel: { enum: ["script", "stylesheet"] },
         pages: { type: "array", items: { type: "string" } },
         order: { type: "integer", minimum: 0, description: "load order: where this module is first reached across the bundle" }
@@ -17326,7 +17326,7 @@ var contract_schema_default = {
           }
         },
         scripts: { type: "array", items: { type: "string" }, description: "the bundle scripts this page loads" },
-        theme: { type: ["string", "null"], description: "data-dr-theme: default, slate, warm, contrast" },
+        theme: { type: ["string", "null"], description: "data-dr-theme: default, warm, contrast. A dashboard is built light, so slate composes as default (dark is the viewer's Dark mode switch); a page read back from a dashboard built before that may still say slate." },
         density: { type: ["string", "null"], description: "data-dr-density" },
         mount: {
           oneOf: [
@@ -17446,7 +17446,7 @@ var contract_schema_default = {
           enum: ["region", "grid", "widget", "control", "nav", "tab", "slot", "form", "list", "detail", "queue", "action", "filter", "stat", "chart", "custom", "field", "number_input", "tabs", "tab_panel", "select", "date_picker", "data_grid", "dialog", "variance_table", "toggle", "control_group", "callout", "scenario_columns", "slider", "button", "status", "badge", "tag", "empty_state", "stepper", "alert", "checkbox", "radio_group", "file_upload", "skeleton", "progress", "accordion", "tooltip_info", "filter_bar", "filter_chip", "date_range", "fiscal_month", "search_input", "split_pane", "file_viewer", "line_grid", "document", "panel"],
           description: "the dashboard vocabulary (region, grid, widget, control, nav, tab, slot) and the App Builder's component vocabulary (form, list, detail, queue, action, filter, the stat tile that reads one measure out of a summary handler, the chart that draws the rows one list, inbox or custom handler answers, the custom component a module under ui/components draws, and the field that sits inside one). widget is shared: on an app page it is a dashboard card too, drawn by dr-app-widgets in the kind data-dr-kind names, over the one widget payload the handler data-dr-source names answers"
         },
-        role: { type: ["string", "null"], description: "a region's data-dr-kit (header, asof, refresh, nav, filters, controls), a widget's kind, a control's kind, a slot's name. Null for a component: its kind IS its type, and the role it is meant for is props.role." },
+        role: { type: ["string", "null"], description: "a region's data-dr-kit (header, asof, refresh, theme, nav, filters, controls), a widget's kind, a control's kind, a slot's name. Null for a component: its kind IS its type, and the role it is meant for is props.role." },
         id: { type: ["string", "null"] },
         tag: { type: ["string", "null"], description: "null for an element read out of a built bundle, which no longer says what it renders" },
         classes: { type: "array", items: { type: "string" } },
@@ -19808,6 +19808,9 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 var THEME_FILE3 = "ui/theme.css";
 var PRESETS2 = ["default", "slate", "warm", "contrast"];
 var DEFAULT_PRESET = "default";
+var DARK_PRESET = "slate";
+var CANVAS_TOKENS = /* @__PURE__ */ new Set(["--dr-surface", "--dr-page", "--dr-border"]);
+var DARK_SURFACE_BELOW = 0.18;
 var SPAN_BY_KIND = {
   kpi: 3,
   line: 6,
@@ -19890,13 +19893,21 @@ function composeLayout(contract) {
   const app = isPlainObject7(out.app) ? out.app : out.app = {};
   const pages = Array.isArray(out.pages) ? out.pages : out.pages = [];
   const elements = isPlainObject7(out.elements) ? out.elements : out.elements = {};
-  const preset = presetOf(app, pages);
+  const asked = presetOf(app, pages);
+  const preset = asked === DARK_PRESET ? DEFAULT_PRESET : asked;
   if (isPlainObject7(app.theme) && "preset" in app.theme) delete app.theme.preset;
   for (const page of pages) {
     const path3 = page.path ?? "ui/index.html";
     if (page.theme === void 0 || page.theme === null) {
       page.theme = preset;
       record2("page.theme", path3, `${path3} opens on the "${preset}" theme`);
+    } else if (page.theme === DARK_PRESET) {
+      page.theme = DEFAULT_PRESET;
+      record2(
+        "page.theme",
+        path3,
+        `${path3} opens on the "${DEFAULT_PRESET}" theme: "${DARK_PRESET}" is the viewer's Dark mode switch, not a look a dashboard is built on`
+      );
     }
     if (page.density === void 0) page.density = null;
     if (page.title === void 0 || page.title === null) {
@@ -19971,6 +19982,21 @@ function composeTheme(app, preset, record2) {
   const table = THEME_TOKENS[preset] ?? THEME_TOKENS[DEFAULT_PRESET];
   const theme = isPlainObject7(app.theme) ? app.theme : {};
   const tokens = isPlainObject7(theme.tokens) ? { ...theme.tokens } : {};
+  const dark = THEME_TOKENS[DARK_PRESET];
+  if (isDarkSurface(tokens["--dr-surface"], dark["--dr-surface"], tokens)) {
+    let lightened = 0;
+    for (const [token, value] of Object.entries(dark)) {
+      if (table[token] === void 0 || tokens[token] === table[token]) continue;
+      if (tokens[token] !== value && !CANVAS_TOKENS.has(token)) continue;
+      tokens[token] = table[token];
+      lightened += 1;
+    }
+    record2(
+      "theme.tokens",
+      THEME_FILE3,
+      `${lightened} palette token(s) moved from the "${DARK_PRESET}" preset to "${preset}": a dashboard is built light, and dark is the viewer's Dark mode switch`
+    );
+  }
   let filled = 0;
   for (const [token, value] of Object.entries(table)) {
     if (token in tokens) continue;
@@ -19986,6 +20012,21 @@ function composeTheme(app, preset, record2) {
     );
   }
 }
+function isDarkSurface(value, darkSurface, tokens, seen = /* @__PURE__ */ new Set()) {
+  if (typeof value !== "string") return false;
+  const alias = /^var\(\s*(--[a-z0-9-]+)\s*(?:,[^)]*)?\)$/i.exec(value.trim());
+  if (alias) {
+    if (seen.has(alias[1])) return false;
+    seen.add(alias[1]);
+    return isDarkSurface(tokens[alias[1]], darkSurface, tokens, seen);
+  }
+  if (value === darkSurface) return true;
+  try {
+    return luminance(value) < DARK_SURFACE_BELOW;
+  } catch {
+    return false;
+  }
+}
 function presetOf(app, pages) {
   const asked = isPlainObject7(app.theme) ? app.theme.preset : null;
   if (typeof asked === "string" && PRESETS2.includes(asked)) return asked;
@@ -20371,6 +20412,9 @@ function appbar(page, elements) {
     "  </div>",
     '  <div class="dr-appbar__actions">',
     `    <button type="button" class="${classesOf2(elements, "region", "refresh", ["dr-btn", "dr-btn--secondary", "dr-btn--sm"])}" data-dr-kit="refresh">Refresh</button>`,
+    // The viewer's light/dark switch: dr-widgets flips the body between this
+    // page's own preset and slate, and remembers the choice per app.
+    `    <button type="button" class="${classesOf2(elements, "region", "theme", ["dr-btn", "dr-btn--secondary", "dr-btn--sm"])}" data-dr-kit="theme" aria-pressed="false">Dark mode</button>`,
     "  </div>",
     "</header>"
   ];
@@ -27131,7 +27175,7 @@ var kit_default = {
   fmt: "dr-fmt@2.0.1",
   markdown: "dr-md@1.0.0",
   uiKit: "ui-kit/v4",
-  widgets: "dr-widgets@1.2.1"
+  widgets: "dr-widgets@1.2.3"
 };
 
 // ../flows/appspace-builder/kit/kit.json
@@ -27721,7 +27765,7 @@ function roundTripDiffs(input, extracted, compilerProblems = [], { order: order2
   const stated2 = order2 === void 0 ? {} : { order: order2 };
   const read = order2 === void 0 ? {} : { order: "keys" };
   const left = stripPositional(normaliseApp(input), stated2);
-  const right = stripPositional(normaliseApp(extracted), read);
+  const right = stripPositional(normaliseApp(withoutUnstatedChrome(input, extracted)), read);
   const declared = compilerProblems.some((problem5) => problem5.code === DECLARED_LOSS);
   const diffs = [];
   for (const section of ["app", "pages", "elements", "data"]) {
@@ -27746,6 +27790,40 @@ function roundTripDiffs(input, extracted, compilerProblems = [], { order: order2
   }
   return diffs.slice(0, 40);
 }
+var ADDED_CHROME = /* @__PURE__ */ new Set(["theme"]);
+function withoutUnstatedChrome(input, extracted) {
+  if (!isPlain(input) || !isPlain(extracted)) return extracted;
+  const want = input["elements"];
+  const got = extracted["elements"];
+  if (!isPlain(want) || !isPlain(got)) return extracted;
+  const regionOf = (element) => `${String(element["page"] ?? "")}|${String(element["role"] ?? "")}`;
+  const statedRegions = new Set(
+    Object.values(want).filter((element) => isPlain(element) && element["type"] === "region").map(regionOf)
+  );
+  const unstated = new Set(
+    Object.entries(got).filter(([, element]) => {
+      if (!isPlain(element) || element["type"] !== "region") return false;
+      if (!ADDED_CHROME.has(String(element["role"] ?? ""))) return false;
+      const children = element["children"];
+      return !statedRegions.has(regionOf(element)) && (!Array.isArray(children) || children.length === 0);
+    }).map(([uid]) => uid)
+  );
+  if (unstated.size === 0) return extracted;
+  const out = JSON.parse(JSON.stringify(extracted));
+  const elements = out["elements"];
+  for (const uid of unstated) delete elements[uid];
+  for (const element of Object.values(elements)) {
+    if (isPlain(element) && Array.isArray(element["children"])) {
+      element["children"] = element["children"].filter((uid) => !unstated.has(String(uid)));
+    }
+  }
+  for (const page of Array.isArray(out["pages"]) ? out["pages"] : []) {
+    if (isPlain(page) && Array.isArray(page["tree"])) {
+      page["tree"] = page["tree"].filter((uid) => !unstated.has(String(uid)));
+    }
+  }
+  return out;
+}
 function normaliseApp(contract) {
   if (typeof contract !== "object" || contract === null) return contract;
   const out = JSON.parse(JSON.stringify(contract));

package/package.json

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