@malloydata/malloyyo 0.2.35 → 0.2.37

package/dist/frame-runtime/runtime.tsx

@@ -10,6 +10,7 @@
 //
 // Injected frame globals (read lazily — script order differs between hosts):
 //   window.__DASHBOARD__        { name, query, title, description? }  (the # artifact tag)
+//   window.__DASHBOARDS__       [{ name, title, description?, href }]  (the siblings, nav order)
 //   window.__GIVENS__           given specs introspected from the model's given: decls
 //   window.__INITIAL_GIVENS__   URL-seeded given values ($-prefixed) for shareable links
 //   window.__INITIAL_URLSTATE__ URL-seeded useUrlState view-state (~-prefixed)
@@ -33,6 +34,13 @@ import { combineTiles } from "./combine";
 export { filters };
 
 export const dashboardInfo = () => window.__DASHBOARD__ || {};
+
+/** The dashboard's SIBLINGS: `[{ name, title, description?, href }]`, in nav
+    order, with this one excluded. Every host injects it (dev server, hosted
+    frame, static bundle), so a component that links to other dashboards — the
+    About page's card list, a "see also" — is written once and works on all
+    three. Empty when a host supplies nothing, so reading it is always safe. */
+export const dashboardList = () => window.__DASHBOARDS__ || [];
 export const givenSpecs = () => window.__GIVENS__ || [];
 
 // ── host bridge ─────────────────────────────────────────────────────
@@ -936,6 +944,7 @@ function Root({ Dashboard, extraProps }) {
       <UrlStateCtx.Provider value={urlCtx}>
         <Dashboard
           dashboard={dashboardInfo()}
+          dashboards={dashboardList()}
           givenSpecs={givenSpecs()}
           givens={committed}
           setGiven={setGiven}
@@ -966,6 +975,20 @@ function Root({ Dashboard, extraProps }) {
 // stays legible; override --dash-panel-bg if your renderer output is dark-safe.
 const THEME_CSS = `
 :root {
+  /* The static site's variable names, aliased onto the theme.
+     A written page (the About page, most obviously) is authored against the
+     bundle's site.css, which names them --bg/--fg/--card/--line/--muted/--accent.
+     The same component also runs here — under the dev server and in the hosted
+     frame — where only --dash-* exists, so without these it renders with
+     transparent cards and invisible borders: technically fine, visibly broken.
+     Defined first and with plain names so a page may still override them. */
+  --bg: var(--dash-bg, #ffffff);
+  --fg: var(--dash-fg, #111418);
+  --card: var(--dash-panel-bg, #ffffff);
+  --line: var(--dash-border, #e5e7eb);
+  --muted: var(--dash-muted, #6b7280);
+  --accent: var(--dash-accent, #1573a1);
+
   --dash-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
   --dash-bg: #ffffff;
   --dash-fg: #171717;
@@ -1029,8 +1052,61 @@ function injectTheme(bodyReset) {
     `rootEl` (defaults to #root, the sandboxed iframe's mount node). The tag-only
     in-page host passes its own container so the dashboard mounts directly in the
     trusted page — no iframe. */
+/**
+ * Route a click on a sibling link through the host's navigate bridge.
+ *
+ * A written page (the About page) links to its siblings as ordinary anchors —
+ * that is what makes the same component work as a plain static page in a
+ * `dashboard bundle`. Inside a framed host it is NOT a plain page: the document
+ * is a sandboxed iframe on its own origin, so a relative href navigates the
+ * FRAME to a URL that does not exist there (the dev server answers "not found"
+ * on the frame port), and a top-level href would need allow-top-navigation,
+ * which the sandbox deliberately withholds.
+ *
+ * The bridge already solves this for drill: only the trusted parent knows the
+ * environment's dashboard shape (hosted /datasets/:id/dashboard/:slug vs local
+ * /?d=slug). So intercept the click and hand the parent a NAME, exactly as drill
+ * does. The anchor keeps its href, so the static build is untouched and the link
+ * still shows a real target on hover.
+ *
+ * Deliberately capture-phase and non-destructive: modified clicks (new tab,
+ * download) and anchors that aren't siblings fall through untouched.
+ */
+/** Installed once per document. `mount()` runs again on every client-side
+    navigation between tag-only dashboards (TagOnlyDashboard unmounts the React
+    root and re-mounts), and a listener added per mount is never removed — so
+    without this each visit would add another handler and one click would fire
+    navigate once per handler. injectTheme guards itself the same way. */
+let siblingLinksInstalled = false;
+
+function interceptSiblingLinks() {
+  if (typeof document === "undefined" || siblingLinksInstalled) return;
+  siblingLinksInstalled = true;
+  document.addEventListener(
+    "click",
+    (e: any) => {
+      if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+      const a = e.target && e.target.closest ? e.target.closest("a[href]") : null;
+      if (!a || a.target === "_blank" || a.hasAttribute("download")) return;
+      // dashboardList() is read HERE, per click, not captured at mount: the
+      // header's rule is that injected globals are read lazily because script
+      // order differs between hosts, and a host that sets __DASHBOARDS__ after
+      // the bundle runs would otherwise get no interception at all — silently,
+      // which is the very failure this exists to prevent.
+      // Matched on the authored attribute, which is what the host injected.
+      const href = a.getAttribute("href");
+      const hit = dashboardList().find((d: any) => d && d.href === href);
+      if (!hit) return;
+      e.preventDefault();
+      host.navigate(hit.name, {});
+    },
+    true,
+  );
+}
+
 export function mount(Dashboard, extraProps, rootEl: any = null, opts: any = {}) {
   injectTheme(opts.bodyReset !== false);
+  interceptSiblingLinks();
   window.addEventListener("error", (e) => {
     if (isBenign(e && e.message)) return;
     showFatal((e.error && e.error.stack) || e.message);

package/dist/index.js

@@ -558,6 +558,9 @@ function stripScalarArrayValue(parent, groups) {
   if (!isScalarArray(parent)) return groups;
   return { ...groups, dimensions: groups.dimensions.filter((f) => f.name !== "value") };
 }
+function rawDef(structDefFields, name) {
+  return structDefFields.find((x) => (x.as ?? x.name) === name);
+}
 function fieldKind(af, structDefFields) {
   const raw = structDefFields.find((x) => x.name === af.name);
   const et = raw?.expressionType;
@@ -617,6 +620,7 @@ function walkFields(fields, structDefFields, depth, ctx, anon) {
     const mLoc = f.location;
     const local = isLocal(mLoc, ctx.rootUri);
     const loc = local ? toLoc(mLoc) : void 0;
+    const access = rawDef(structDefFields, f.name)?.accessModifier;
     if (f.isExploreField()) {
       const ef = f;
       const cls = classifyJoinTarget(ef, ctx.knownSources);
@@ -630,6 +634,7 @@ function walkFields(fields, structDefFields, depth, ctx, anon) {
       if (needsQuote(f.name)) join5.must_quote = true;
       if (annotations.length > 0) join5.annotations = annotations;
       if (loc) join5.location = loc;
+      if (access) join5.access = access;
       const synthetic = isScalarArray(ef) || isRepeatedRecord(ef) || isAnonymousRecord(ef);
       if (isScalarArray(ef)) join5.column_shape = "scalar_array";
       else if (isRepeatedRecord(ef)) join5.column_shape = "record_array";
@@ -653,6 +658,7 @@ function walkFields(fields, structDefFields, depth, ctx, anon) {
       if (needsQuote(f.name)) view.must_quote = true;
       if (annotations.length > 0) view.annotations = annotations;
       if (loc) view.location = loc;
+      if (access) view.access = access;
       if (mLoc) {
         const body = sliceSource(ctx.readSource(mLoc.url), mLoc);
         if (body) view.body = body;
@@ -669,6 +675,7 @@ function walkFields(fields, structDefFields, depth, ctx, anon) {
     if (expr && expr !== f.name) info.expression = expr;
     if (annotations.length > 0) info.annotations = annotations;
     if (loc) info.location = loc;
+    if (access) info.access = access;
     if (fieldKind(af, structDefFields) === "measure") groups.measures.push(info);
     else groups.dimensions.push(info);
   }
@@ -840,6 +847,31 @@ async function compile(runtime, entry, opts = {}) {
     return { ok: false, problems: [errorProblem(e, entry.href)] };
   }
 }
+var isPublic = (m) => m.access === void 0;
+function publicGroups(g) {
+  return {
+    dimensions: g.dimensions.filter(isPublic),
+    measures: g.measures.filter(isPublic),
+    views: g.views.filter(isPublic),
+    joins: g.joins.filter(isPublic).map(
+      (j) => j.fields ? { ...j, fields: publicGroups(j.fields) } : j
+    )
+  };
+}
+function publicSource(s) {
+  const groups = publicGroups(s);
+  const out = { ...s, ...groups };
+  if (out.primary_key && !groups.dimensions.some((d) => d.name === out.primary_key)) {
+    out.primary_key = null;
+  }
+  if (s.anon_srcs) out.anon_srcs = s.anon_srcs.map(publicSource);
+  return out;
+}
+function publicOnlyModel(m) {
+  const sources = {};
+  for (const [name, s] of Object.entries(m.sources)) sources[name] = publicSource(s);
+  return { ...m, sources };
+}
 var EMPTY_GROUPS = { dimensions: [], measures: [], views: [], joins: [] };
 var seg = (m) => m.must_quote ? `\`${m.name}\`` : m.name;
 var barePath = (prefix, j) => prefix ? `${prefix}.${j.name}` : j.name;
@@ -986,7 +1018,8 @@ function emitSourceJoin(j, bare, quoted, anonScope, fans, namedOnPath, anonOnPat
     );
   }
 }
-function buildSourceDescribe(model, name) {
+function buildSourceDescribe(compiled, name) {
+  const model = publicOnlyModel(compiled);
   const root = model.sources[name];
   if (!root) return void 0;
   const ctx = { model, joins: /* @__PURE__ */ Object.create(null), map: /* @__PURE__ */ Object.create(null) };
@@ -2443,6 +2476,97 @@ async function makeRunner(root) {
   };
 }
 
+// src/discover.ts
+import fs3 from "node:fs";
+import path4 from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire as createRequire2 } from "node:module";
+var require2 = createRequire2(import.meta.url);
+var HOST_LIBS = [
+  "react",
+  "react-dom",
+  "react-dom/client",
+  "react/jsx-runtime",
+  "react/jsx-dev-runtime",
+  "@malloydata/render",
+  "@malloydata/malloy-filter"
+];
+var HOST_ALIAS = {};
+for (const spec of HOST_LIBS) {
+  try {
+    HOST_ALIAS[spec] = require2.resolve(spec);
+  } catch {
+  }
+}
+function resolveRuntimeDir() {
+  const candidates = [
+    new URL("./frame-runtime/", import.meta.url),
+    // src/dashboard.ts (tsx) OR dist/index.js (published)
+    new URL("../src/frame-runtime/", import.meta.url)
+    // built dist/ next to sibling src/ (checkout)
+  ].map((u) => fileURLToPath(u));
+  const found = candidates.find((c) => fs3.existsSync(c));
+  if (!found) {
+    throw new Error(
+      "frame-runtime/ not found next to the CLI (looked in ./frame-runtime and ../src/frame-runtime). A published install should ship it in dist/; reinstall the CLI, or rebuild with `npm run build`."
+    );
+  }
+  return found;
+}
+var hostAliasPlugin = {
+  name: "host-alias",
+  setup(b) {
+    b.onResolve(
+      { filter: /^(react($|\/)|react-dom($|\/)|@malloydata\/(render|malloy-filter)$)/ },
+      (args) => HOST_ALIAS[args.path] ? { path: HOST_ALIAS[args.path] } : void 0
+    );
+  }
+};
+async function discoverDashboards(root, runner) {
+  const dir = path4.join(root, "dashboards");
+  if (!fs3.existsSync(dir)) return [];
+  const files = fs3.readdirSync(dir).filter((f) => f.endsWith(".malloy")).sort();
+  const dashboards = [];
+  for (const file of files) {
+    const base = file.slice(0, -".malloy".length);
+    const entryFile = path4.join("dashboards", file);
+    const res = await runner.artifactForFile(entryFile, base);
+    if (!res.ok) throw new Error(`dashboard ${file}: ${res.error}`);
+    if (!res.artifact) continue;
+    const component = ["jsx", "tsx"].map((ext) => path4.join(dir, `${base}.${ext}`)).find((p) => fs3.existsSync(p));
+    dashboards.push({ ...res.artifact, name: res.artifact.name || base, entryFile, tsxPath: component });
+  }
+  const about = aboutPage(root);
+  if (about && !dashboards.some((d) => d.name === about.name)) dashboards.unshift(about);
+  return dashboards;
+}
+function browserBuildBase() {
+  const shims = path4.join(resolveRuntimeDir(), "..", "shims");
+  return {
+    platform: "browser",
+    jsx: "automatic",
+    loader: { ".css": "empty" },
+    define: { "process.env.NODE_ENV": '"production"' },
+    alias: {
+      assert: path4.join(shims, "assert.cjs"),
+      util: path4.join(shims, "util.cjs")
+    },
+    banner: {
+      js: "globalThis.process||={env:{},platform:'browser',versions:{},argv:[],cwd:()=>'/'};"
+    }
+  };
+}
+var ABOUT_NAME = "index";
+var ABOUT_TITLE = "About";
+function aboutPage(root) {
+  const dir = path4.join(root, "dashboards");
+  if (fs3.existsSync(path4.join(dir, "index.malloy"))) return null;
+  const component = ["jsx", "tsx"].map((ext) => path4.join(dir, `index.${ext}`)).find((p) => fs3.existsSync(p));
+  if (!component) return null;
+  return { name: ABOUT_NAME, query: "", title: ABOUT_TITLE, tsxPath: component };
+}
+var rendersNoData = (d) => !d.query && (!d.tiles || d.tiles.length === 0);
+
 // src/gather.ts
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git"]);
 function gatherDirectory(dir) {
@@ -2494,6 +2618,14 @@ async function gatherDashboards(dir) {
         source: component ? readFileSync2(component, "utf8") : ""
       });
     }
+    const about = aboutPage(dir);
+    if (about?.tsxPath && !payloads.some((p) => p.name === about.name)) {
+      payloads.unshift({
+        name: about.name,
+        manifest: { title: about.title },
+        source: readFileSync2(about.tsxPath, "utf8")
+      });
+    }
     return payloads;
   } finally {
     await runner.dispose();
@@ -2538,6 +2670,16 @@ function componentQueryLiterals(source) {
   while ((m = re.exec(source)) !== null) out.add(m[2].trim());
   return [...out];
 }
+function landingPageErrors(dir, file) {
+  const ext = file.endsWith(".tsx") ? "tsx" : "jsx";
+  try {
+    esbuild.transformSync(readFileSync3(join3(dir, file), "utf8"), { loader: ext, jsx: "automatic" });
+    return [];
+  } catch (e) {
+    const msg = e.errors?.map((x) => x.text).join("; ") ?? String(e);
+    return [`${file}: ${msg}`];
+  }
+}
 async function lintDashboards(root) {
   const abs = resolve(root);
   const runner = await makeRunner(abs);
@@ -2560,13 +2702,16 @@ async function runLint(abs, runner) {
   const malloyBases = new Set(malloyFiles.map((f) => f.slice(0, -".malloy".length)));
   for (const c of entries.filter((f) => /\.(jsx|tsx)$/.test(f)).sort()) {
     const cbase = c.replace(/\.(jsx|tsx)$/, "");
-    if (!malloyBases.has(cbase)) {
-      dashboards.push({
-        name: c,
-        errors: [`component "${c}" has no matching "${cbase}.malloy" dashboard`],
-        warnings: []
-      });
+    if (malloyBases.has(cbase)) continue;
+    if (cbase === "index") {
+      dashboards.push({ name: c, errors: landingPageErrors(dir, c), warnings: [] });
+      continue;
     }
+    dashboards.push({
+      name: c,
+      errors: [`component "${c}" has no matching "${cbase}.malloy" dashboard`],
+      warnings: []
+    });
   }
   const seenNames = /* @__PURE__ */ new Map();
   for (const file of malloyFiles) {
@@ -2735,7 +2880,7 @@ function clearCreds(url6) {
 }
 
 // package.json
-var version = "0.2.35";
+var version = "0.2.37";
 
 // src/http.ts
 var USER_AGENT = `malloyyo/${version}`;
@@ -2917,8 +3062,8 @@ Run:  malloyyo login ${target.name}`);
 }
 
 // src/mcp.ts
-import fs3 from "node:fs";
-import path4 from "node:path";
+import fs4 from "node:fs";
+import path5 from "node:path";
 import url4 from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -3007,7 +3152,7 @@ function defaultConfig(rootUrl) {
   });
 }
 async function loadConfig2(root, reader) {
-  const rootUrl = url4.pathToFileURL(root + path4.sep);
+  const rootUrl = url4.pathToFileURL(root + path5.sep);
   let discovered;
   try {
     discovered = await discoverConfig2(rootUrl, rootUrl, reader);
@@ -3029,13 +3174,13 @@ function fsReader2() {
       if (u.protocol !== "file:") {
         throw new Error(`unsupported URL scheme for import: ${u.href}`);
       }
-      return fs3.promises.readFile(u, "utf8");
+      return fs4.promises.readFile(u, "utf8");
     }
   };
 }
 function resolveUnderRoot(root, p) {
-  const abs = p.includes("://") ? path4.resolve(decodeURIComponent(new URL(p).pathname)) : path4.resolve(root, p);
-  if (abs !== root && !abs.startsWith(root + path4.sep)) {
+  const abs = p.includes("://") ? path5.resolve(decodeURIComponent(new URL(p).pathname)) : path5.resolve(root, p);
+  if (abs !== root && !abs.startsWith(root + path5.sep)) {
     throw new Error(`path is outside the project root: ${p}`);
   }
   return abs;
@@ -3044,7 +3189,7 @@ function makeConfigSource(root) {
   let cached;
   const signature = () => ["malloy-config.json", "malloy-config-local.json"].map((name) => {
     try {
-      const st = fs3.statSync(path4.join(root, name));
+      const st = fs4.statSync(path5.join(root, name));
       return `${name}:${st.mtimeMs}:${st.size}`;
     } catch {
       return `${name}:absent`;
@@ -3064,7 +3209,7 @@ function makeWithRuntime(root, currentConfig) {
     return gateConfigProblems(problems, async () => {
       const resolved = "url" in input ? { url: resolveUnderRoot(root, input.url) } : {
         source: input.source,
-        baseUrl: input.baseUrl ? resolveUnderRoot(root, input.baseUrl) : root + path4.sep
+        baseUrl: input.baseUrl ? resolveUnderRoot(root, input.baseUrl) : root + path5.sep
       };
       const { reader, entry, readSource } = prepareSource(fsReader2(), resolved);
       const runtime = new Runtime2({ config, urlReader: reader });
@@ -3078,7 +3223,7 @@ function makeWithRuntime(root, currentConfig) {
 }
 function makeExploreHost(root, currentConfig) {
   const withRuntime = makeWithRuntime(root, currentConfig);
-  const published = (ref) => ref === ENTRY2 && fs3.existsSync(path4.join(root, ENTRY2));
+  const published = (ref) => ref === ENTRY2 && fs4.existsSync(path5.join(root, ENTRY2));
   return {
     withModel: (ref, fn) => {
       if (!published(ref)) throw new Error(`no published model '${ref}'`);
@@ -3099,7 +3244,7 @@ function makeDevelopHost(root, currentConfig) {
 }
 async function serveMcp(opts) {
   await initConnections();
-  const root = path4.resolve(opts.root ?? process.cwd());
+  const root = path5.resolve(opts.root ?? process.cwd());
   const mode = opts.mode ?? "explore";
   const currentConfig = makeConfigSource(root);
   const surface = mode === "develop" ? developSurface(makeDevelopHost(root, currentConfig)) : exploreSurface(makeExploreHost(root, currentConfig));
@@ -3172,84 +3317,13 @@ function navHtml(active, all, href, homeHref = "./") {
   ).join("");
   return `<nav class="dash-nav">${brand}<span class="sep"></span>${links}</nav>`;
 }
-
-// src/discover.ts
-import fs4 from "node:fs";
-import path5 from "node:path";
-import { fileURLToPath } from "node:url";
-import { createRequire as createRequire2 } from "node:module";
-var require2 = createRequire2(import.meta.url);
-var HOST_LIBS = [
-  "react",
-  "react-dom",
-  "react-dom/client",
-  "react/jsx-runtime",
-  "react/jsx-dev-runtime",
-  "@malloydata/render",
-  "@malloydata/malloy-filter"
-];
-var HOST_ALIAS = {};
-for (const spec of HOST_LIBS) {
-  try {
-    HOST_ALIAS[spec] = require2.resolve(spec);
-  } catch {
-  }
-}
-function resolveRuntimeDir() {
-  const candidates = [
-    new URL("./frame-runtime/", import.meta.url),
-    // src/dashboard.ts (tsx) OR dist/index.js (published)
-    new URL("../src/frame-runtime/", import.meta.url)
-    // built dist/ next to sibling src/ (checkout)
-  ].map((u) => fileURLToPath(u));
-  const found = candidates.find((c) => fs4.existsSync(c));
-  if (!found) {
-    throw new Error(
-      "frame-runtime/ not found next to the CLI (looked in ./frame-runtime and ../src/frame-runtime). A published install should ship it in dist/; reinstall the CLI, or rebuild with `npm run build`."
-    );
-  }
-  return found;
-}
-var hostAliasPlugin = {
-  name: "host-alias",
-  setup(b) {
-    b.onResolve(
-      { filter: /^(react($|\/)|react-dom($|\/)|@malloydata\/(render|malloy-filter)$)/ },
-      (args) => HOST_ALIAS[args.path] ? { path: HOST_ALIAS[args.path] } : void 0
-    );
-  }
-};
-async function discoverDashboards(root, runner) {
-  const dir = path5.join(root, "dashboards");
-  if (!fs4.existsSync(dir)) return [];
-  const files = fs4.readdirSync(dir).filter((f) => f.endsWith(".malloy")).sort();
-  const dashboards = [];
-  for (const file of files) {
-    const base = file.slice(0, -".malloy".length);
-    const entryFile = path5.join("dashboards", file);
-    const res = await runner.artifactForFile(entryFile, base);
-    if (!res.ok) throw new Error(`dashboard ${file}: ${res.error}`);
-    if (!res.artifact) continue;
-    const component = ["jsx", "tsx"].map((ext) => path5.join(dir, `${base}.${ext}`)).find((p) => fs4.existsSync(p));
-    dashboards.push({ ...res.artifact, name: res.artifact.name || base, entryFile, tsxPath: component });
-  }
-  return dashboards;
-}
-function browserBuildBase() {
-  const shims = path5.join(resolveRuntimeDir(), "..", "shims");
-  return {
-    platform: "browser",
-    jsx: "automatic",
-    loader: { ".css": "empty" },
-    define: { "process.env.NODE_ENV": '"production"' },
-    alias: {
-      assert: path5.join(shims, "assert.cjs"),
-      util: path5.join(shims, "util.cjs")
-    },
-    banner: {
-      js: "globalThis.process||={env:{},platform:'browser',versions:{},argv:[],cwd:()=>'/'};"
-    }
-  };
+function siblingList(current, all, href) {
+  return all.filter((d) => d.name !== current).map((d) => ({
+    name: d.name,
+    title: d.title || d.name,
+    ...d.description ? { description: d.description } : {},
+    href: href(d.name)
+  }));
 }
 
 // src/dashboard.ts
@@ -3330,6 +3404,7 @@ function makeInPageBundler() {
   };
 }
 var html = (body, title) => `<!doctype html><html><head><meta charset="utf-8"><title>${esc2(title)}</title><meta name="viewport" content="width=device-width,initial-scale=1"><style>${NAV_CSS}</style></head><body style="margin:0">${body}</body></html>`;
+var devSiblings = (dash, all) => siblingList(dash.name, all, (n) => `/?d=${encodeURIComponent(n)}`);
 function navHtml2(dash, all) {
   return navHtml(dash.name, all, (n) => `/?d=${encodeURIComponent(n)}`);
 }
@@ -3346,7 +3421,7 @@ function inPageShell(dash, all, givenSpecs, initialGivens, initialUrlState, tile
     autorun: dash.autorun
   };
   return html(
-    navHtml2(dash, all) + `<div id="root"></div><script>window.__DASHBOARD__=${safeJson(info)};window.__GIVENS__=${safeJson(givenSpecs)};window.__INITIAL_GIVENS__=${safeJson(initialGivens)};window.__INITIAL_URLSTATE__=${safeJson(initialUrlState)}</script><script>try{new EventSource('/events').onmessage=()=>location.reload();}catch(e){}</script><script src="/inpage.js?d=${encodeURIComponent(dash.name)}"></script>`,
+    navHtml2(dash, all) + `<div id="root"></div><script>window.__DASHBOARD__=${safeJson(info)};window.__DASHBOARDS__=${safeJson(devSiblings(dash, all))};window.__GIVENS__=${safeJson(givenSpecs)};window.__INITIAL_GIVENS__=${safeJson(initialGivens)};window.__INITIAL_URLSTATE__=${safeJson(initialUrlState)}</script><script>try{new EventSource('/events').onmessage=()=>location.reload();}catch(e){}</script><script src="/inpage.js?d=${encodeURIComponent(dash.name)}"></script>`,
     dash.title
   );
 }
@@ -3413,7 +3488,7 @@ function givensFromUrl(url6) {
 function urlStateFromUrl(url6) {
   return urlStateFromSearch(url6.search);
 }
-function frameDoc(dash, givenSpecs, initialGivens, initialUrlState, tileSpecs) {
+function frameDoc(dash, all, givenSpecs, initialGivens, initialUrlState, tileSpecs) {
   const info = {
     name: dash.name,
     query: dash.query,
@@ -3428,7 +3503,7 @@ function frameDoc(dash, givenSpecs, initialGivens, initialUrlState, tileSpecs) {
     autorun: dash.autorun
   };
   return html(
-    `<div id="root"></div><script>window.__DASHBOARD__=${safeJson(info)};window.__GIVENS__=${safeJson(givenSpecs)};window.__INITIAL_GIVENS__=${safeJson(initialGivens)};window.__INITIAL_URLSTATE__=${safeJson(initialUrlState)}</script><script src="/bundle.js?d=${encodeURIComponent(dash.name)}"></script>`,
+    `<div id="root"></div><script>window.__DASHBOARD__=${safeJson(info)};window.__DASHBOARDS__=${safeJson(devSiblings(dash, all))};window.__GIVENS__=${safeJson(givenSpecs)};window.__INITIAL_GIVENS__=${safeJson(initialGivens)};window.__INITIAL_URLSTATE__=${safeJson(initialUrlState)}</script><script src="/bundle.js?d=${encodeURIComponent(dash.name)}"></script>`,
     dash.title
   );
 }
@@ -3458,6 +3533,7 @@ async function serveDashboard(opts) {
   const inPageBundle = makeInPageBundler();
   const pick = (url6) => byName.get(url6.searchParams.get("d") ?? dashboards[0].name) ?? dashboards[0];
   async function resolveGivens(dash) {
+    if (rendersNoData(dash)) return { ok: true, union: [] };
     if (dash.tiles && dash.entryFile) {
       const t = await runner.dashboardTiles(dash.entryFile, dash.tiles);
       return { ok: true, union: t.union, tiles: t.tiles };
@@ -3510,7 +3586,7 @@ async function serveDashboard(opts) {
           return send(
             200,
             "text/html; charset=utf-8",
-            frameDoc(dash, g.union, givensFromUrl(url6), urlStateFromUrl(url6), g.tiles)
+            frameDoc(dash, dashboards, g.union, givensFromUrl(url6), urlStateFromUrl(url6), g.tiles)
           );
         }
         if (url6.pathname === "/bundle.js") {
@@ -3795,11 +3871,12 @@ window.__GIVENS__ = ${safeJson(givenSpecs)};
 }
 function indexPage(dashboards, title, custom, cleanUrls, analytics) {
   const link = (n) => cleanUrls ? `./${encodeURIComponent(n)}` : `./${encodeURIComponent(n)}.html`;
+  const listed = dashboards.filter((d) => !rendersNoData(d));
   const body = custom ? `<div id="root"></div>
 <script>window.__DASHBOARDS__ = ${safeJson(
-    dashboards.map((d) => ({ name: d.name, title: d.title, description: d.description, href: link(d.name) }))
+    listed.map((d) => ({ name: d.name, title: d.title, description: d.description, href: link(d.name) }))
   )};</script>
-<script type="module" src="./assets/index.js"></script>` : `<main class="index"><h1>${esc3(title)}</h1><ul>` + dashboards.map(
+<script type="module" src="./assets/index.js"></script>` : `<main class="index"><h1>${esc3(title)}</h1><ul>` + listed.map(
     (d) => `<li><a href="${link(d.name)}"><strong>${esc3(d.title || d.name)}</strong>` + (d.description ? `<span>${esc3(d.description)}</span>` : "") + `</a></li>`
   ).join("") + `</ul></main>`;
   return `<!doctype html>
@@ -3960,6 +4037,7 @@ boot(Dashboard);
   });
   fs7.writeFileSync(path8.join(outDir, "assets", "site.css"), SITE_CSS);
   for (const d of dashboards) {
+    if (rendersNoData(d)) continue;
     let specs = [];
     let tileSpecs;
     if (d.tiles && d.entryFile) {

package/dist/shared/nav.ts

@@ -70,3 +70,25 @@ export function navHtml(
     .join("");
   return `<nav class="dash-nav">${brand}<span class="sep"></span>${links}</nav>`;
 }
+
+/** The sibling list a host injects as `window.__DASHBOARDS__`, in nav order and
+    excluding the current page.
+ *
+ * Same shape and same link-shape callback as `navHtml`, because it answers the
+ * same question in component form: an About page (or any dashboard) that wants
+ * to link to the others gets `props.dashboards` and never has to know whether it
+ * is running under the dev server, the hosted frame, or a static bundle. */
+export function siblingList<T extends NavDashboard & { description?: string }>(
+  current: string,
+  all: readonly T[],
+  href: (name: string) => string,
+): Array<{ name: string; title: string; description?: string; href: string }> {
+  return all
+    .filter((d) => d.name !== current)
+    .map((d) => ({
+      name: d.name,
+      title: d.title || d.name,
+      ...(d.description ? { description: d.description } : {}),
+      href: href(d.name),
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@malloydata/malloyyo",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "description": "Publish Malloy models to a Malloyyo instance",
   "license": "MIT",
   "repository": {