@malloy-publisher/server 0.9.1 → 0.9.2

package/dist/package_load_worker.mjs

@@ -13195,7 +13195,7 @@ function toQueryTextProblem(problem) {
     ...problem.at ? { at: { range: problem.at.range } } : {}
   };
 }
-var GENERIC_INTERNAL_MESSAGE = "Internal server error.", GENERIC_UPSTREAM_MESSAGE = "Upstream connection error.", MAX_LOGGED_DETAIL_CHARS = 2000, FILESYSTEM_ACCESS_DESCRIPTIONS, NotImplementedError, BadRequestError, InvalidArgumentError, CompileRefusedError, EnvironmentNotFoundError, PackageNotFoundError, ModelNotFoundError, DashboardNotFoundError, ConnectionNotFoundError, TableNotFoundError, ConnectionError, DestinationNotFoundError, ConnectionAuthError, UnsupportedCatalogFormatError, ModelCompilationError, PackageManifestError, MaterializationEligibilityError, PublisherConfigError, ServerConfigurationError, FrozenConfigError, AccessDeniedError, QueryCompileError, NotQueryableError, OffSurfaceError, MaterializationNotFoundError, MaterializationConflictError, WriteConflictError, WriteRolledBackError, InvalidStateTransitionError, ServiceUnavailableError, PayloadTooLargeError, ResponseUnserializableError, QueryTimeoutError;
+var GENERIC_INTERNAL_MESSAGE = "Internal server error.", GENERIC_UPSTREAM_MESSAGE = "Upstream connection error.", MAX_LOGGED_DETAIL_CHARS = 2000, FILESYSTEM_ACCESS_DESCRIPTIONS, NotImplementedError, BadRequestError, InvalidArgumentError, CompileRefusedError, EnvironmentNotFoundError, PackageNotFoundError, ModelNotFoundError, DashboardNotFoundError, ConnectionNotFoundError, TableNotFoundError, ConnectionError, DestinationNotFoundError, ConnectionAuthError, UnsupportedCatalogFormatError, ModelCompilationError, PackageManifestError, MaterializationEligibilityError, PublisherConfigError, ServerConfigurationError, FrozenConfigError, AccessDeniedError, QueryCompileError, NotQueryableError, OffSurfaceError, MaterializationNotFoundError, MaterializationConflictError, WriteConflictError, WriteRolledBackError, WriteVerifyError, InvalidStateTransitionError, ServiceUnavailableError, PayloadTooLargeError, ResponseUnserializableError, QueryTimeoutError;
 var init_errors = __esm(() => {
   init_constants();
   init_logger();
@@ -13348,11 +13348,17 @@ var init_errors = __esm(() => {
     }
   };
   WriteRolledBackError = class WriteRolledBackError extends Error {
-    constructor(message) {
-      super(message);
+    constructor(message, options) {
+      super(message, options);
       this.name = "WriteRolledBackError";
     }
   };
+  WriteVerifyError = class WriteVerifyError extends Error {
+    constructor(message, options) {
+      super(message, options);
+      this.name = "WriteVerifyError";
+    }
+  };
   InvalidStateTransitionError = class InvalidStateTransitionError extends Error {
     constructor(message) {
       super(message);
@@ -13407,6 +13413,7 @@ var init_authorize_routes = __esm(() => {
 
 // src/service/authorize.ts
 import { payloadOf, routeOf } from "@malloydata/malloy";
+import { createRequire as createRequire2 } from "module";
 function noteRoute(text) {
   return routeOf({ value: text.trimStart() });
 }
@@ -13455,7 +13462,7 @@ function motlyAuthorizePayloadPattern(route) {
   return new RegExp(`^[ \\t]*[([{<][ \\t]*(?:${nearMissWordAlternation(route)})[ \\t]*[)\\]}>]`, "iu");
 }
 function malformedAuthorizeAttemptPattern(route) {
-  return new RegExp(`^##?\\|?[ \\t]*[([{<]?[ \\t]*(?:${nearMissWordAlternation(route)})`, "iu");
+  return new RegExp(`^##?\\|?[ \\t]*(?:[([{<][ \\t]*)?(?:${nearMissWordAlternation(route)})`, "iu");
 }
 function authorizeNoteContent(text) {
   const route = canonicalAuthorizeRoute(noteRoute(text));
@@ -13466,12 +13473,144 @@ function authorizeNoteContent(text) {
 function authorizeAnnotationRoute(text) {
   return authorizeNoteContent(text)?.route;
 }
-function hasCallerAuthorizeAnnotation(callerText) {
-  return AUTHORIZE_ANNOTATION_ANYWHERE.test(callerText);
+function loadMalloyParser() {
+  try {
+    const entry = createRequire2(import.meta.url).resolve("@malloydata/malloy");
+    const loaded = createRequire2(entry)("./lang/run-malloy-parser");
+    return typeof loaded.makeMalloyParser === "function" ? loaded.makeMalloyParser : null;
+  } catch {
+    return null;
+  }
+}
+function malloyParserFactory() {
+  if (makeMalloyParser === undefined)
+    makeMalloyParser = parserLoader();
+  return makeMalloyParser ?? undefined;
+}
+function lastCallerGuardRefusalKind() {
+  return lastRefusalKind;
+}
+function proseRanges(text) {
+  if (lastLexed.text !== text)
+    lastLexed = { text, prose: lexProseRanges(text) };
+  return lastLexed.prose;
+}
+function lexProseRanges(text) {
+  const factory = malloyParserFactory();
+  lexerMissing = !factory;
+  if (!factory) {
+    if (!warnedNoParser) {
+      warnedNoParser = true;
+      console.warn("Prose-aware caller-annotation guard disabled: @malloydata/malloy ./lang/run-malloy-parser could not be loaded; falling back to whole-text matching.");
+    }
+    return;
+  }
+  try {
+    const counter = () => ({
+      errors: 0,
+      syntaxError() {
+        this.errors++;
+      }
+    });
+    const lexerErrors = counter();
+    const parserErrors = counter();
+    const { tokenStream, parser } = factory(text, {
+      lexerErrorListener: lexerErrors,
+      parserErrorListener: parserErrors
+    });
+    parser.malloyDocument();
+    const vocabulary = tokenStream.tokenSource?.vocabulary;
+    if (lexerErrors.errors > 0 || parserErrors.errors > 0 || typeof vocabulary?.getSymbolicName !== "function")
+      return;
+    const utf16 = [];
+    for (let i = 0;i < text.length; ) {
+      utf16.push(i);
+      i += text.codePointAt(i) > 65535 ? 2 : 1;
+    }
+    utf16.push(text.length);
+    const rangeOf = (token) => {
+      const from = utf16[token.startIndex];
+      const to = utf16[token.stopIndex + 1];
+      return from === undefined || to === undefined || to < from ? undefined : [from, to];
+    };
+    const prose = [];
+    let block;
+    for (const token of tokenStream.getTokens()) {
+      const name = vocabulary.getSymbolicName(token.type);
+      const range = rangeOf(token);
+      if (name === "BLOCK_ANNOTATION_TEXT" || name === "BLOCK_ANNOTATION_END") {
+        if (!block || !range || token.startIndex !== block.next)
+          return;
+        if (name === "BLOCK_ANNOTATION_END") {
+          block = undefined;
+        } else {
+          if (block.prose)
+            prose.push(range);
+          block.next = token.stopIndex + 1;
+        }
+        continue;
+      }
+      if (block)
+        return;
+      if (name === "BLOCK_ANNOTATION_BEGIN" || name === "DOC_BLOCK_ANNOTATION_BEGIN") {
+        if (!range)
+          return;
+        block = {
+          prose: PROSE_ROUTES.has(noteRoute(text.slice(...range)) ?? ""),
+          next: token.stopIndex + 1
+        };
+      } else if (name === "ANNOTATION" || name === "DOC_ANNOTATION") {
+        if (!range)
+          return;
+        if (PROSE_ROUTES.has(noteRoute(text.slice(...range)) ?? ""))
+          prose.push([range[0] + 1, range[1]]);
+      }
+    }
+    return block ? undefined : prose;
+  } catch {
+    return;
+  }
+}
+function hasCallerAuthorizeAnnotation(callerText, precedingText = "") {
+  if (!AUTHORIZE_ANNOTATION_ANYWHERE.test(callerText))
+    return false;
+  const text = precedingText + callerText;
+  const bodies = proseRanges(text);
+  lastRefusalKind = bodies !== undefined ? "lexed" : lexerMissing ? "no_lexer" : "whole_text";
+  if (bodies === undefined)
+    return true;
+  const sticky = new RegExp(AUTHORIZE_TAG_LIKE, "iuy");
+  const callerStart = precedingText.length;
+  const from = text.lastIndexOf(`
+`, callerStart - 1) + 1;
+  let body = 0;
+  for (let at = text.indexOf("#", from);at !== -1; at = text.indexOf("#", at + 1)) {
+    sticky.lastIndex = at;
+    const hit = sticky.exec(text);
+    if (!hit)
+      continue;
+    const end = at + hit[0].length;
+    if (end <= callerStart)
+      continue;
+    while (body < bodies.length && bodies[body][1] <= at)
+      body++;
+    const [start, stop] = bodies[body] ?? [Infinity, -Infinity];
+    if (!(start <= at && end <= stop))
+      return true;
+  }
+  return false;
+}
+function assertNoCallerAuthorizeAnnotation(callerText, precedingText = "") {
+  if (hasCallerAuthorizeAnnotation(callerText, precedingText))
+    refuseCallerAuthorizeAnnotation();
 }
-function assertNoCallerAuthorizeAnnotation(callerText) {
+function assertNoAuthorizeTagLike(callerText) {
   if (!AUTHORIZE_ANNOTATION_ANYWHERE.test(callerText))
     return;
+  lastRefusalKind = "whole_text";
+  refuseCallerAuthorizeAnnotation();
+}
+function refuseCallerAuthorizeAnnotation() {
   throw new BadRequestError("An `authorize` annotation is not permitted in caller-submitted Malloy " + "text. Access gates are declared by the model author on the source; a " + "request cannot introduce, replace, or relax one. To validate a gate " + "you are authoring, save it to the package's model file and reload the " + "package — model load validates every `#(authorize)` annotation it " + "declares.");
 }
 function containsAuthorizeAnnotationTag(texts) {
@@ -13669,13 +13808,19 @@ ${rewrites}
 ` + `Test that the rewrite gates the same rows and check the row count ` + `matches what the string form served.`
   });
 }
-var AUTHORIZE_TAG_LIKE, AUTHORIZE_ANNOTATION_ANYWHERE, REGEXP_SPECIAL, GIVEN_REF_PATTERN, SINGLE_QUOTE_ESCAPE, DOUBLE_QUOTE_ESCAPE, STRING_LITERAL_PATTERN, everyMemberOf = () => (...members) => members, ROW_LEVEL_GATE_REJECTION_CAUSES, WHOLE_BODY_QUOTED_STRING, WHOLE_BODY_SINGLE_QUOTED_STRING;
+var AUTHORIZE_TAG_LIKE, AUTHORIZE_ANNOTATION_ANYWHERE, REGEXP_SPECIAL, PROSE_ROUTES, makeMalloyParser, parserLoader, warnedNoParser = false, lastLexed, lastRefusalKind = "lexed", lexerMissing = false, GIVEN_REF_PATTERN, SINGLE_QUOTE_ESCAPE, DOUBLE_QUOTE_ESCAPE, STRING_LITERAL_PATTERN, everyMemberOf = () => (...members) => members, ROW_LEVEL_GATE_REJECTION_CAUSES, WHOLE_BODY_QUOTED_STRING, WHOLE_BODY_SINGLE_QUOTED_STRING;
 var init_authorize = __esm(() => {
   init_errors();
   init_authorize_routes();
-  AUTHORIZE_TAG_LIKE = String.raw`##?\|?[ \t]*[([{<]?[ \t]*(?:(?:(?:row|source)[-_]?)?authorize|access[-_]?filter)(?=[)\]}>]|[ \t]|$)`;
+  AUTHORIZE_TAG_LIKE = String.raw`##?\|?[ \t]*(?:[([{<][ \t]*)?(?:(?:(?:row|source)[-_]?)?authorize|access[-_]?filter)(?=[)\]}>]|[ \t]|$)`;
   AUTHORIZE_ANNOTATION_ANYWHERE = new RegExp(AUTHORIZE_TAG_LIKE, "iu");
   REGEXP_SPECIAL = /[.*+?^${}()|[\]\\]/g;
+  PROSE_ROUTES = new Set(["markdown", "text"]);
+  parserLoader = loadMalloyParser;
+  lastLexed = {
+    text: "",
+    prose: []
+  };
   GIVEN_REF_PATTERN = /\$([A-Za-z_][A-Za-z0-9_]*)/g;
   SINGLE_QUOTE_ESCAPE = /\\(['\\])/g;
   DOUBLE_QUOTE_ESCAPE = /\\(["\\])/g;
@@ -13688,9 +13833,12 @@ var init_authorize = __esm(() => {
 // src/authorize_metrics.ts
 function recordAuthorizeGuardRejection(field) {
   guardRejectionCounter ??= publisherMeter().createCounter("publisher_authorize_guard_rejected_total", {
-    description: "Requests rejected with 400 for declaring an `#(authorize)` annotation in caller-submitted Malloy text. Label: field ('query'|'source_name'|'query_name'|'compile_source')."
+    description: "Requests rejected with 400 for declaring an `#(authorize)` annotation in caller-submitted Malloy text. Labels: field ('query'|'source_name'|'query_name'|'compile_source'), match ('lexed' when Malloy's lexer placed a tag outside prose, 'whole_text' when the text could not be lexed cleanly or is a name, 'no_lexer' when Malloy's parser failed to load so every prose-bearing text refuses)."
+  });
+  guardRejectionCounter.add(1, {
+    field,
+    match: lastCallerGuardRefusalKind()
   });
-  guardRejectionCounter.add(1, { field });
 }
 function recordAuthorizeBypass(entryPoint) {
   bypassCounter ??= publisherMeter().createCounter("publisher_authorize_bypass_total", {
@@ -14817,6 +14965,44 @@ var init_gate_classification = __esm(() => {
   init_gate_registry_walk();
 });
 
+// src/service/model_info.ts
+import { modelDefToModelInfo } from "@malloydata/malloy";
+function modelInfoOf(modelDef) {
+  try {
+    return modelDefToModelInfo(modelDef);
+  } catch (err) {
+    if (!isUnboundGiven(err) || !modelDef.givens)
+      throw err;
+    try {
+      return modelDefToModelInfo({
+        ...modelDef,
+        givens: withPlaceholderDefaults(modelDef.givens)
+      });
+    } catch {
+      throw err;
+    }
+  }
+}
+function isUnboundGiven(err) {
+  return err?.code === "compiler-given-no-value";
+}
+function withPlaceholderDefaults(givens) {
+  const out = {};
+  for (const [id, given] of Object.entries(givens)) {
+    if (given.default !== undefined) {
+      out[id] = given;
+      continue;
+    }
+    const isFilter = given.type.type === "filter expression";
+    out[id] = {
+      ...given,
+      default: isFilter ? { node: "filterLiteral", filterSrc: "" } : { node: "null" }
+    };
+  }
+  return out;
+}
+var init_model_info = () => {};
+
 // src/service/query_text.ts
 import { ParseUtil } from "@malloydata/malloy-tag";
 function extractRunTargetSourceName(query) {
@@ -15748,6 +15934,17 @@ function isNotebookModelPath(modelPath) {
   const segments = modelPath.split("/");
   return segments.length === 2 && segments[0] === NOTEBOOKS_DIR;
 }
+function isDocumentModelPath(modelPath) {
+  if (!modelPath.endsWith(MODEL_FILE_SUFFIX))
+    return false;
+  const segments = modelPath.split("/");
+  return segments.length === 2 && (segments[0] === NOTEBOOKS_DIR || segments[0] === DASHBOARDS_DIR);
+}
+function documentKind(modelPath, tagKind) {
+  if (tagKind === "notebook" || tagKind === "dashboard")
+    return tagKind;
+  return isNotebookModelPath(modelPath) ? "notebook" : "dashboard";
+}
 function routeOfNote(text) {
   return routeOf3({ value: text.trimStart() });
 }
@@ -15775,34 +15972,71 @@ function dashboardDescriptionNotes(notes) {
   return notes.filter((n) => line !== undefined && (n.at?.range.start.line ?? 0) > line).map((n) => n.text);
 }
 function hasArtifactLineOutsideBlocks(source, artifactLine) {
+  return findArtifactLineOutsideBlocks(source, artifactLine) !== undefined;
+}
+function blockCloserFinder(lines) {
+  const byKey = new Map;
+  lines.forEach((line, at) => {
+    const indent = /^[ \t]*/.exec(line)?.[0].length ?? 0;
+    for (const closer of ["|##", "|#"])
+      if (closesBlock(line, 0, indent, closer)) {
+        const key = `${indent}${closer}`;
+        const ats = byKey.get(key);
+        if (ats)
+          ats.push(at);
+        else
+          byKey.set(key, [at]);
+        break;
+      }
+  });
+  const cursor = new Map;
+  return (column, closer, after) => {
+    const key = `${column}${closer}`;
+    const ats = byKey.get(key) ?? [];
+    let k = cursor.get(key) ?? 0;
+    while (k < ats.length && ats[k] <= after)
+      k++;
+    cursor.set(key, k);
+    return ats[k] ?? -1;
+  };
+}
+function findArtifactLineOutsideBlocks(source, artifactLine) {
   const lines = source.split(/\r\n|\r|\n/);
+  const closerAfter = blockCloserFinder(lines);
   for (let i = 0;i < lines.length; i++) {
     const trimmed = lines[i].trimStart();
     const opener = /^(#{1,2})\|/.exec(trimmed);
     if (opener) {
-      const wanted = `|${opener[1]}`;
-      if (trimmed.includes(wanted, opener[0].length))
-        continue;
       const column = lines[i].length - trimmed.length;
-      let end = -1;
-      for (let at = i + 1;at < lines.length; at++)
-        if (closesBlock(lines[at], 0, column, wanted)) {
-          end = at;
-          break;
-        }
+      const end = closerAfter(column, `|${opener[1]}`, i);
       if (end !== -1) {
+        const block = [trimmed, ...lines.slice(i + 1, end)].join(`
+`);
+        if (artifactLine.test(block))
+          return block;
         i = end;
         continue;
       }
     }
     if (artifactLine.test(trimmed))
-      return true;
+      return trimmed;
   }
-  return false;
+  return;
+}
+function artifactKindOfNotes(notes) {
+  const tag = motlyTag(notes.map((note) => note.text).filter(isArtifactNoteText));
+  return tagText(tag?.tag("artifact"), "kind");
 }
 function claimsToBeANotebook(source) {
   return hasArtifactLineOutsideBlocks(source, ARTIFACT_NOTE);
 }
+function artifactTagText(source) {
+  return findArtifactLineOutsideBlocks(source, ARTIFACT_NOTE);
+}
+function artifactKindInText(source) {
+  const line = artifactTagText(source);
+  return line === undefined ? undefined : tagText(motlyTag([line])?.tag("artifact"), "kind");
+}
 function parseNotebookText(text) {
   try {
     const { problems, parse } = translateToParse(text);
@@ -16239,9 +16473,12 @@ function readMarkdownBlocks(parse, text) {
   return blocks;
 }
 function notebookReaderProblem(modelPath, text, modelDef, url) {
-  if (!isNotebookModelPath(modelPath))
+  if (!isDocumentModelPath(modelPath))
+    return;
+  const notes = ownModelNoteObjects(modelDef);
+  if (artifactNoteLine(notes) === undefined)
     return;
-  if (artifactNoteLine(ownModelNoteObjects(modelDef)) === undefined)
+  if (documentKind(modelPath, artifactKindOfNotes(notes)) !== "notebook")
     return;
   const parse = parseNotebookText(text);
   const error = isNotebookReaderError(parse) ? parse : readNotebookCells(parse, modelDef, text).error;
@@ -16261,7 +16498,7 @@ function notebookReaderProblem(modelPath, text, modelDef, url) {
     }
   };
 }
-var NOTEBOOKS_DIR = "notebooks", ARTIFACT_NOTE, MARKDOWN_ROUTE = "markdown", attachedNowhereFix = (block) => block ? "write it as a floating `##|(markdown)` block closed by `|##` for prose that stands on its own, or move it directly above the statement it describes." : "write it as a floating `##(markdown)` line for prose that stands on its own, or move it directly above the statement it describes.", isRuleNode = (node) => node !== undefined && node.ruleIndex !== undefined && (node.childCount ?? 0) > 0, callAccessor = (node, name) => {
+var NOTEBOOKS_DIR = "notebooks", DASHBOARDS_DIR = "dashboards", ARTIFACT_NOTE, ANY_ARTIFACT_NOTE, MARKDOWN_ROUTE = "markdown", attachedNowhereFix = (block) => block ? "write it as a floating `##|(markdown)` block closed by `|##` for prose that stands on its own, or move it directly above the statement it describes." : "write it as a floating `##(markdown)` line for prose that stands on its own, or move it directly above the statement it describes.", isRuleNode = (node) => node !== undefined && node.ruleIndex !== undefined && (node.childCount ?? 0) > 0, callAccessor = (node, name) => {
   const accessor = node[name];
   return typeof accessor === "function" ? accessor.call(node) : undefined;
 }, STATEMENT_ACCESSORS, NOTEBOOK_PARSE_URL = "file:///publisher-notebook-reader/notebook.malloy", NOTE_TOKENS, TEXT_BLOCK_NAME;
@@ -16270,7 +16507,62 @@ var init_notebook = __esm(() => {
   init_annotations();
   init_query_text();
   init_motly();
-  ARTIFACT_NOTE = /^##[ \t]*artifact\b/;
+  ARTIFACT_NOTE = {
+    test(note) {
+      const prefix = /^##\|?(?:[ \t\r\n]|$)/.exec(note);
+      if (!prefix)
+        return false;
+      const bare = /[0-9A-Za-z_\u00C0-\u024F\u1E00-\u1EFF]+/y;
+      let depth = 0;
+      let before = "";
+      for (let i = prefix[0].length;i < note.length; i++) {
+        const c = note[i];
+        if (/\s/.test(c))
+          continue;
+        if (note.startsWith("-...", i)) {
+          i += 3;
+          before = "";
+          continue;
+        }
+        bare.lastIndex = i;
+        const word = bare.exec(note)?.[0];
+        if (c === '"' || c === "'") {
+          const fence = note.startsWith(c.repeat(3), i) ? c.repeat(3) : c;
+          i += fence.length;
+          while (i < note.length && !note.startsWith(fence, i))
+            i += note[i] === "\\" ? 2 : 1;
+          i += fence.length - 1;
+        } else if (c === "`") {
+          let end = i + 1;
+          while (end < note.length && note[end] !== "`" && note[end] !== `
+`)
+            end += note[end] === "\\" ? 2 : 1;
+          const name = note.slice(i + 1, end);
+          if (depth === 0 && name === "artifact" && !/[=.-]/.test(before))
+            return true;
+          i = end;
+        } else if (c === "#") {
+          const eol = note.indexOf(`
+`, i);
+          if (eol < 0)
+            return false;
+          i = eol;
+          continue;
+        } else if (c === "{" || c === "[")
+          depth++;
+        else if (c === "}" || c === "]")
+          depth--;
+        else if (word) {
+          if (depth === 0 && word === "artifact" && !/[=.-]/.test(before))
+            return true;
+          i += word.length - 1;
+        }
+        before = c;
+      }
+      return false;
+    }
+  };
+  ANY_ARTIFACT_NOTE = /^#{1,2}\|?(?=[ \t\r\n])(?:[^"'\\]|\\.|"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')*?(?<![\w\u00C0-\u024F\u1E00-\u1EFF.$-])artifact(?![\w\u00C0-\u024F\u1E00-\u1EFF])/;
   STATEMENT_ACCESSORS = [
     ["runStatement", "run"],
     ["docAnnotations", "notes"],
@@ -23088,9 +23380,12 @@ var init_given = __esm(() => {
 });
 
 // src/service/dashboard.ts
-import { isSourceDef as isSourceDef5 } from "@malloydata/malloy";
+import { isJoined as isJoined3, isSourceDef as isSourceDef5 } from "@malloydata/malloy";
+function queryTiles(tiles) {
+  return (tiles ?? []).filter((tile) => tile.kind === "query");
+}
 function filterPublisherOwnedRenderLogs(logs, modelPath) {
-  const couldBeATile = isDashboardModelPath(modelPath);
+  const couldBeATile = isDocumentModelPath(modelPath);
   return logs.filter((log) => {
     const match = UNKNOWN_RENDER_TAG.exec(log.message ?? "");
     if (!match)
@@ -23115,6 +23410,24 @@ function dashboardSlug(modelPath) {
 function matchesDocumentedDashboardName(slug) {
   return /^[a-zA-Z0-9_-]+$/.test(slug);
 }
+function readTileEntries(artifact) {
+  return artifact.array("tiles")?.flatMap((entry) => {
+    const text = tagText(entry);
+    if (text === undefined)
+      return [];
+    if (tagText(entry, "kind") !== "text")
+      return [{ kind: "query", expression: text }];
+    const colspan = positiveInteger(tagNumeric(entry, "colspan"));
+    return [
+      {
+        kind: "text",
+        name: text,
+        ...colspan !== undefined && { colspan },
+        ...entry.has("break") && { break: true }
+      }
+    ];
+  });
+}
 function readArtifactTag(tag, declaredType) {
   const artifact = tag.tag("artifact");
   if (!artifact)
@@ -23123,12 +23436,25 @@ function readArtifactTag(tag, declaredType) {
   const autorun = readAutorun(artifact);
   return {
     title: tagText(artifact, "title"),
-    tiles: artifact.array("tiles")?.filter((tile) => tagText(tile, "kind") !== "text").map((tile) => tagText(tile)).filter((tile) => tile !== undefined),
+    kind: tagText(artifact, "kind"),
+    tiles: readTileEntries(artifact),
     dashboardColumns: tag.tag("dashboard")?.has("columns") ? positiveInteger(tagNumeric(tag.tag("dashboard"), "columns")) : artifact.array("tiles") ? positiveInteger(tagNumeric(artifact, "dashboard_columns")) : undefined,
     givens,
     autorun
   };
 }
+function readTextBlocks(notes) {
+  return notes.flatMap((note) => {
+    const newline = note.indexOf(`
+`);
+    const opener = parseMarkdownOpener(newline === -1 ? note : note.slice(0, newline));
+    if (opener?.level !== 2 || !opener.name)
+      return [];
+    const body = newline === -1 ? "" : note.slice(newline + 1);
+    return [{ name: opener.name, body: body.replace(/\r\n?/g, `
+`) }];
+  });
+}
 function positiveInteger(value) {
   return value !== undefined && Number.isInteger(value) && value >= 1 ? value : undefined;
 }
@@ -23176,6 +23502,11 @@ function readDashboardModelFacts(modelPath, modelDef, surfacedGivenNames, gatesB
     for (const field of obj.fields) {
       const fieldName = field.as || field.name;
       fieldNames.add(fieldName);
+      if (isJoined3(field)) {
+        for (const joined of field.fields) {
+          fieldNames.add(`${fieldName}.${joined.as || joined.name}`);
+        }
+      }
       if (field.type === "turtle") {
         const refs = new Set(sourceGivens);
         collectGivenRefs(field.pipeline, refs);
@@ -23246,7 +23577,11 @@ function tagTextArray(tag, ...path) {
   return items?.map((item) => tagText(item)).filter(isString);
 }
 function resolveTileGivens(tile, facts) {
-  return referencedTileGivens(tile, facts)?.filter((name) => facts.givens.has(name));
+  const reads = referencedTileGivens(tile, facts);
+  if (reads === undefined)
+    return;
+  const gateReads = facts.compiledTileGivens?.get(normalizeTileExpression(tile))?.gateReads ?? [];
+  return Array.from(new Set([...reads, ...gateReads])).filter((name) => facts.givens.has(name));
 }
 function resolveTileLayout(tile, facts) {
   const annotations = tileAnnotations(tile, facts);
@@ -23258,7 +23593,15 @@ function tileAnnotations(tile, facts) {
 }
 function referencedTileGivens(tile, facts) {
   const normalized = normalizeTileExpression(tile);
-  return facts.viewGivens.get(normalized) ?? facts.queries.find((query) => query.name === normalized)?.givens;
+  const statically = facts.viewGivens.get(normalized) ?? facts.queries.find((query) => query.name === normalized)?.givens;
+  const compiled = facts.compiledTileGivens?.get(normalized)?.reads;
+  if (!compiled)
+    return statically;
+  const rank = (name) => {
+    const at = statically?.indexOf(name) ?? -1;
+    return at === -1 ? Number.MAX_SAFE_INTEGER : at;
+  };
+  return [...compiled].sort((a, b) => rank(a) - rank(b));
 }
 function buildGivenSpecs(names, facts) {
   const declarations = facts.givens;
@@ -23300,26 +23643,41 @@ function buildDashboardManifest(facts) {
   const modelTag = motlyTag(facts.modelAnnotations);
   const declaredType = (name2) => facts.givens.get(name2)?.type;
   const composite = modelTag ? readArtifactTag(modelTag, declaredType) : undefined;
-  if (composite?.tiles?.length) {
-    const tiles = composite.tiles.map((query) => {
+  const kind = documentKind(facts.modelPath, composite?.kind);
+  if (composite?.tiles && (composite.tiles.length > 0 || kind === "notebook")) {
+    const blocks = readTextBlocks(facts.modelAnnotations);
+    const tiles = composite.tiles.map((entry) => {
+      if (entry.kind === "text") {
+        return {
+          kind: "text",
+          name: entry.name,
+          markdown: blocks.find((block) => block.name === entry.name)?.body ?? "",
+          ...entry.colspan !== undefined && { colspan: entry.colspan },
+          ...entry.break && { break: true }
+        };
+      }
+      const query = entry.expression;
       const givenNames = resolveTileGivens(query, facts);
       const layout = resolveTileLayout(query, facts);
       return {
+        kind: "query",
         query,
         ...givenNames ? { givenNames } : {},
         ...layout
       };
     });
+    const queries = queryTiles(tiles);
     const doc = docCommentTitleAndDescription(facts.descriptionNotes ?? facts.modelAnnotations, composite.title);
     return {
       ...base,
+      kind,
       title: doc.title ?? name,
       description: doc.description,
       tiles,
-      dashboardColumns: composite.dashboardColumns,
+      dashboardColumns: kind === "notebook" ? 1 : composite.dashboardColumns,
       startingGivens: composite.givens,
       autorun: composite.autorun,
-      givens: buildGivenSpecs(tiles.some((tile) => tile.givenNames === undefined) ? Array.from(facts.givens.keys()) : tiles.flatMap((tile) => tile.givenNames ?? []), facts)
+      givens: buildGivenSpecs(queries.some((tile) => tile.givenNames === undefined) ? Array.from(facts.givens.keys()) : queries.flatMap((tile) => (referencedTileGivens(tile.query, facts) ?? []).filter((name2) => facts.givens.has(name2))), facts)
     };
   }
   for (const query of facts.queries) {
@@ -23330,6 +23688,7 @@ function buildDashboardManifest(facts) {
     const doc = docCommentTitleAndDescription(query.annotations, artifact.title);
     return {
       ...base,
+      kind: "dashboard",
       title: doc.title ?? name,
       description: doc.description,
       query: query.name,
@@ -23371,19 +23730,33 @@ function lintDashboard(facts, manifest) {
       continue;
     add(`\`${property}\` in the artifact tag does nothing in Publisher` + (ARTIFACT_PROPERTY_REPLACEMENTS[property] ? `. ${ARTIFACT_PROPERTY_REPLACEMENTS[property]}` : property === "tiles" ? `: a dashboard whose tag sits on a query is that one query's ` + `result. Move the tag to model level (\`## artifact\`) to ` + `combine separate queries into a grid.` : `.`));
   }
+  const textBlocks = readTextBlocks(facts.modelAnnotations);
   for (const entry of artifactTag?.array("tiles") ?? []) {
     const kind = tagText(entry, "kind");
-    if (kind === "text") {
-      add(`\`${tagText(entry) ?? "a tile"}\` in \`tiles=[…]\` is a text tile, ` + `but Publisher does not render text tiles yet, so it is left out ` + `of the page.`);
+    const label = tagText(entry) ?? "a tile";
+    const read = kind === "text" ? ["kind", "colspan", "break"] : [];
+    const carried = Object.keys(entry.dict ?? {}).filter((property) => !read.includes(property) && !(property === "kind" && kind === "query"));
+    if (carried.length > 0) {
+      const named = carried.map((property) => `\`${property}\``).join(", ");
+      add(kind === "text" ? `\`${label}\` in \`tiles=[…]\` carries ${named}, which Publisher does not read: a text tile's entry reads only \`colspan\` and \`break\`.` : `\`${label}\` in \`tiles=[…]\` carries ${named}, ` + `which Publisher does not read: a tile entry is the run expression ` + `alone. Per-tile presentation goes on the view the tile names ` + `(\`# colspan\`, \`# break\`, \`# label\`, \`# subtitle\`, ` + `\`# borderless\`).`);
+    }
+    if (kind !== "text")
       continue;
+    if (!textBlocks.some((block) => block.name === label)) {
+      add(`text tile \`${label}\` has no \`##|(markdown) ${label}\` block, so it shows nothing. ` + `Fix: write that block, with the text on the lines below its opener and \`|##\` after.`);
+    }
+    if (entry.has("colspan") && positiveInteger(tagNumeric(entry, "colspan")) === undefined) {
+      add(`colspan on text tile \`${label}\` must be a positive integer. The tile spans one column.`);
     }
-    const carried = Object.keys(entry.dict ?? {}).filter((property) => !(property === "kind" && kind === "query"));
-    if (carried.length === 0)
-      continue;
-    const named = carried.map((property) => `\`${property}\``).join(", ");
-    add(`\`${tagText(entry) ?? "a tile"}\` in \`tiles=[…]\` carries ${named}, ` + `which Publisher does not read: a tile entry is the run expression ` + `alone. Per-tile presentation goes on the view the tile names ` + `(\`# colspan\`, \`# break\`, \`# label\`, \`# subtitle\`, ` + `\`# borderless\`).`);
   }
-  for (const { query: tile } of manifest.tiles ?? []) {
+  const seenBlocks = new Set;
+  for (const { name } of textBlocks) {
+    if (seenBlocks.has(name)) {
+      add(`the \`##|(markdown) ${name}\` block is written twice, and only the first is shown. Fix: rename or delete the second.`);
+    }
+    seenBlocks.add(name);
+  }
+  for (const { query: tile } of manifest.kind === "notebook" ? [] : queryTiles(manifest.tiles)) {
     const tag = motlyTag(tileAnnotations(tile, facts) ?? []);
     if (!tag?.has("colspan"))
       continue;
@@ -23402,21 +23775,28 @@ function lintDashboard(facts, manifest) {
   }
   const columnsTag = ownTag?.tag("dashboard");
   if (columnsTag?.has("columns")) {
-    if (positiveInteger(tagNumeric(columnsTag, "columns")) === undefined) {
+    const width = positiveInteger(tagNumeric(columnsTag, "columns"));
+    if (width === undefined) {
       const raw = tagText(columnsTag, "columns");
       add(`# dashboard { columns=… } must be a positive integer, got ` + `${raw === undefined ? "a value that could not be read" : JSON.stringify(raw)}. ` + `The grid falls back to the default.`);
+    } else if (width > MAX_BUILDER_COLUMNS) {
+      add(`# dashboard { columns=${width} } is wider than the builder offers (${MAX_BUILDER_COLUMNS}); the reader still renders it.`);
     }
   }
-  for (const { query: tile } of manifest.tiles ?? []) {
+  for (const { query: tile } of queryTiles(manifest.tiles)) {
     const parts = plainTileParts(tile);
     if (!parts)
       continue;
     const resolved = referencedTileGivens(tile, facts) !== undefined || "name" in parts && facts.queries.some((query) => query.name === parts.name);
+    if (!resolved && "name" in parts && textBlocks.some((block) => block.name === parts.name)) {
+      add(`tile "${tile}" names the ##|(markdown) ${tile} block but has no kind=text, so it is read as a query. Fix: write ${tile} { kind=text }`, "error");
+      continue;
+    }
     if (!resolved) {
       const detail = "source" in parts ? facts.sourceFields.has(parts.source) ? `source "${parts.source}" has no view "${parts.view}"` : `no source "${parts.source}" in this file` : `no query named "${parts.name}" in this file`;
       add(`tile "${tile}" does not resolve: ${detail}.`, "error");
     }
-    const unbindable = (referencedTileGivens(tile, facts) ?? []).filter((name) => !facts.givens.has(name));
+    const unbindable = Array.from(new Set(referencedTileGivens(tile, facts) ?? [])).filter((name) => !facts.givens.has(name));
     for (const name of unbindable) {
       add(`tile "${tile}" filters by given "${name}", which this file does ` + `not import, so no control is shown for it and it stays at its ` + `default. Add it to an import in ${facts.modelPath}.`);
     }
@@ -23579,7 +23959,7 @@ function lintSelfDrills(facts) {
   }
   return Array.from(findings.values());
 }
-var DASHBOARDS_DIR = "dashboards", COMPONENT_FILE_SUFFIXES, MODEL_FILE_SUFFIX2 = ".malloy", PUBLISHER_OWNED_TAGS, RENDERER_CHILD_TAGS, UNKNOWN_RENDER_TAG, COMPOSITE_ARTIFACT_PROPERTIES, QUERY_ARTIFACT_PROPERTIES, ARTIFACT_PROPERTY_REPLACEMENTS, NAME_THE_TILES = `Name the views to show: tiles=["source -> view", …].`;
+var MAX_BUILDER_COLUMNS = 24, COMPONENT_FILE_SUFFIXES, MODEL_FILE_SUFFIX2 = ".malloy", PUBLISHER_OWNED_TAGS, RENDERER_CHILD_TAGS, UNKNOWN_RENDER_TAG, COMPOSITE_ARTIFACT_PROPERTIES, QUERY_ARTIFACT_PROPERTIES, ARTIFACT_PROPERTY_REPLACEMENTS, NAME_THE_TILES = `Name the views to show: tiles=["source -> view", …].`;
 var init_dashboard = __esm(() => {
   init_annotations();
   init_notebook();
@@ -23800,9 +24180,8 @@ var init_filter = __esm(() => {
 
 // src/service/source_extraction.ts
 import {
-  isJoined as isJoined3,
-  isSourceDef as isSourceDef6,
-  modelDefToModelInfo
+  isJoined as isJoined4,
+  isSourceDef as isSourceDef6
 } from "@malloydata/malloy";
 function joinFieldNamesUnresolvableDeclaration(field, modelDef) {
   const ids = [field.referenceID, field.sourceID].filter((id) => !!id);
@@ -23833,7 +24212,7 @@ function considerNoteOwner(declaredBy, note, candidate) {
 function collectSourceInfos(modelDef) {
   const names = Object.keys(modelDef.contents).filter((name) => isSourceDef6(modelDef.contents[name]));
   const exports = [...new Set([...modelDef.exports, ...names])];
-  return modelDefToModelInfo({ ...modelDef, exports }).entries.filter((entry) => entry.kind === "source");
+  return modelInfoOf({ ...modelDef, exports }).entries.filter((entry) => entry.kind === "source");
 }
 function extractSourcesFromModelDef(modelDef, givens, onParseError) {
   const filterMap = new Map;
@@ -23971,7 +24350,7 @@ function extractSourcesFromModelDef(modelDef, givens, onParseError) {
         continue;
       }
       const fieldName = field.as || field.name;
-      if (isJoined3(field) && isSourceDef6(field)) {
+      if (isJoined4(field) && isSourceDef6(field)) {
         const joinedStruct = field;
         if (joinFieldNamesUnresolvableDeclaration(joinedStruct, modelDef)) {
           continue;
@@ -24029,6 +24408,7 @@ var init_source_extraction = __esm(() => {
   init_annotations();
   init_authorize();
   init_authorize_routes();
+  init_model_info();
   init_filter();
   init_gate_registry_walk();
 });
@@ -24065,12 +24445,12 @@ init_error_wire();
 init_authorize();
 init_gate_classification();
 init_gate_dimension();
+init_model_info();
 var import_recursive_readdir = __toESM(require_recursive_readdir(), 1);
 import {
   contextOverlay,
   isSourceDef as isSourceDef7,
   MalloyConfig,
-  modelDefToModelInfo as modelDefToModelInfo2,
   Runtime
 } from "@malloydata/malloy";
 import {
@@ -24655,7 +25035,7 @@ async function compileMalloyModel(job, malloyConfig, modelPath) {
     modelPath,
     modelType: "model",
     modelDef,
-    modelInfo: modelDefToModelInfo2(modelDef),
+    modelInfo: modelInfoOf(modelDef),
     sourceInfos,
     sources,
     queries,
@@ -24699,7 +25079,7 @@ async function compileNotebookModel(job, malloyConfig, modelPath) {
       continue;
     }
     const currentModelDef = (await localMM.getModel())._modelDef;
-    const currentInfo = modelDefToModelInfo2(currentModelDef);
+    const currentInfo = modelInfoOf(currentModelDef);
     const newSources = collectSourceInfos(currentModelDef).filter((s) => !(s.name in oldSources));
     for (const s of newSources)
       oldSources[s.name] = s;
@@ -24781,7 +25161,7 @@ async function compileNotebookModel(job, malloyConfig, modelPath) {
     modelPath,
     modelType: "notebook",
     modelDef: finalModelDef,
-    modelInfo: finalModelDef ? modelDefToModelInfo2(finalModelDef) : undefined,
+    modelInfo: finalModelDef ? modelInfoOf(finalModelDef) : undefined,
     sourceInfos: finalSourceInfos,
     sources: finalSources,
     queries: finalQueries,