@attentionform/astra 0.3.0 → 0.4.1

package/dist/cli.js

@@ -5662,6 +5662,23 @@ function writeCorePropertiesPart(adapter, xml) {
   } catch {
   }
 }
+function registerExistingCorePropertiesPart(adapter) {
+  let present = false;
+  try {
+    present = adapter.readTextOrNull(CORE_PROPERTIES_PART) !== null;
+  } catch {
+    return;
+  }
+  if (!present) return;
+  try {
+    ensureContentTypeOverride(adapter);
+  } catch {
+  }
+  try {
+    ensurePackageRel(adapter);
+  } catch {
+  }
+}
 function patchToMetadata(patch) {
   const out = {};
   if (patch.title !== void 0) out.title = patch.title;
@@ -9907,6 +9924,41 @@ function hasLiveNumberingForSync(ast) {
   }
 }
 
+// ../engine/src/ooxml/quote-style.ts
+var QUOTE_STYLE_ID = "Quote";
+var QUOTE_INDENT_TWIPS = 720;
+var QUOTE_STYLE_BODY = `<w:style w:type="paragraph" w:styleId="Quote">
+    <w:name w:val="Quote"/>
+    <w:basedOn w:val="Normal"/>
+    <w:next w:val="Normal"/>
+    <w:uiPriority w:val="29"/>
+    <w:qFormat/>
+    <w:pPr>
+      <w:pBdr>
+        <w:left w:val="single" w:sz="18" w:space="10" w:color="94A3B8"/>
+      </w:pBdr>
+      <w:spacing w:before="120" w:after="120"/>
+      <w:ind w:left="${QUOTE_INDENT_TWIPS}"/>
+    </w:pPr>
+    <w:rPr>
+      <w:i/>
+      <w:color w:val="475569"/>
+    </w:rPr>
+  </w:style>`;
+var QUOTE_STYLE_XML = QUOTE_STYLE_BODY.replace("<w:style ", '<w:style xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" ');
+function ensureQuoteStyle(stylesDom) {
+  if (!stylesDom) return false;
+  const root = stylesDom.getElementsByTagName("w:styles")[0];
+  if (!root) return false;
+  for (const style of Array.from(stylesDom.getElementsByTagName("w:style"))) {
+    if (style.getAttribute("w:styleId") === QUOTE_STYLE_ID) return false;
+  }
+  const fragment = new DOMParser().parseFromString(QUOTE_STYLE_XML, "text/xml").documentElement;
+  if (!fragment) return false;
+  root.appendChild(stylesDom.importNode(fragment, true));
+  return true;
+}
+
 // ../engine/src/parser.ts
 function hasAncestorTag(el, tag) {
   for (let n = el.parentNode; n; n = n.parentNode) {
@@ -10574,6 +10626,7 @@ var DocxParser = class _DocxParser {
     } else {
       this.stylesDom = null;
     }
+    registerExistingCorePropertiesPart(this.getZipAdapter());
     this.invalidateMediaCache();
     this.assignStableIds();
     this._bumpNodePagesRevision();
@@ -11139,6 +11192,27 @@ var DocxParser = class _DocxParser {
     return tracked;
   }
   // --- AST layer: stable id assignment ---
+  /** Orders AST blocks by where their element sits in the body; blocks inside one body child keep their order. */
+  sortBlocksInDocumentOrder(nodes) {
+    const body = this.documentDom.getElementsByTagName("w:body")[0];
+    if (!body || nodes.length < 2) return;
+    const topIndex = /* @__PURE__ */ new Map();
+    let position2 = 0;
+    for (let child = body.firstChild; child; child = child.nextSibling) {
+      if (child.nodeType === 1) topIndex.set(child, position2++);
+    }
+    const keyOf = (element) => {
+      let current = element;
+      while (current && current.parentNode !== body) current = current.parentNode;
+      return current ? topIndex.get(current) ?? Number.MAX_SAFE_INTEGER : Number.MAX_SAFE_INTEGER;
+    };
+    const keyed = nodes.map((node, index) => ({ node, index, key: keyOf(node.xml) }));
+    if (keyed.every((entry, i) => i === 0 || keyed[i - 1].key <= entry.key)) return;
+    keyed.sort((a, b) => a.key - b.key || a.index - b.index);
+    keyed.forEach((entry, i) => {
+      nodes[i] = entry.node;
+    });
+  }
   async getAST() {
     const ast = {
       metadata: {},
@@ -11516,6 +11590,7 @@ var DocxParser = class _DocxParser {
       ast.sectPrFlags = { titlePg: false, evenAndOddHeaders: false };
     }
     ast.nextChangeId = firstFreeRevisionId(this.maxPackageRevisionId());
+    this.sortBlocksInDocumentOrder(rootNodes);
     ast.sections.push(...splitIntoSections(rootNodes, fileSections));
     const prevNumberingAst = this.lastAstForNumbering;
     if (prevNumberingAst && prevNumberingAst !== ast) {
@@ -13290,6 +13365,7 @@ ${validation.errors.join("\n")}`, "repair the part XML or re-save the document i
       <w:spacing w:before="120" w:after="120" w:line="240" w:lineRule="auto"/>
     </w:pPr>
   </w:style>
+  ${QUOTE_STYLE_BODY}
   <w:style w:type="character" w:styleId="Code">
     <w:name w:val="Code"/>
     <w:rPr>
@@ -13672,15 +13748,26 @@ var import_isomorphic_git = __toESM(require("isomorphic-git"));
 var import_fs3 = __toESM(require("fs"));
 var import_promises = __toESM(require("fs/promises"));
 var import_path2 = __toESM(require("path"));
+function hasUriScheme(ref) {
+  if (/^[a-zA-Z]:[\\/]/.test(ref)) return false;
+  return /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(ref);
+}
+function withoutTrailingSeparator(p, normalized) {
+  const root = p.parse(normalized).root;
+  let out = normalized;
+  while (out.length > root.length && out.endsWith(p.sep)) out = out.slice(0, -1);
+  return out;
+}
 function isPathInsideDir(candidate, dir, platform = process.platform) {
-  const normC = import_path2.default.normalize(candidate);
-  const normD = import_path2.default.normalize(dir);
+  const p = platform === "win32" ? import_path2.default.win32 : import_path2.default.posix;
+  let c = withoutTrailingSeparator(p, p.normalize(candidate));
+  let d = withoutTrailingSeparator(p, p.normalize(dir));
   if (platform === "win32") {
-    const lc = normC.toLowerCase();
-    const ld = normD.toLowerCase();
-    return lc === ld || lc.startsWith(ld + import_path2.default.sep.toLowerCase());
+    c = c.toLowerCase();
+    d = d.toLowerCase();
   }
-  return normC === normD || normC.startsWith(normD + import_path2.default.sep);
+  if (c === d) return true;
+  return c.startsWith(d.endsWith(p.sep) ? d : d + p.sep);
 }
 function canonicalizeForAsset(resolved) {
   try {
@@ -14928,6 +15015,19 @@ function warnIfLowContrast(warnings, seen, fill, textColor, where) {
     warnings.push(msg);
   }
 }
+function autoTextForFill(fill, current) {
+  if (!/^[0-9A-Fa-f]{6}$/.test(fill)) return void 0;
+  if (contrastRatio((current ?? "000000").toUpperCase(), fill.toUpperCase()) >= TABLE_CONTRAST_MIN_RATIO) return void 0;
+  return contrastRatio("FFFFFF", fill.toUpperCase()) > contrastRatio("000000", fill.toUpperCase()) ? "FFFFFF" : "000000";
+}
+function noteAutoText(warnings, seen, fill, text2, where) {
+  const key = `auto:${fill}:${text2}`;
+  if (seen.has(key)) return;
+  seen.add(key);
+  warnings.push(
+    `Table note: text set to #${text2} at ${where} because black text is not readable on fill #${fill} (contrast ${contrastRatio(text2, fill).toFixed(2)}:1). Pass textColor to choose another colour.`
+  );
+}
 function paintCellTextColor(tc, doc, normColor) {
   let ps = directChildren5(tc, "w:p");
   if (ps.length === 0) {
@@ -15554,6 +15654,13 @@ async function executeTable(opIn, ast, guide) {
           let effectiveText;
           if (rIdx === 0) {
             effectiveText = explicitTextColor ?? guideTextForFill(rowFill);
+            if (effectiveText === void 0) {
+              const auto = autoTextForFill(rowFill, firstExplicitCellTextColor(tc));
+              if (auto) {
+                effectiveText = auto;
+                noteAutoText(warnings, warnedContrastPairs, rowFill, auto, `header cell (${rIdx + 1},${cIdx + 1}) of table '${tableNode.id}'`);
+              }
+            }
             if (effectiveText && tblEl.ownerDocument) {
               paintCellTextColor(tc, tblEl.ownerDocument, effectiveText);
             }
@@ -16080,7 +16187,14 @@ async function executeTable(opIn, ast, guide) {
       shd.setAttribute("w:color", "auto");
       shd.setAttribute("w:fill", normFill);
       sortChildrenBySchema(tcPr, TCPR_CHILD_ORDER);
-      const effectiveText = explicitTextColor ?? guideTextForFill(normFill);
+      let effectiveText = explicitTextColor ?? guideTextForFill(normFill);
+      if (effectiveText === void 0) {
+        const auto = autoTextForFill(normFill, firstExplicitCellTextColor(tc));
+        if (auto) {
+          effectiveText = auto;
+          noteAutoText(warnings, warnedContrastPairs, normFill, auto, `cell (${shown(rowIndex)},${shown(colIndex)}) of table '${tableNode.id}'`);
+        }
+      }
       if (effectiveText && tblEl.ownerDocument) {
         paintCellTextColor(tc, tblEl.ownerDocument, effectiveText);
       }
@@ -16364,7 +16478,7 @@ async function executeTable(opIn, ast, guide) {
       break;
     }
     case "setCellTextColor": {
-      const colorInput = raw.color ?? op.color;
+      const colorInput = raw.color ?? op.color ?? raw.textColor ?? op.textColor;
       if (colorInput === void 0 || colorInput === null || String(colorInput).trim() === "") {
         throw new Error(
           `E_VALIDATION: setCellTextColor requires color (got no color). Remedy: pass color as 6 hex digits without '#', e.g. color:'FFFFFF' for white header text.`
@@ -16820,6 +16934,13 @@ function sanitizeXml(xmlStr) {
 // ../engine/src/operation-schema.ts
 var import_zod2 = require("zod");
 
+// ../engine/src/anchor-alias.ts
+function anchorAliasOf(value) {
+  if (value === "start" || value === "@start") return "start";
+  if (value === "end" || value === "@end") return "end";
+  return null;
+}
+
 // ../engine/src/operation-params.ts
 var STRUCTURAL = /* @__PURE__ */ new Set(["action", "target", "tableId", "operation", "op", "params", "trackChanges", "expectedVersion"]);
 var ROW = ["rowIndex", "row"];
@@ -16845,9 +16966,17 @@ var TABLE_SUBOP_KEYS = {
   setCellAlignment: ["align", "alignment", ...ROW, ...COL],
   setTableAlignment: ["align", "alignment"],
   setCellPadding: ["padding", ...ROW, ...COL],
-  setCellTextColor: ["color", ...ROW, ...COL],
+  setCellTextColor: ["color", "textColor", ...ROW, ...COL],
   setKeepTogether: []
 };
+function describeTableSubOpKeys() {
+  const aliases = /* @__PURE__ */ new Set(["rowIndex", "colIndex", "columnIndex"]);
+  const parts = Object.entries(TABLE_SUBOP_KEYS).map(([sub, keys]) => {
+    const shown2 = keys.filter((k) => !aliases.has(k));
+    return shown2.length > 0 ? `${sub}(${shown2.join(",")})` : sub;
+  });
+  return `Parameters each operation reads (row and col count from 1): ${parts.join("; ")}.`;
+}
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -20801,6 +20930,8 @@ var expectedVersion = import_zod2.z.number().int().nonnegative().optional();
 var nestedParams = import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional();
 var sectionNumber = import_zod2.z.number().int().positive("sections count from 1 (1 is the first section)").describe("Section number, counting from 1 (1 is the first section).");
 var position = import_zod2.z.enum(["before", "after"]);
+var ANCHOR_REF_DESCRIPTION = "A node id from inspect_document, or 'start' / 'end' for the first / last block of the document (no inspect needed; '@start' and '@end' work too). With 'start', position defaults to 'before'; with 'end', to 'after'.";
+var ANCHOR_REF_SHORT = "A node id, or 'start' / 'end' for the first / last block.";
 var operationInsertPosition = import_zod2.z.enum(["before", "after"]).optional();
 var FONT_SIZE_PT_REGEX = /^\s*(\d+(?:\.\d+)?)\s*pt\s*$/i;
 function parseFontSize(sz) {
@@ -20903,7 +21034,7 @@ var insertOp = import_zod2.z.object({
   // engine appends in call order without ever reading them) need no dummy
   // anchor. Body inserts still require both — enforced by the strict
   // validators below, not by this shape.
-  anchor: import_zod2.z.string().min(1).max(256).optional(),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_DESCRIPTION).optional(),
   position: operationInsertPosition,
   text: import_zod2.z.string().max(5e5).optional(),
   xml: import_zod2.z.string().max(5e5).optional(),
@@ -21025,7 +21156,7 @@ var clearFormatOp = import_zod2.z.object({
 var moveOp = import_zod2.z.object({
   action: import_zod2.z.literal("move"),
   target: nodeIdOrList,
-  anchor: import_zod2.z.string().min(1).max(256),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT),
   position,
   expectedVersion,
   params: nestedParams
@@ -21062,8 +21193,8 @@ var tableOp = import_zod2.z.object({
   action: import_zod2.z.literal("table"),
   target: import_zod2.z.string().min(1).max(256).optional(),
   tableId: import_zod2.z.string().min(1).max(256).optional(),
-  operation: tableSubOp.optional(),
-  op: tableSubOp.optional(),
+  operation: tableSubOp.describe(describeTableSubOpKeys()).optional(),
+  op: tableSubOp.describe("Alias of operation.").optional(),
   trackChanges: import_zod2.z.boolean().optional(),
   author: revisionAuthor,
   date: revisionDate,
@@ -21093,7 +21224,6 @@ var tableOp = import_zod2.z.object({
   border: import_zod2.z.string().max(32).optional(),
   color: import_zod2.z.string().max(16).optional(),
   sz: fontSizeOrSzSchema.optional(),
-  fontSize: fontSizeOrSzSchema.optional(),
   vAlign: import_zod2.z.string().max(16).optional(),
   align: tableAlignmentSchema.optional(),
   alignment: tableAlignmentSchema.optional(),
@@ -21155,7 +21285,7 @@ var namedStyleOp = import_zod2.z.object({
 var fieldOp = import_zod2.z.object({
   action: import_zod2.z.literal("field"),
   operation: import_zod2.z.enum(["insertTOC", "insertPageNumber", "insertWordCount", "updateFields"]),
-  anchor: import_zod2.z.string().min(1).max(256).optional(),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT).optional(),
   position: operationInsertPosition,
   title: import_zod2.z.string().max(1e3).optional(),
   levels: import_zod2.z.number().int().min(1).max(9).optional(),
@@ -21171,7 +21301,7 @@ var equationOp = import_zod2.z.object({
   action: import_zod2.z.literal("equation"),
   operation: import_zod2.z.enum(["insert", "replace"]),
   latex: import_zod2.z.string().min(1).max(5e4),
-  anchor: import_zod2.z.string().min(1).max(256).optional(),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT).optional(),
   position: operationInsertPosition,
   target: import_zod2.z.string().min(1).max(256).optional(),
   id: import_zod2.z.string().min(1).max(256).optional(),
@@ -21285,7 +21415,7 @@ var chartOp = import_zod2.z.object({
   categories: import_zod2.z.array(import_zod2.z.string().max(500)).max(1e3).optional(),
   series: import_zod2.z.array(chartSeries).max(100).optional(),
   style: chartStyle.optional(),
-  anchor: import_zod2.z.string().min(1).max(256).optional(),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT).optional(),
   id: import_zod2.z.string().min(1).max(256).optional(),
   widthEmu: import_zod2.z.number().positive().max(1e8).optional(),
   heightEmu: import_zod2.z.number().positive().max(1e8).optional(),
@@ -21295,7 +21425,7 @@ var chartOp = import_zod2.z.object({
 var imageOp = import_zod2.z.object({
   action: import_zod2.z.literal("image"),
   operation: import_zod2.z.enum(["insert", "resize", "reposition", "setWrap", "setCaption", "delete", "setAltText"]),
-  anchor: import_zod2.z.string().min(1).max(256).optional(),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT).optional(),
   target: import_zod2.z.string().min(1).max(256).optional(),
   fileData: import_zod2.z.string().max(2e7).optional(),
   filePath: import_zod2.z.string().min(1).max(1024).optional(),
@@ -21309,7 +21439,8 @@ var imageOp = import_zod2.z.object({
 var calloutOp = import_zod2.z.object({
   action: import_zod2.z.literal("callout"),
   text: import_zod2.z.string().min(1).max(1e5),
-  anchor: import_zod2.z.string().min(1).max(256).optional(),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT).optional(),
+  id: import_zod2.z.string().min(1).max(256).optional(),
   title: import_zod2.z.string().max(1e3).optional(),
   theme: import_zod2.z.string().max(32).optional(),
   position: operationInsertPosition,
@@ -21319,7 +21450,7 @@ var calloutOp = import_zod2.z.object({
 var footnoteOp = import_zod2.z.object({
   action: import_zod2.z.literal("footnote"),
   operation: import_zod2.z.enum(["insert"]).optional(),
-  anchor: import_zod2.z.string().min(1).max(256),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT),
   text: import_zod2.z.string().min(1).max(5e4),
   id: import_zod2.z.string().min(1).max(256).optional(),
   offset: import_zod2.z.number().int().nonnegative().optional(),
@@ -21328,7 +21459,7 @@ var footnoteOp = import_zod2.z.object({
 var endnoteOp = import_zod2.z.object({
   action: import_zod2.z.literal("endnote"),
   operation: import_zod2.z.enum(["insert"]).optional(),
-  anchor: import_zod2.z.string().min(1).max(256),
+  anchor: import_zod2.z.string().min(1).max(256).describe(ANCHOR_REF_SHORT),
   text: import_zod2.z.string().min(1).max(5e4),
   id: import_zod2.z.string().min(1).max(256).optional(),
   offset: import_zod2.z.number().int().nonnegative().optional(),
@@ -21507,11 +21638,11 @@ function insertBodyAnchorDetail(op) {
   if (effectiveTarget === "header" || effectiveTarget === "footer") return null;
   const missing = [];
   if (typeof rec["anchor"] !== "string" || rec["anchor"].length < 1) {
-    missing.push("anchor: anchor is required for body inserts [invalid_type]");
+    missing.push("anchor: anchor is required for body inserts: a node id from inspect_document, or 'start' / 'end' for the first / last block [invalid_type]");
   }
   const pos = rec["position"];
-  if (pos !== "before" && pos !== "after") {
-    missing.push("position: position is required for body inserts [invalid_type]");
+  if (pos !== "before" && pos !== "after" && anchorAliasOf(rec["anchor"]) === null) {
+    missing.push("position: position is required for body inserts (or use anchor 'start' / 'end', which imply it) [invalid_type]");
   }
   return missing.length > 0 ? missing.join("; ") : null;
 }
@@ -28225,7 +28356,7 @@ function resolveImageFilePath(allowedDir, filePath) {
       "use a plain relative file path inside the allowed directory"
     );
   }
-  if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(trimmed)) {
+  if (hasUriScheme(trimmed)) {
     throw toError(
       "E_SANDBOX",
       "image filePath points outside the allowed directory",
@@ -28396,7 +28527,7 @@ function resolveAssetPath(allowedDir, refPath, line2, what) {
   if (trimmed.includes("\0") || /%00/i.test(trimmed) || trimmed.includes("\n") || trimmed.includes("\r")) {
     fail(line2, `${what} reference path is not usable`, "use a plain relative file path inside the allowed directory");
   }
-  if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(trimmed)) {
+  if (hasUriScheme(trimmed)) {
     fail(line2, `${what} reference points outside the allowed directory`, "keep referenced files inside the allowed directory and use a relative path");
   }
   const candidate = import_path5.default.isAbsolute(trimmed) ? import_path5.default.resolve(trimmed) : import_path5.default.resolve(allowedDir, trimmed);
@@ -29666,7 +29797,8 @@ async function executeCallout(op, ast, parser2, guide) {
   if (!targetSection) throw new Error("No section available for callout box insertion");
   const ownerDoc = targetSection.nodes[0]?.xml?.ownerDocument || ownerDocumentOf(ast.sections);
   if (!ownerDoc) throw new Error("Cannot resolve XML DOM document");
-  const calloutId = isCalloutReproducible() ? (() => {
+  const clientId = pick("id", op.id);
+  const calloutId = typeof clientId === "string" && clientId.length > 0 ? clientId : isCalloutReproducible() ? (() => {
     const base = `callout_${calloutHash8(`${resolvedAnchor ?? ""}:${resolvedPosition}:${themeKey}:${resolvedTitle ?? ""}:${resolvedText}`)}`;
     const live = /* @__PURE__ */ new Set();
     try {
@@ -30977,6 +31109,208 @@ function executePageBorder(op, ast, parser2) {
   section.version += 1;
 }
 
+// ../engine/src/compose/pristine-seed.ts
+function pristineTemplateSeedIds(parser2, requestedTemplate) {
+  if (!parser2.hasPristineBuiltinSeed()) return null;
+  let summary;
+  try {
+    summary = parser2.getStructuralSummary();
+  } catch {
+    return null;
+  }
+  const nodes = summary.nodes ?? [];
+  if (![1, 2, 4, 5, 6].includes(nodes.length)) return null;
+  if (summary.hasTrackedChanges === true) return null;
+  if (Object.keys(summary.mediaFiles ?? {}).length > 0) return null;
+  if ((summary.headers ?? []).length > 0) return null;
+  if ((summary.footers ?? []).length > 0) return null;
+  if ((summary.charts ?? []).length > 0) return null;
+  try {
+    const zip = parser2.getZipAdapter?.();
+    if (typeof zip?.hasFile === "function") {
+      for (const part of [
+        "word/footnotes.xml",
+        "word/endnotes.xml",
+        "word/comments.xml",
+        "word/commentsExtended.xml"
+      ]) {
+        try {
+          if (zip.hasFile(part)) return null;
+        } catch {
+          return null;
+        }
+      }
+    } else {
+      return null;
+    }
+  } catch {
+    return null;
+  }
+  for (const n of nodes) {
+    if (n.hasTrackedChanges === true) return null;
+    const raw = n.rawXml ?? "";
+    if (raw.includes("w:footnoteReference") || raw.includes("w:endnoteReference") || raw.includes("w:commentReference") || raw.includes("w:commentRangeStart") || raw.includes("w:commentRangeEnd")) {
+      return null;
+    }
+  }
+  const ids = nodes.map((n) => n.id ?? "").filter((id) => id.length > 0);
+  if (ids.length !== nodes.length) return null;
+  if (nodes.length === 1) {
+    const node = nodes[0];
+    if (node.type !== "paragraph") return null;
+    if ((node.text ?? "").trim() !== "") return null;
+    return ids;
+  }
+  if (nodes.length === 2) {
+    const [first, second] = nodes;
+    const t0 = (first.text ?? "").trim();
+    const t1 = (second.text ?? "").trim();
+    if (t0 === BLANK_SEED_TITLE && t1 === BLANK_SEED_HINT) {
+      const firstRaw = first.rawXml ?? "";
+      const secondRaw = second.rawXml ?? "";
+      if (!firstRaw.includes('w:val="Title"') || !secondRaw.includes('w:val="Subtitle"')) return null;
+      return ids;
+    }
+    const tmpl = requestedTemplate?.toLowerCase();
+    if (t0 === "MEMORANDUM" && tmpl === "memo") return ids;
+    if (t0 === "Letter" && tmpl === "letter") return ids;
+    if (t0 === "Proposal" && tmpl === "proposal") return ids;
+    if (t0 === "INVOICE" && tmpl === "invoice") return ids;
+    return null;
+  }
+  if (nodes.length === 4) {
+    const t0 = (nodes[0].text ?? "").trim();
+    const tmpl = requestedTemplate?.toLowerCase();
+    if (t0 === "Research Benchmark Report" && tmpl === "research") return ids;
+    if (t0 === "Corporate Strategy Roadmap" && tmpl === "corporate") return ids;
+    if (t0 === "Velocity Audit & Performance" && tmpl === "bar-chart-3d") return ids;
+    return null;
+  }
+  if (nodes.length === 5) {
+    const t0 = (nodes[0].text ?? "").trim();
+    const tmpl = requestedTemplate?.toLowerCase();
+    if (t0 === "Financial Report & Audit" && tmpl === "financial") return ids;
+    return null;
+  }
+  if (nodes.length === 6) {
+    const t0 = (nodes[0].text ?? "").trim();
+    const t2 = (nodes[2].text ?? "").trim();
+    const tmpl = requestedTemplate?.toLowerCase();
+    if (t0 === "Q3 Executive Financial Performance Report" && t2 === "1. Executive Summary") {
+      if (tmpl === "report") return ids;
+      return null;
+    }
+    if (t0 === "Manuscript Title" && t2 === "Chapter 1: The Beginning" && tmpl === "novel") {
+      return ids;
+    }
+    if (t0 === "Neural Document Architectures: A Comparative Benchmark" && tmpl === "academic") {
+      return ids;
+    }
+    if (t0 === "The ASTra Dispatch \u2014 Monthly Engineering Gazette" && tmpl === "newsletter") return ids;
+    if (t0 === "ASTra Document Engine API Specification" && (tmpl === "api" || tmpl === "api-spec")) return ids;
+    return null;
+  }
+  return null;
+}
+var SEED_TEMPLATE_NAMES = [
+  "memo",
+  "letter",
+  "proposal",
+  "invoice",
+  "research",
+  "corporate",
+  "bar-chart-3d",
+  "financial",
+  "report",
+  "novel",
+  "academic",
+  "newsletter",
+  "api-spec"
+];
+function pristineSeedIdsOfAnyTemplate(parser2) {
+  const blank = pristineTemplateSeedIds(parser2);
+  if (blank !== null) return blank;
+  for (const name2 of SEED_TEMPLATE_NAMES) {
+    const ids = pristineTemplateSeedIds(parser2, name2);
+    if (ids !== null) return ids;
+  }
+  return null;
+}
+
+// ../engine/src/document-title.ts
+var TEMPLATE_NAMES = [
+  "blank",
+  "memo",
+  "report",
+  "letter",
+  "proposal",
+  "invoice",
+  "research",
+  "corporate",
+  "financial",
+  "novel",
+  "academic",
+  "newsletter",
+  "api-spec",
+  "bar-chart-3d"
+];
+var PLACEHOLDER_TITLES = new Set(TEMPLATE_NAMES.map((name2) => newDocumentTitle(name2).toLowerCase()));
+var DERIVED_TITLE_MAX = 200;
+var DEFAULT_CREATOR = "ASTra";
+function isPlaceholderTitle(title) {
+  if (typeof title !== "string") return true;
+  const clean = title.replace(/\s+/g, " ").trim().toLowerCase();
+  return clean === "" || PLACEHOLDER_TITLES.has(clean);
+}
+function cleanTitle(text2) {
+  const plain = typeof text2 === "string" ? Array.from(text2, (ch) => ch.charCodeAt(0) < 32 || ch.charCodeAt(0) === 127 ? " " : ch).join("").replace(/\s+/g, " ").trim() : "";
+  return plain.length > DERIVED_TITLE_MAX ? plain.slice(0, DERIVED_TITLE_MAX).trimEnd() : plain;
+}
+function deriveTitleFromContent(ast) {
+  const nodes = ast.sections.flatMap((section) => section.nodes);
+  const styleOf = (node) => {
+    const pPr = Array.from(node.xml.childNodes).find((c) => c.nodeType === 1 && c.tagName === "w:pPr");
+    const pStyle = pPr ? Array.from(pPr.childNodes).find((c) => c.nodeType === 1 && c.tagName === "w:pStyle") : void 0;
+    return pStyle?.getAttribute("w:val") ?? node.metadata?.namedStyle ?? void 0;
+  };
+  const textOf4 = (node) => {
+    const runs = node.xml.getElementsByTagName("w:t");
+    let text2 = "";
+    for (let i = 0; i < runs.length; i++) text2 += runs[i].textContent ?? "";
+    return text2 !== "" ? text2 : node.metadata?.text ?? "";
+  };
+  const pick = (match, from) => {
+    for (const node of nodes) {
+      if (node.type !== "paragraph" || !match(node)) continue;
+      const title = cleanTitle(textOf4(node));
+      if (title !== "" && !isPlaceholderTitle(title)) return { title, from };
+    }
+    return null;
+  };
+  return pick((n) => n.id.startsWith("cover_title_"), "cover page") ?? pick((n) => styleOf(n) === "Title", "Title") ?? pick((n) => styleOf(n) === "Heading1", "Heading 1");
+}
+function applyDocumentIdentity(ast, parser2) {
+  const result = {};
+  const patch = {};
+  if (isPlaceholderTitle(ast.metadata?.title)) {
+    const derived = deriveTitleFromContent(ast);
+    if (derived) {
+      patch.title = derived.title;
+      result.title = derived.title;
+      result.titleSetFrom = derived.from;
+    }
+  }
+  const author = typeof ast.settings?.defaultAuthor === "string" ? ast.settings.defaultAuthor.trim() : "";
+  if (author !== "" && author !== DEFAULT_CREATOR && ast.metadata?.creator === DEFAULT_CREATOR) {
+    patch.creator = author;
+    patch.lastModifiedBy = author;
+    result.creatorSet = author;
+  }
+  if (Object.keys(patch).length === 0) return result;
+  new CorePropertiesManipulator(ast, parser2?.getZipAdapter()).update(patch);
+  return result;
+}
+
 // ../engine/src/operations/coverPage.ts
 function isCoverReproducible(explicit, env) {
   try {
@@ -31041,6 +31375,7 @@ function executeCoverPage(op, ast, parser2) {
   if (!firstSection || firstSection.nodes.length === 0) {
     throw new Error("Cannot insert cover page into an empty document");
   }
+  const seedIds = parser2 ? pristineSeedIdsOfAnyTemplate(parser2) : null;
   const doc = firstSection.nodes[0].xml.ownerDocument;
   if (!doc) throw new Error("Document not found on first section");
   const sectPr = doc.getElementsByTagName("w:sectPr")[0];
@@ -31107,8 +31442,8 @@ function executeCoverPage(op, ast, parser2) {
   titleColor.setAttribute("w:val", accentColor);
   titleRPr.appendChild(titleFont);
   titleRPr.appendChild(titleBold);
-  titleRPr.appendChild(titleSz);
   titleRPr.appendChild(titleColor);
+  titleRPr.appendChild(titleSz);
   titleRun.appendChild(titleRPr);
   titleRun.appendChild(createTextElement(doc, titleText));
   titleP.appendChild(titleRun);
@@ -31134,8 +31469,8 @@ function executeCoverPage(op, ast, parser2) {
     subSz.setAttribute("w:val", "28");
     const subColor = createWordElement(doc, "w:color");
     subColor.setAttribute("w:val", "64748B");
-    subRPr.appendChild(subSz);
     subRPr.appendChild(subColor);
+    subRPr.appendChild(subSz);
     subRun.appendChild(subRPr);
     subRun.appendChild(createTextElement(doc, subtitleText));
     subP.appendChild(subRun);
@@ -31185,8 +31520,8 @@ function executeCoverPage(op, ast, parser2) {
   metaSz.setAttribute("w:val", "22");
   const metaColor = createWordElement(doc, "w:color");
   metaColor.setAttribute("w:val", "475569");
-  metaRPr.appendChild(metaSz);
   metaRPr.appendChild(metaColor);
+  metaRPr.appendChild(metaSz);
   metaRun.appendChild(metaRPr);
   const metaLines = [authorText, orgText, dateText].filter(Boolean).join(" \u2022 ");
   metaRun.appendChild(createTextElement(doc, metaLines || dateText));
@@ -31231,6 +31566,13 @@ function executeCoverPage(op, ast, parser2) {
       }
     }
   }
+  if (seedIds !== null && seedIds.length > 0) {
+    executeDelete({ action: "delete", target: seedIds }, ast, parser2);
+  }
+  try {
+    applyDocumentIdentity(ast, parser2);
+  } catch {
+  }
 }
 
 // ../engine/src/operations/metadata.ts
@@ -31402,8 +31744,9 @@ function collectBatchTouchedIds(ops, ast) {
   const touch = (raw) => {
     if (typeof raw !== "string" || raw.length === 0) return;
     let resolved = raw;
-    if (raw === "start") resolved = order[0] ?? raw;
-    else if (raw === "end") resolved = order[order.length - 1] ?? raw;
+    const alias = anchorAliasOf(raw);
+    if (alias === "start") resolved = order[0] ?? raw;
+    else if (alias === "end") resolved = order[order.length - 1] ?? raw;
     else {
       const cell = parseCellAddress(raw);
       if (cell && order.includes(cell.tableId)) resolved = cell.tableId;
@@ -31996,13 +32339,13 @@ var OperationEngine = class _OperationEngine {
   /**
    * R-4 helper: true when the op mints a live node id from the client id.
    * Only these routes use `op.id` verbatim as the node id; other actions
-   * either ignore `id` (footnote/callout/field generate their own) or are
+   * either ignore `id` (footnote/field generate their own) or are
    * rejected at the schema gate, so live collision applies here only.
    */
   static mintsNodeId(op) {
     const fields = op;
     const action = typeof fields["action"] === "string" ? String(fields["action"]) : "";
-    if (action === "insert") return true;
+    if (action === "insert" || action === "callout") return true;
     if (action === "equation") {
       const sub = fields["operation"] ?? fields["params"]?.["operation"];
       return sub === "insert";
@@ -32102,7 +32445,7 @@ var OperationEngine = class _OperationEngine {
    * E_VALIDATION + remedy.
    */
   static isAnchorAlias(value) {
-    return value === "start" || value === "end";
+    return anchorAliasOf(value) !== null;
   }
   resolveAnchorAlias(op) {
     const fields = op;
@@ -32118,6 +32461,10 @@ var OperationEngine = class _OperationEngine {
       }
     }
     if (aliasSeen === null) return;
+    for (const h of holders) {
+      const alias = anchorAliasOf(h["anchor"]);
+      if (alias !== null && h["position"] === void 0) h["position"] = alias === "start" ? "before" : "after";
+    }
     let first;
     let last;
     for (const section of this.ast.sections ?? []) {
@@ -32134,8 +32481,9 @@ var OperationEngine = class _OperationEngine {
       );
     }
     for (const h of holders) {
-      if (h["anchor"] === "start") h["anchor"] = first;
-      else if (h["anchor"] === "end") h["anchor"] = last;
+      const alias = anchorAliasOf(h["anchor"]);
+      if (alias === "start") h["anchor"] = first;
+      else if (alias === "end") h["anchor"] = last;
     }
   }
   async routeOperation(op, allowedDir) {
@@ -33392,7 +33740,11 @@ ${textLines.map((l) => `> ${l}`).join("\n")}
 `);
             } else {
               const textLines = text2 ? text2.split("\n") : [];
-              lines.push(`${textLines.map((l) => `> ${l}`).join("\n")}
+              const ind = node.xml?.getElementsByTagName?.("w:pPr")?.[0]?.getElementsByTagName?.("w:ind")?.[0] ?? null;
+              const left = ind ? parseInt(ind.getAttribute("w:left") || "0", 10) : 0;
+              const depth = style === "quote" && Number.isFinite(left) && left > 0 ? Math.min(3, Math.max(1, Math.round(left / 720))) : 1;
+              const marker = ">".repeat(1).concat(" >".repeat(depth - 1));
+              lines.push(`${textLines.map((l) => `${marker} ${l}`).join("\n")}
 `);
             }
           } else {
@@ -33896,17 +34248,19 @@ function directKids(parent, tag) {
   return out;
 }
 function cellTextOf(tc) {
-  let text2 = "";
+  const parts = [];
   try {
     const paras = directKids(tc, "w:p");
     for (const p of paras) {
+      let text2 = "";
       const ts = p.getElementsByTagName("w:t");
       for (let i = 0; i < ts.length; i++) text2 += ts[i].textContent || "";
+      if (text2.trim().length > 0) parts.push(text2);
     }
   } catch {
     return "";
   }
-  return text2;
+  return parts.join(" ");
 }
 function displayLen(value) {
   return [...value].length;
@@ -38075,6 +38429,134 @@ var HeadlessVisualRenderer = class {
 };
 var headlessScreenshotProvider = new HeadlessVisualRenderer();
 
+// ../engine/src/stats.ts
+function nearestOwner(el, tagName) {
+  let cur = el.parentNode;
+  while (cur && typeof cur === "object") {
+    const e = cur;
+    if (e.tagName === tagName) return e;
+    cur = e.parentNode;
+  }
+  return null;
+}
+function tableCellTextSpaced(node) {
+  try {
+    const xml = node.xml;
+    if (!xml || typeof xml.getElementsByTagName !== "function") return void 0;
+    const tcs = xml.getElementsByTagName("w:tc");
+    if (!tcs || tcs.length === 0) return void 0;
+    const cells = [];
+    for (let i = 0; i < tcs.length; i++) {
+      const tc = tcs[i];
+      const paras = tc.getElementsByTagName("w:p");
+      if (paras.length > 0) {
+        const parts = [];
+        for (let p = 0; p < paras.length; p++) {
+          const para = paras[p];
+          if (nearestOwner(para, "w:tc") !== tc) continue;
+          const runs = para.getElementsByTagName("w:t");
+          let t = "";
+          for (let r = 0; r < runs.length; r++) {
+            const run2 = runs[r];
+            if (nearestOwner(run2, "w:tc") !== tc) continue;
+            if (nearestOwner(run2, "w:p") !== para) continue;
+            t += run2.textContent || "";
+          }
+          if (t.trim().length > 0) parts.push(t.trim());
+        }
+        if (parts.length > 0) cells.push(parts.join(" "));
+      } else {
+        const runs = tc.getElementsByTagName("w:t");
+        let t = "";
+        for (let r = 0; r < runs.length; r++) {
+          const run2 = runs[r];
+          if (nearestOwner(run2, "w:tc") !== tc) continue;
+          t += run2.textContent || "";
+        }
+        if (t.trim().length > 0) cells.push(t.trim());
+      }
+    }
+    if (cells.length === 0) return "";
+    return cells.join(" ");
+  } catch {
+    return void 0;
+  }
+}
+function nestedTableCount(node) {
+  try {
+    const xml = node.xml;
+    if (!xml || typeof xml.getElementsByTagName !== "function") return 0;
+    return xml.getElementsByTagName("w:tbl").length;
+  } catch {
+    return 0;
+  }
+}
+function isCalloutTable(node, dims) {
+  try {
+    const xml = node.xml;
+    if (!xml || typeof xml.getElementsByTagName !== "function") return false;
+    if (dims) {
+      if (dims.rows !== 1 || dims.cols !== 1) return false;
+    } else {
+      const rows = Array.from(xml.childNodes).filter((n) => n.nodeType === 1 && n.tagName === "w:tr");
+      if (rows.length !== 1) return false;
+      const cells = Array.from(rows[0].childNodes).filter((n) => n.nodeType === 1 && n.tagName === "w:tc");
+      if (cells.length !== 1) return false;
+    }
+    const fill = xml.getElementsByTagName("w:shd")[0]?.getAttribute("w:fill") ?? "";
+    return /^[0-9A-Fa-f]{6}$/.test(fill);
+  } catch {
+    return false;
+  }
+}
+function countExplicitPageBreaks(node) {
+  if (node.type === "pageBreak") return 1;
+  const text2 = node.metadata?.text || "";
+  let count = text2 === "[Page Break]" ? 1 : 0;
+  try {
+    const xml = node.xml;
+    if (xml && typeof xml.getElementsByTagName === "function") {
+      const brs = xml.getElementsByTagName("w:br");
+      let brCount = 0;
+      for (let i = 0; i < brs.length; i++) {
+        if (brs[i].getAttribute("w:type") === "page") brCount++;
+      }
+      if (brCount > count) count = brCount;
+    }
+  } catch {
+  }
+  return count;
+}
+function computeDocStats(ast) {
+  let words = 0;
+  let paragraphs = 0;
+  let tables = 0;
+  let callouts = 0;
+  let images = 0;
+  let pageBreaks = 0;
+  for (const sec of ast.sections) {
+    for (const node of sec.nodes) {
+      if (node.type === "paragraph") paragraphs += 1;
+      if (node.type === "table") {
+        if (isCalloutTable(node)) callouts += 1;
+        else tables += 1;
+        tables += nestedTableCount(node);
+      }
+      if (node.type === "image") images += 1;
+      pageBreaks += countExplicitPageBreaks(node);
+      let text2 = node.metadata?.text ?? "";
+      if (node.type === "table") {
+        const spaced = tableCellTextSpaced(node);
+        if (spaced !== void 0) text2 = spaced;
+      }
+      const hits = text2.match(/\S+/g);
+      if (hits) words += hits.length;
+    }
+  }
+  const pageBudget = words / 450 + (tables + callouts) * 0.45 + images * 0.5 + pageBreaks;
+  return { words, paragraphs, pages: Math.max(1, Math.ceil(pageBudget)), tables, callouts, images };
+}
+
 // ../engine/src/visual/telemetry.ts
 var VISUAL_TELEMETRY_TOKEN_BUDGET = 500;
 var VISUAL_WIREFRAME_WIDTH = 68;
@@ -38171,17 +38653,6 @@ var WIREFRAME_TABLE_ROWS = 3;
 function flatText(value) {
   return value.replace(/\s+/g, " ").trim();
 }
-function isCalloutTable(node, grid) {
-  if (!grid || grid.rows !== 1 || grid.cols !== 1) return false;
-  try {
-    const xml = node.xml;
-    const shd = xml?.getElementsByTagName("w:shd")[0];
-    const fill = shd?.getAttribute("w:fill") ?? "";
-    return /^[0-9A-Fa-f]{6}$/.test(fill);
-  } catch {
-    return false;
-  }
-}
 function tableRowLines(grid, width) {
   const byRow = /* @__PURE__ */ new Map();
   for (const cell of grid.cells) {
@@ -38404,7 +38875,7 @@ function generateVisualWireframe(ast, targetPage = 1, pageMap, maxNodes = 24, op
     } else if (node.type === "table") {
       lines.push(emptyLine);
       const grid = tableGridOf(node);
-      if (isCalloutTable(node, grid)) {
+      if (isCalloutTable(node, grid ? { rows: grid.rows, cols: grid.cols } : null)) {
         const note = flatText(grid?.cells[0]?.text ?? "");
         const body = note.length > 48 ? note.slice(0, 45) + "..." : note;
         lines.push(`| [CALLOUT] ${body}`.slice(0, W2 - 2).padEnd(W2 - 1) + "|");
@@ -38591,6 +39062,10 @@ function buildLineIndex(src, tokens) {
   }
   return out;
 }
+var QUOTE_INDENT = QUOTE_INDENT_TWIPS;
+var QUOTE_LIST_INDENT = 360;
+var QUOTE_MAX_LEVEL = 3;
+var CODE_BLOCK_BASE_INDENT = 80;
 function subLine(blockRaw, blockLine, excerpt) {
   const found = blockRaw.indexOf(excerpt);
   if (found === -1) return blockLine;
@@ -38762,12 +39237,17 @@ function compileMarkdownDetailed(markdown, options) {
   const pendingNotes = [];
   let seq = 0;
   let lastInsertId = null;
+  const idPrefix = options?.idPrefix ?? "md";
   const nextId = () => {
     seq += 1;
-    return `md_${String(seq).padStart(4, "0")}`;
+    return `${idPrefix}_${String(seq).padStart(4, "0")}`;
+  };
+  const startAnchor = {
+    anchor: options?.anchor ?? "end",
+    position: options?.position ?? "after"
   };
   const insertAnchor = () => {
-    if (lastInsertId === null) return { anchor: "end", position: "after" };
+    if (lastInsertId === null) return { ...startAnchor };
     return { anchor: lastInsertId, position: "after" };
   };
   const pushInsertParagraph = (text2, spans) => {
@@ -38895,12 +39375,12 @@ function compileMarkdownDetailed(markdown, options) {
       const inlineMime = inlineKind === "jpeg" ? "image/jpeg" : inlineKind === "svg" ? "image/svg+xml" : inlineKind === "tiff" ? "image/tiff" : `image/${inlineKind}`;
       const inlineFitted = fitImageEmus(decodeImagePixels(inlineBuf, inlineKind));
       const inlineId = nextId();
-      const inlineAnchor = lastInsertId === null ? "end" : lastInsertId;
+      const inlineAnchor = insertAnchor();
       ops.push({
         action: "insert",
         type: "image",
-        anchor: inlineAnchor,
-        position: "after",
+        anchor: inlineAnchor.anchor,
+        position: inlineAnchor.position,
         id: inlineId,
         fileData: `data:${inlineMime};base64,${inlineBuf.toString("base64")}`,
         ...inlineFitted ? { width: inlineFitted.width, height: inlineFitted.height } : {},
@@ -38909,7 +39389,7 @@ function compileMarkdownDetailed(markdown, options) {
       lastInsertId = inlineId;
       return { id: inlineId, kind: "image" };
     }
-    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(target)) {
+    if (hasUriScheme(target)) {
       fail(line2, "image reference points outside the allowed directory", "keep referenced files inside the allowed directory and use a relative path");
     }
     if (allowedDir === void 0) {
@@ -38918,14 +39398,17 @@ function compileMarkdownDetailed(markdown, options) {
     const isChart = target.toLowerCase().endsWith(CHART_JSON_SUFFIX);
     const absPath = resolveAssetPath(allowedDir, target, line2, isChart ? "chart" : "image");
     const id = nextId();
-    const anchorId = lastInsertId === null ? "end" : lastInsertId;
+    const chartAnchor = insertAnchor();
     if (isChart) {
+      if (chartAnchor.position === "before") {
+        fail(line2, "a chart cannot be the first block when the compose goes before a node", "start the Markdown with a paragraph, or place the compose after the node");
+      }
       const asset2 = readChartAsset(absPath, line2, allowedDir);
       const title = asset2.title ?? (alt.trim().length > 0 ? alt.trim() : "Chart");
       ops.push({
         action: "chart",
         operation: "insert",
-        anchor: anchorId,
+        anchor: chartAnchor.anchor,
         id,
         chartType: asset2.chartType,
         title,
@@ -38936,7 +39419,7 @@ function compileMarkdownDetailed(markdown, options) {
       return { id, kind: "chart" };
     }
     const asset = readImageAsset(absPath, line2, allowedDir);
-    const anchor = lastInsertId === null ? { anchor: "end", position: "after" } : { anchor: lastInsertId, position: "after" };
+    const anchor = insertAnchor();
     ops.push({
       action: "insert",
       type: "image",
@@ -38954,15 +39437,11 @@ function compileMarkdownDetailed(markdown, options) {
     const walkAlert = (list) => {
       for (const tok of list) {
         const t = tok;
-        if (t.type === "strong" || t.type === "em" || t.type === "codespan") {
-          fail(line2, "rich text inside alerts is out of scope", "move bold, italic, or code into a body paragraph");
-        }
         if (t.type === "link") {
           const raw = t.raw;
           if (typeof raw === "string" && raw.startsWith("<")) {
             fail(line2, "raw HTML is out of scope in an alert", "use plain Markdown blocks instead of HTML tags");
           }
-          fail(line2, "links inside alerts are out of scope", "move the link into a body paragraph");
         }
         if (t.type === "image") {
           fail(line2, "images are out of scope in an alert", "put images on their own block line instead");
@@ -38980,7 +39459,7 @@ function compileMarkdownDetailed(markdown, options) {
     if (alertTokens) walkAlert(alertTokens);
   };
   const handleAlertBlockquote = (token, line2) => {
-    const inner = token.tokens ?? [];
+    const inner = (token.tokens ?? []).filter((child) => child.type !== "space");
     if (inner.length === 0) {
       fail(line2, "blockquotes are out of scope", "use a plain paragraph");
     }
@@ -39006,6 +39485,7 @@ ${rest}` : sameLineBody;
     }
     const restLines = rest.split("\n");
     let title;
+    let titleSegments;
     let bodySrc = rest;
     if (restLines.length > 0 && ALERT_TITLE_PATTERN.test(restLines[0].trim())) {
       const innerTitle = (ALERT_TITLE_PATTERN.exec(restLines[0].trim())?.[1] ?? "").trim();
@@ -39028,6 +39508,22 @@ ${rest}` : sameLineBody;
       CITATION_REF_PATTERN.lastIndex = 0;
       title = innerTitle;
       bodySrc = restLines.slice(1).join("\n");
+      let titleTokens;
+      try {
+        titleTokens = lexMarkdown(restLines[0].trim(), { dollarMath: options?.dollarMath });
+      } catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw toError("E_VALIDATION", `line ${line2}: alert title rejected (${detail})`, "keep the alert title to one line of inline text");
+      }
+      const titleBlocks = titleTokens.filter((t) => t.type !== "space");
+      if (titleBlocks.length !== 1 || titleBlocks[0].type !== "paragraph") {
+        fail(line2, `alert [!${alertType}] title must be one line of inline text`, "keep the title to one bold line");
+      }
+      const titleInlineTokens = titleBlocks[0].tokens;
+      failOnSpanTokensInAlert(titleInlineTokens, line2);
+      const parsedTitle = parseInlineTokens(titleInlineTokens, line2, "an alert title", citationDefs, citationOrder, citationNum, usedCitations);
+      title = parsedTitle.plainText.length > 0 ? parsedTitle.plainText : innerTitle;
+      titleSegments = parsedTitle.segments;
     }
     for (const bodyLine of bodySrc.split("\n")) {
       if (CONTAINER_FENCE_PATTERN.test(bodyLine)) {
@@ -39048,6 +39544,7 @@ ${rest}` : sameLineBody;
       throw toError("E_VALIDATION", `line ${line2}: alert body rejected (${detail})`, "keep alert bodies plain text");
     }
     const cleanParas = [];
+    const bodySegments = [];
     for (const bodyToken of bodyTokens) {
       if (bodyToken.type === "space") continue;
       if (bodyToken.type !== "paragraph") {
@@ -39063,31 +39560,214 @@ ${rest}` : sameLineBody;
       FOOTNOTE_REF_PATTERN.lastIndex = 0;
       failOnImageOrHtml(paraText2, paraLine, "an alert");
       failOnSpanTokensInAlert(para.tokens, paraLine);
-      cleanParas.push(plainJoin(replaceCitationsInPlainCell(paraText2, paraLine)));
+      const parsedPara = parseInlineTokens(para.tokens, paraLine, "an alert", citationDefs, citationOrder, citationNum, usedCitations);
+      if (parsedPara.footnoteRefs.length > 0) {
+        fail(paraLine, "footnote markers inside alerts are out of scope", "move the note reference into a body paragraph");
+      }
+      for (const key of parsedPara.citationKeys) usedCitations.add(key);
+      if (cleanParas.length > 0) bodySegments.push({ text: " ", bold: false, italic: false, code: false });
+      bodySegments.push(...parsedPara.segments);
+      cleanParas.push(parsedPara.plainText);
     }
     const text2 = plainJoin(cleanParas.join(" "));
     if (text2.length === 0) {
       fail(line2, `alert [!${alertType}] needs body text`, "write the alert text on > lines after the marker");
     }
-    const anchorId = lastInsertId === null ? "end" : lastInsertId;
+    const calloutAnchor = insertAnchor();
     const alertTag = alertType.toLowerCase();
     const tagThemeRaw = styleGuide?.callouts?.tagThemes?.[alertTag];
     const tagTheme = typeof tagThemeRaw === "string" && tagThemeRaw.length > 0 ? tagThemeRaw : void 0;
     const guideThemeRaw = styleGuide?.callouts?.defaultTheme;
     const guideTheme = typeof guideThemeRaw === "string" && guideThemeRaw.length > 0 ? guideThemeRaw : void 0;
+    const calloutId = nextId();
     const op = {
       action: "callout",
-      anchor: anchorId,
-      position: "after",
+      id: calloutId,
+      anchor: calloutAnchor.anchor,
+      position: calloutAnchor.position,
       text: text2,
       theme: tagTheme ?? guideTheme ?? ALERT_TYPE_TO_THEME[alertType] ?? "indigo"
     };
     if (title !== void 0) op["title"] = title;
+    const spanParams = {};
+    if (titleSegments !== void 0 && segmentsNeedSplit(titleSegments)) spanParams["mdTitleSpans"] = titleSegments;
+    if (segmentsNeedSplit(bodySegments)) spanParams["mdBodySpans"] = bodySegments;
+    if (Object.keys(spanParams).length > 0) op["params"] = spanParams;
     ops.push(op);
-    lastInsertId = null;
+    lastInsertId = calloutId;
   };
   let underTitle = false;
   let lastBlockKind = "none";
+  const compileList = (token, line2, quoteLevel = 0) => {
+    const listType = token.ordered === true ? "numbered" : "bullet";
+    const items = token.items ?? [];
+    if (items.length === 0) {
+      fail(line2, "empty list block", "add at least one list item");
+    }
+    const itemIds = [];
+    const itemBaseLine = line2;
+    for (const item of items) {
+      const itemLine = subLine(token.raw, itemBaseLine, item.raw);
+      if (item.task === true) {
+        fail(itemLine, "task-list items are out of scope", "use a plain bullet or numbered item");
+      }
+      for (const child of item.tokens ?? []) {
+        if (child.type === "list") {
+          const nestedRaw = child.raw;
+          const nestedLine = typeof nestedRaw === "string" && nestedRaw ? subLine(token.raw, itemBaseLine, nestedRaw) : itemLine;
+          fail(nestedLine, "nested lists are out of scope", "flatten nested items into the top-level list");
+        }
+        if (child.type !== "text" && child.type !== "paragraph" && child.type !== "space") {
+          fail(itemLine, `list items carry ${child.type} blocks, out of scope`, "keep list items plain text");
+        }
+      }
+      if (item.text.split("\n").some((entry) => FOOTNOTE_DEF_PATTERN.test(entry))) {
+        fail(itemLine, "footnote definition must stand alone as its own block", "move the definition out of the list");
+      }
+      if (item.text.split("\n").some((entry) => CITATION_DEF_PATTERN.test(entry))) {
+        fail(itemLine, "citation definition must stand alone as its own block", "move the definition out of the list");
+      }
+      failOnImageOrHtml(item.text, itemLine, "a list item");
+      const firstChild = (item.tokens ?? [])[0];
+      const inlineTokens = firstChild?.tokens ?? [];
+      if (inlineTokens.length === 1 && inlineTokens[0].type === "image") {
+        fail(itemLine, "images are out of scope in a list item", "put images on their own block line instead of inside a list");
+      }
+      for (const it of inlineTokens) {
+        if (it.type === "image") {
+          fail(itemLine, "images are out of scope in a list item", "put images on their own block line instead of inside a list");
+        }
+      }
+      const inline = parseInlineTokens(inlineTokens, itemLine, "a list item", citationDefs, citationOrder, citationNum, usedCitations);
+      for (const key of inline.citationKeys) usedCitations.add(key);
+      for (const label of inline.footnoteRefs) {
+        if (!defs.has(label)) {
+          fail(itemLine, `undefined footnote reference [^${label}]`, "add a matching [^label]: body definition");
+        }
+      }
+      const id = pushInsertParagraph(inline.plainText, inline.segments);
+      trackRefs(id, inline.footnoteEntries ?? inline.footnoteRefs, itemLine);
+      itemIds.push(id);
+    }
+    ops.push({ action: "list", operation: "create", target: itemIds, listType });
+    if (lastBlockKind === "table" && itemIds.length > 0) {
+      ops.push({ action: "style", target: itemIds[0], spacingBefore: 240 });
+    }
+    if (quoteLevel > 0) {
+      for (const itemId of itemIds) {
+        ops.push({ action: "namedStyle", operation: "apply", styleName: "Quote", target: itemId });
+        ops.push({ action: "style", target: itemId, indentLeft: quoteLevel * QUOTE_INDENT + QUOTE_LIST_INDENT, indentHanging: QUOTE_LIST_INDENT });
+      }
+    }
+  };
+  const compileCode = (token, line2, quoteLevel = 0) => {
+    const lang = (token.lang ?? "").trim();
+    if (CHART_FENCE_LANGUAGES.has(lang.toLowerCase())) {
+      fail(line2, `fenced code tagged '${lang}' requests a chart`, "describe the chart with a chart path reference instead");
+    }
+    const id = nextId();
+    const anchor = insertAnchor();
+    ops.push({
+      action: "insert",
+      type: "paragraph",
+      anchor: anchor.anchor,
+      position: anchor.position,
+      text: token.text ?? "",
+      id,
+      params: { codeBlock: true, ...lang ? { codeLanguage: lang } : {} }
+    });
+    lastInsertId = id;
+    if (lastBlockKind === "table") {
+      ops.push({ action: "style", target: id, spacingBefore: 240 });
+    }
+    if (quoteLevel > 0) {
+      ops.push({ action: "style", target: id, indentLeft: quoteLevel * QUOTE_INDENT + CODE_BLOCK_BASE_INDENT });
+    }
+  };
+  const compileQuote = (token, line2, level) => {
+    const effective = Math.min(level, QUOTE_MAX_LEVEL);
+    if (level > QUOTE_MAX_LEVEL) {
+      warnings.push(`line ${line2}: quote nesting deeper than ${QUOTE_MAX_LEVEL} levels was written at level ${QUOTE_MAX_LEVEL}.`);
+    }
+    const children2 = (token.tokens ?? []).filter((child) => child.type !== "space");
+    if (children2.length === 0) {
+      fail(line2, "blockquote is empty", "write the quote text after the > marker");
+    }
+    const strippedRaw = token.raw.split("\n").map((entry) => entry.replace(/^ {0,3}>[ ]?/, "")).join("\n");
+    for (const child of children2) {
+      const childRaw = child.raw ?? "";
+      const childLine = subLine(strippedRaw, line2, childRaw.split("\n")[0] ?? "");
+      switch (child.type) {
+        case "paragraph": {
+          const para = child;
+          const paraText2 = para.text ?? "";
+          const paraLines = childRaw.replace(/\n+$/, "").split("\n");
+          if (paraLines.some((entry) => FOOTNOTE_DEF_PATTERN.test(entry) || CITATION_DEF_PATTERN.test(entry))) {
+            fail(childLine, "note and citation definitions must stand alone as their own block", "move the definition out of the quote");
+          }
+          if (CONTAINER_FENCE_PATTERN.test(paraLines[0] ?? "")) {
+            fail(childLine, "container fences (:::) are out of scope as custom styles", "use plain Markdown blocks");
+          }
+          const paraTokens = para.tokens ?? [];
+          for (const it of paraTokens) {
+            if (it.type === "image") {
+              fail(childLine, "images are out of scope in a quote", "put images on their own block line after the quote");
+            }
+          }
+          failOnImageOrHtml(paraText2, childLine, "a quote");
+          const inline = parseInlineTokens(para.tokens, childLine, "a quote", citationDefs, citationOrder, citationNum, usedCitations);
+          for (const key of inline.citationKeys) usedCitations.add(key);
+          for (const label of inline.footnoteRefs) {
+            if (!defs.has(label)) {
+              fail(childLine, `undefined footnote reference [^${label}]`, "add a matching [^label]: body definition");
+            }
+          }
+          const id = pushInsertParagraph(inline.plainText, inline.segments);
+          trackRefs(id, inline.footnoteEntries ?? inline.footnoteRefs, childLine);
+          ops.push({ action: "namedStyle", operation: "apply", styleName: "Quote", target: id });
+          if (effective > 1) {
+            ops.push({ action: "style", target: id, indentLeft: effective * QUOTE_INDENT });
+          }
+          if (lastBlockKind === "table") {
+            ops.push({ action: "style", target: id, spacingBefore: 240 });
+          }
+          lastBlockKind = "quote";
+          underTitle = false;
+          break;
+        }
+        case "blockquote":
+          compileQuote(child, childLine, level + 1);
+          break;
+        case "list":
+          compileList(child, childLine, effective);
+          lastBlockKind = "list";
+          break;
+        case "code":
+          compileCode(child, childLine, effective);
+          lastBlockKind = "code";
+          break;
+        case "table":
+          fail(childLine, "tables inside a quote are out of scope", "Word cannot indent a table as a quote: put the table after the quote");
+          break;
+        case "heading":
+          fail(childLine, "headings inside a quote are out of scope", "put the heading before the quote");
+          break;
+        default:
+          fail(childLine, `${child.type} blocks inside a quote are out of scope`, "keep quotes to paragraphs, flat lists and code blocks");
+      }
+    }
+  };
+  const quoteOpensWithAlertMarker = (token, line2) => {
+    const first = (token.tokens ?? []).find((child) => child.type !== "space");
+    if (!first || first.type !== "paragraph") return false;
+    const head = (first.text ?? "").split("\n")[0]?.trim() ?? "";
+    if (ALERT_MARKER_PATTERN.test(head)) return true;
+    const unknown = /^\[!([A-Za-z][A-Za-z0-9_-]*)\]/.exec(head);
+    if (unknown) {
+      fail(line2, `unknown alert type [!${unknown[1]}]`, "use NOTE, TIP, IMPORTANT, WARNING or CAUTION, or drop the [!...] marker for a plain quote");
+    }
+    return false;
+  };
   for (const rawToken of tokens) {
     const token = rawToken;
     const line2 = lineOf.get(rawToken) ?? 1;
@@ -39197,60 +39877,7 @@ ${rest}` : sameLineBody;
         break;
       }
       case "list": {
-        const listType = token.ordered === true ? "numbered" : "bullet";
-        const items = token.items ?? [];
-        if (items.length === 0) {
-          fail(line2, "empty list block", "add at least one list item");
-        }
-        const itemIds = [];
-        const itemBaseLine = line2;
-        for (const item of items) {
-          const itemLine = subLine(token.raw, itemBaseLine, item.raw);
-          if (item.task === true) {
-            fail(itemLine, "task-list items are out of scope", "use a plain bullet or numbered item");
-          }
-          for (const child of item.tokens ?? []) {
-            if (child.type === "list") {
-              const nestedRaw = child.raw;
-              const nestedLine = typeof nestedRaw === "string" && nestedRaw ? subLine(token.raw, itemBaseLine, nestedRaw) : itemLine;
-              fail(nestedLine, "nested lists are out of scope", "flatten nested items into the top-level list");
-            }
-            if (child.type !== "text" && child.type !== "paragraph" && child.type !== "space") {
-              fail(itemLine, `list items carry ${child.type} blocks, out of scope`, "keep list items plain text");
-            }
-          }
-          if (item.text.split("\n").some((entry) => FOOTNOTE_DEF_PATTERN.test(entry))) {
-            fail(itemLine, "footnote definition must stand alone as its own block", "move the definition out of the list");
-          }
-          if (item.text.split("\n").some((entry) => CITATION_DEF_PATTERN.test(entry))) {
-            fail(itemLine, "citation definition must stand alone as its own block", "move the definition out of the list");
-          }
-          failOnImageOrHtml(item.text, itemLine, "a list item");
-          const firstChild = (item.tokens ?? [])[0];
-          const inlineTokens = firstChild?.tokens ?? [];
-          if (inlineTokens.length === 1 && inlineTokens[0].type === "image") {
-            fail(itemLine, "images are out of scope in a list item", "put images on their own block line instead of inside a list");
-          }
-          for (const it of inlineTokens) {
-            if (it.type === "image") {
-              fail(itemLine, "images are out of scope in a list item", "put images on their own block line instead of inside a list");
-            }
-          }
-          const inline = parseInlineTokens(inlineTokens, itemLine, "a list item", citationDefs, citationOrder, citationNum, usedCitations);
-          for (const key of inline.citationKeys) usedCitations.add(key);
-          for (const label of inline.footnoteRefs) {
-            if (!defs.has(label)) {
-              fail(itemLine, `undefined footnote reference [^${label}]`, "add a matching [^label]: body definition");
-            }
-          }
-          const id = pushInsertParagraph(inline.plainText, inline.segments);
-          trackRefs(id, inline.footnoteEntries ?? inline.footnoteRefs, itemLine);
-          itemIds.push(id);
-        }
-        ops.push({ action: "list", operation: "create", target: itemIds, listType });
-        if (lastBlockKind === "table" && itemIds.length > 0) {
-          ops.push({ action: "style", target: itemIds[0], spacingBefore: 240 });
-        }
+        compileList(token, line2);
         lastBlockKind = "list";
         break;
       }
@@ -39363,25 +39990,7 @@ ${rest}` : sameLineBody;
         break;
       }
       case "code": {
-        const lang = (token.lang ?? "").trim();
-        if (CHART_FENCE_LANGUAGES.has(lang.toLowerCase())) {
-          fail(line2, `fenced code tagged '${lang}' requests a chart`, "describe the chart with a chart path reference instead");
-        }
-        const id = nextId();
-        const anchor = insertAnchor();
-        ops.push({
-          action: "insert",
-          type: "paragraph",
-          anchor: anchor.anchor,
-          position: anchor.position,
-          text: token.text ?? "",
-          id,
-          params: { codeBlock: true, ...lang ? { codeLanguage: lang } : {} }
-        });
-        lastInsertId = id;
-        if (lastBlockKind === "table") {
-          ops.push({ action: "style", target: id, spacingBefore: 240 });
-        }
+        compileCode(token, line2);
         lastBlockKind = "code";
         break;
       }
@@ -39400,8 +40009,12 @@ ${rest}` : sameLineBody;
         fail(line2, "raw HTML blocks are out of scope", "use plain Markdown blocks instead of HTML tags");
         break;
       case "blockquote":
-        handleAlertBlockquote(token, line2);
-        lastBlockKind = "callout";
+        if (quoteOpensWithAlertMarker(token, line2)) {
+          handleAlertBlockquote(token, line2);
+          lastBlockKind = "callout";
+        } else {
+          compileQuote(token, line2, 1);
+        }
         break;
       case "image": {
         const img = token;
@@ -39485,107 +40098,15 @@ ${rest}` : sameLineBody;
 }
 
 // ../engine/src/compose/markdown.ts
-function pristineTemplateSeedIds(parser2, requestedTemplate) {
-  if (!parser2.hasPristineBuiltinSeed()) return null;
-  let summary;
-  try {
-    summary = parser2.getStructuralSummary();
-  } catch {
-    return null;
-  }
-  const nodes = summary.nodes ?? [];
-  if (![1, 2, 4, 5, 6].includes(nodes.length)) return null;
-  if (summary.hasTrackedChanges === true) return null;
-  if (Object.keys(summary.mediaFiles ?? {}).length > 0) return null;
-  if ((summary.headers ?? []).length > 0) return null;
-  if ((summary.footers ?? []).length > 0) return null;
-  if ((summary.charts ?? []).length > 0) return null;
-  try {
-    const zip = parser2.getZipAdapter?.();
-    if (typeof zip?.hasFile === "function") {
-      for (const part of [
-        "word/footnotes.xml",
-        "word/endnotes.xml",
-        "word/comments.xml",
-        "word/commentsExtended.xml"
-      ]) {
-        try {
-          if (zip.hasFile(part)) return null;
-        } catch {
-          return null;
-        }
-      }
-    } else {
-      return null;
-    }
-  } catch {
-    return null;
-  }
-  for (const n of nodes) {
-    if (n.hasTrackedChanges === true) return null;
-    const raw = n.rawXml ?? "";
-    if (raw.includes("w:footnoteReference") || raw.includes("w:endnoteReference") || raw.includes("w:commentReference") || raw.includes("w:commentRangeStart") || raw.includes("w:commentRangeEnd")) {
-      return null;
-    }
-  }
-  const ids = nodes.map((n) => n.id ?? "").filter((id) => id.length > 0);
-  if (ids.length !== nodes.length) return null;
-  if (nodes.length === 1) {
-    const node = nodes[0];
-    if (node.type !== "paragraph") return null;
-    if ((node.text ?? "").trim() !== "") return null;
-    return ids;
-  }
-  if (nodes.length === 2) {
-    const [first, second] = nodes;
-    const t0 = (first.text ?? "").trim();
-    const t1 = (second.text ?? "").trim();
-    if (t0 === BLANK_SEED_TITLE && t1 === BLANK_SEED_HINT) {
-      const firstRaw = first.rawXml ?? "";
-      const secondRaw = second.rawXml ?? "";
-      if (!firstRaw.includes('w:val="Title"') || !secondRaw.includes('w:val="Subtitle"')) return null;
-      return ids;
-    }
-    const tmpl = requestedTemplate?.toLowerCase();
-    if (t0 === "MEMORANDUM" && tmpl === "memo") return ids;
-    if (t0 === "Letter" && tmpl === "letter") return ids;
-    if (t0 === "Proposal" && tmpl === "proposal") return ids;
-    if (t0 === "INVOICE" && tmpl === "invoice") return ids;
-    return null;
-  }
-  if (nodes.length === 4) {
-    const t0 = (nodes[0].text ?? "").trim();
-    const tmpl = requestedTemplate?.toLowerCase();
-    if (t0 === "Research Benchmark Report" && tmpl === "research") return ids;
-    if (t0 === "Corporate Strategy Roadmap" && tmpl === "corporate") return ids;
-    if (t0 === "Velocity Audit & Performance" && tmpl === "bar-chart-3d") return ids;
-    return null;
-  }
-  if (nodes.length === 5) {
-    const t0 = (nodes[0].text ?? "").trim();
-    const tmpl = requestedTemplate?.toLowerCase();
-    if (t0 === "Financial Report & Audit" && tmpl === "financial") return ids;
-    return null;
-  }
-  if (nodes.length === 6) {
-    const t0 = (nodes[0].text ?? "").trim();
-    const t2 = (nodes[2].text ?? "").trim();
-    const tmpl = requestedTemplate?.toLowerCase();
-    if (t0 === "Q3 Executive Financial Performance Report" && t2 === "1. Executive Summary") {
-      if (tmpl === "report") return ids;
-      return null;
-    }
-    if (t0 === "Manuscript Title" && t2 === "Chapter 1: The Beginning" && tmpl === "novel") {
-      return ids;
-    }
-    if (t0 === "Neural Document Architectures: A Comparative Benchmark" && tmpl === "academic") {
-      return ids;
-    }
-    if (t0 === "TECH HORIZONS" && tmpl === "newsletter") return ids;
-    if (t0 === "Platform Core API Reference" && (tmpl === "api" || tmpl === "api-spec")) return ids;
-    return null;
-  }
-  return null;
+function nextComposeIdPrefix(ast) {
+  const live = /* @__PURE__ */ new Set();
+  for (const section of ast.sections ?? []) for (const node of section.nodes ?? []) live.add(node.id);
+  const used = (prefix) => {
+    for (const id of live) if (id.startsWith(`${prefix}_`)) return true;
+    return false;
+  };
+  if (!used("md")) return "md";
+  for (let n = 2; ; n++) if (!used(`md${n}`)) return `md${n}`;
 }
 var pristineBlankSeedIds = pristineTemplateSeedIds;
 function assertTemplateSeed(parser2, template) {
@@ -39629,15 +40150,26 @@ function assertTemplateSeed(parser2, template) {
 function applyInlineSpans(parser2, ast, operations) {
   const docParser = parser2;
   const liveAst = ast;
+  const targets = [];
   for (const op of operations) {
     const rec = op;
-    if (rec["action"] !== "insert" || rec["type"] !== "paragraph") continue;
     const params = rec["params"];
-    const rawSpans = params?.["mdSpans"];
-    if (!Array.isArray(rawSpans) || !segmentsNeedSplit(rawSpans)) continue;
-    const spans = rawSpans;
     const id = String(rec["id"] ?? "");
     if (!id) continue;
+    if (rec["action"] === "callout") {
+      const titleSpans = params?.["mdTitleSpans"];
+      const bodySpans = params?.["mdBodySpans"];
+      if (Array.isArray(titleSpans) && segmentsNeedSplit(titleSpans)) targets.push({ id, spans: titleSpans, part: "calloutTitle" });
+      if (Array.isArray(bodySpans) && segmentsNeedSplit(bodySpans)) targets.push({ id, spans: bodySpans, part: "calloutBody" });
+      continue;
+    }
+    if (rec["action"] !== "insert" || rec["type"] !== "paragraph") continue;
+    const rawSpans = params?.["mdSpans"];
+    if (!Array.isArray(rawSpans) || !segmentsNeedSplit(rawSpans)) continue;
+    targets.push({ id, spans: rawSpans, part: "paragraph" });
+  }
+  for (const target of targets) {
+    const { id, spans, part } = target;
     let node;
     for (const section of liveAst.sections) {
       const found = section.nodes.find((n) => n.id === id);
@@ -39651,7 +40183,18 @@ function applyInlineSpans(parser2, ast, operations) {
         `E_VALIDATION: line 1: span target paragraph '${id}' is missing after compose. Remedy: retry the compose without manual edits in between.`
       );
     }
-    const para = node.xml;
+    let para = node.xml;
+    let baseRPr;
+    if (part !== "paragraph") {
+      const cellParas = Array.from(para.getElementsByTagName("w:p"));
+      const hasTitle = cellParas.length > 1;
+      const picked = part === "calloutTitle" ? hasTitle ? cellParas[0] : void 0 : cellParas[cellParas.length - 1];
+      if (!picked) continue;
+      para = picked;
+      const firstRun = Array.from(para.childNodes).find((k) => k.nodeType === 1 && k.tagName === "w:r");
+      const rPrEl = firstRun ? Array.from(firstRun.childNodes).find((k) => k.nodeType === 1 && k.tagName === "w:rPr") : void 0;
+      baseRPr = rPrEl ? rPrEl : void 0;
+    }
     const doc = para.ownerDocument;
     if (!doc) continue;
     const keptFootRefs = [];
@@ -39683,10 +40226,12 @@ function applyInlineSpans(parser2, ast, operations) {
     }
     const buildRun = (seg) => {
       const run2 = createWordElement(doc, "w:r");
-      const needsRPr = seg.bold || seg.italic || seg.strike || seg.code || seg.linkUrl !== void 0;
+      const needsRPr = seg.bold || seg.italic || seg.strike || seg.code || seg.linkUrl !== void 0 || baseRPr !== void 0;
       if (needsRPr) {
         const rPr = createWordElement(doc, "w:rPr");
-        if (seg.bold) rPr.appendChild(createWordElement(doc, "w:b"));
+        const baseBold = baseRPr !== void 0 && baseRPr.getElementsByTagName("w:b").length > 0;
+        const baseColor = baseRPr?.getElementsByTagName("w:color")[0]?.getAttribute("w:val") ?? void 0;
+        if (seg.bold || baseBold) rPr.appendChild(createWordElement(doc, "w:b"));
         if (seg.italic) rPr.appendChild(createWordElement(doc, "w:i"));
         if (seg.strike) rPr.appendChild(createWordElement(doc, "w:strike"));
         if (seg.code) {
@@ -39695,6 +40240,11 @@ function applyInlineSpans(parser2, ast, operations) {
           rFonts.setAttribute("w:hAnsi", COMPOSE_CODE_FONT);
           rPr.appendChild(rFonts);
         }
+        if (seg.linkUrl === void 0 && baseColor) {
+          const color = createWordElement(doc, "w:color");
+          color.setAttribute("w:val", baseColor);
+          rPr.appendChild(color);
+        }
         if (seg.linkUrl !== void 0) {
           const color = createWordElement(doc, "w:color");
           color.setAttribute("w:val", "0066CC");
@@ -39780,35 +40330,76 @@ function applyInlineSpans(parser2, ast, operations) {
     );
     for (let i = 0; i < refSibs.length; i++) {
       const refEl = refSibs[i];
-      const op2 = noteOps[i];
-      insertRunAtOffset(para, refEl, op2?.offset);
+      const op = noteOps[i];
+      insertRunAtOffset(para, refEl, op?.offset);
     }
     node.version += 1;
   }
 }
+function validateComposedOperations(operations) {
+  validateOperationsStrict(
+    operations.map((op) => {
+      const rec = op;
+      const params = rec["params"];
+      if (rec["action"] !== "callout" || !params) return op;
+      const { mdTitleSpans: _t, mdBodySpans: _b, ...publicParams } = params;
+      void _t;
+      void _b;
+      const { params: _p, ...rest } = rec;
+      void _p;
+      return Object.keys(publicParams).length > 0 ? { ...rest, params: publicParams } : rest;
+    })
+  );
+}
 async function composeDocument(parser2, markdown, options) {
   if (!parser2 || typeof parser2.getAST !== "function") {
     throw new Error(
       "E_VALIDATION: line 1: composeDocument needs an open document parser. Remedy: open a document first, then compose into it."
     );
   }
+  const liveAst = await parser2.getAST();
+  const idPrefix = options?.idPrefix ?? nextComposeIdPrefix(liveAst);
   if (options?.template !== void 0) {
+    if (idPrefix !== "md") {
+      throw new Error(
+        "E_VALIDATION: line 1: template is accepted only on the first compose of a document. Remedy: omit template on this compose; the document already holds composed content."
+      );
+    }
     assertTemplateSeed(parser2, String(options.template));
   }
+  if (options?.position !== void 0 && options.anchor === void 0) {
+    throw new Error(
+      "E_VALIDATION: line 1: position needs an anchor. Remedy: pass anchor (a node id, start or end) together with position, or omit position to append at the end."
+    );
+  }
+  if (options?.anchor !== void 0 && anchorAliasOf(options.anchor) === null) {
+    const known = liveAst.sections.some((section) => section.nodes.some((node) => node.id === options.anchor));
+    if (!known) {
+      throw new Error(
+        `E_VALIDATION: line 1: anchor '${options.anchor}' is not a node of this document. Remedy: pass a node id from inspect_document, or start or end.`
+      );
+    }
+  }
   const styleGuide = resolveComposeStyleGuide(options?.styleGuide);
   const { operations, warnings: compileWarnings } = compileMarkdownDetailed(markdown, {
+    idPrefix,
+    ...options?.anchor !== void 0 ? { anchor: options.anchor } : {},
+    ...options?.position !== void 0 ? { position: options.position } : {},
     allowedDir: options?.allowedDir,
     ...options?.styleGuide !== void 0 ? { styleGuide: options.styleGuide } : {},
     ...options?.dollarMath ? { dollarMath: true } : {}
   });
-  validateOperationsStrict(operations);
+  validateComposedOperations(operations);
+  if (operations.some((op) => op.action === "namedStyle" && op.styleName === QUOTE_STYLE_ID)) {
+    ensureQuoteStyle(parser2.getStylesDom());
+  }
   const chunkSize = options?.chunkSize !== void 0 ? Math.floor(options.chunkSize) : ENGINE_MAX_OPS;
   if (!Number.isInteger(chunkSize) || chunkSize < 1 || chunkSize > ENGINE_MAX_OPS) {
     throw new Error(
       `E_VALIDATION: line 1: chunkSize must be an integer in [1, ${ENGINE_MAX_OPS}]. Remedy: omit chunkSize or pass a value inside that range.`
     );
   }
-  const ast = await parser2.getAST();
+  const ast = liveAst;
   const blankSeedIds = pristineBlankSeedIds(parser2, options?.template);
   let preBatchSnapshot = null;
   try {
@@ -39861,7 +40452,17 @@ async function composeDocument(parser2, markdown, options) {
     }
     base += chunk.length;
   }
-  if (!aggregate.success) return aggregate;
+  if (!aggregate.success) {
+    if (aggregate.appliedCount > 0 && preBatchSnapshot !== null) {
+      try {
+        parser2.restorePackageSnapshot(preBatchSnapshot);
+        aggregate.appliedCount = 0;
+        aggregate.rollbackTriggered = true;
+      } catch {
+      }
+    }
+    return aggregate;
+  }
   if (blankSeedIds !== null) {
     const seedCleanup = await engine.executeBatch({
       operations: [{ action: "delete", target: blankSeedIds }],
@@ -39932,119 +40533,19 @@ async function composeDocument(parser2, markdown, options) {
     if (/^E_VALIDATION/.test(detail)) throw err;
     throw new Error(`E_VALIDATION: line 1: inline formatting failed (${detail}). Remedy: simplify bold, italic, code, or link spans and retry.`);
   }
-  return aggregate;
-}
-
-// ../engine/src/stats.ts
-function nearestOwner(el, tagName) {
-  let cur = el.parentNode;
-  while (cur && typeof cur === "object") {
-    const e = cur;
-    if (e.tagName === tagName) return e;
-    cur = e.parentNode;
-  }
-  return null;
-}
-function tableCellTextSpaced(node) {
-  try {
-    const xml = node.xml;
-    if (!xml || typeof xml.getElementsByTagName !== "function") return void 0;
-    const tcs = xml.getElementsByTagName("w:tc");
-    if (!tcs || tcs.length === 0) return void 0;
-    const cells = [];
-    for (let i = 0; i < tcs.length; i++) {
-      const tc = tcs[i];
-      const paras = tc.getElementsByTagName("w:p");
-      if (paras.length > 0) {
-        const parts = [];
-        for (let p = 0; p < paras.length; p++) {
-          const para = paras[p];
-          if (nearestOwner(para, "w:tc") !== tc) continue;
-          const runs = para.getElementsByTagName("w:t");
-          let t = "";
-          for (let r = 0; r < runs.length; r++) {
-            const run2 = runs[r];
-            if (nearestOwner(run2, "w:tc") !== tc) continue;
-            if (nearestOwner(run2, "w:p") !== para) continue;
-            t += run2.textContent || "";
-          }
-          if (t.trim().length > 0) parts.push(t.trim());
-        }
-        if (parts.length > 0) cells.push(parts.join(" "));
-      } else {
-        const runs = tc.getElementsByTagName("w:t");
-        let t = "";
-        for (let r = 0; r < runs.length; r++) {
-          const run2 = runs[r];
-          if (nearestOwner(run2, "w:tc") !== tc) continue;
-          t += run2.textContent || "";
-        }
-        if (t.trim().length > 0) cells.push(t.trim());
-      }
-    }
-    if (cells.length === 0) return "";
-    return cells.join(" ");
-  } catch {
-    return void 0;
-  }
-}
-function nestedTableCount(node) {
   try {
-    const xml = node.xml;
-    if (!xml || typeof xml.getElementsByTagName !== "function") return 0;
-    return xml.getElementsByTagName("w:tbl").length;
-  } catch {
-    return 0;
-  }
-}
-function countExplicitPageBreaks(node) {
-  if (node.type === "pageBreak") return 1;
-  const text2 = node.metadata?.text || "";
-  let count = text2 === "[Page Break]" ? 1 : 0;
-  try {
-    const xml = node.xml;
-    if (xml && typeof xml.getElementsByTagName === "function") {
-      const brs = xml.getElementsByTagName("w:br");
-      let brCount = 0;
-      for (let i = 0; i < brs.length; i++) {
-        if (brs[i].getAttribute("w:type") === "page") brCount++;
-      }
-      if (brCount > count) count = brCount;
-    }
+    const identity = applyDocumentIdentity(ast, parser2);
+    if (identity.titleSetFrom) aggregate.titleSetFrom = identity.titleSetFrom;
   } catch {
   }
-  return count;
-}
-function computeDocStats(ast) {
-  let words = 0;
-  let paragraphs = 0;
-  let tables = 0;
-  let images = 0;
-  let pageBreaks = 0;
-  for (const sec of ast.sections) {
-    for (const node of sec.nodes) {
-      if (node.type === "paragraph") paragraphs += 1;
-      if (node.type === "table") tables += 1 + nestedTableCount(node);
-      if (node.type === "image") images += 1;
-      pageBreaks += countExplicitPageBreaks(node);
-      let text2 = node.metadata?.text ?? "";
-      if (node.type === "table") {
-        const spaced = tableCellTextSpaced(node);
-        if (spaced !== void 0) text2 = spaced;
-      }
-      const hits = text2.match(/\S+/g);
-      if (hits) words += hits.length;
-    }
-  }
-  const pageBudget = words / 450 + tables * 0.45 + images * 0.5 + pageBreaks;
-  return { words, paragraphs, pages: Math.max(1, Math.ceil(pageBudget)), tables, images };
+  return aggregate;
 }
 
 // ../engine/src/style-guide/resolve.ts
 var import_fs8 = __toESM(require("fs"));
 var import_path7 = __toESM(require("path"));
 function hasScheme(ref) {
-  return /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(ref);
+  return hasUriScheme(ref);
 }
 function failValidation(message, remedy) {
   throw toError("E_VALIDATION", message, remedy);
@@ -40217,7 +40718,7 @@ function summarizeStyleGuide(guide) {
 // package.json
 var package_default = {
   name: "@attentionform/astra",
-  version: "0.3.0",
+  version: "0.4.1",
   description: "Command-line tool for OOXML (.docx) document engineering",
   main: "dist/cli.js",
   types: "dist/packages/cli/src/cli.d.ts",
@@ -40260,8 +40761,8 @@ var package_default = {
     "adm-zip-gate": "node ../../scripts/check-adm-zip-imports.mjs"
   },
   dependencies: {
-    "@attentionform/astra-engine": "^0.3.0",
-    "@attentionform/ooxml-validator": "^0.3.0",
+    "@attentionform/astra-engine": "^0.4.0",
+    "@attentionform/ooxml-validator": "^0.4.1",
     "@xmldom/xmldom": "0.8.15",
     "adm-zip": "0.6.1",
     "isomorphic-git": "^1.25.0",
@@ -40922,9 +41423,9 @@ function commandHelpText(cmd) {
       "                        Supported input: #/##/### headings, blank-line paragraphs, flat bullet/ordered lists,",
       "                        header-row tables, --- dividers, fenced code, [^label] footnotes, inline spans (**bold**,",
       "                        *italic*, `code`, [text](url)) applied as runs with real hyperlink targets, `> [!NOTE]`-style",
-      "                        alert callouts (NOTE|TIP|IMPORTANT|WARNING|CAUTION compile to callout containers), and standalone",
+      "                        alert callouts (NOTE|TIP|IMPORTANT|WARNING|CAUTION compile to callout containers that keep inline formatting), `> quote` blocks (Quote style, nested up to 3 levels), and standalone",
       "                        block images/charts (![alt](path)) resolved from --allowed-dir. Out-of-scope input",
-      "                        (raw HTML, custom styles, plain blockquotes, deeper headings, nested lists/tables,",
+      "                        (raw HTML, custom styles, deeper headings, nested lists/tables,",
       "                        task items) fails closed with E_VALIDATION plus a line number and writes nothing.",
       "                        Subtitle: a line that is only italic (*text*), directly under the opening # title, gets the",
       "                        Subtitle style (the style is already italic, so the emphasis is dropped). For italic body",
@@ -40956,10 +41457,10 @@ function commandHelpText(cmd) {
       "                        Same skinning as create --from-md: tables take headerFill, `> [!TAG]` alerts take the guide",
       "                        defaultTheme, plus chart palette, callout, and code-block defaults where content omits styling.",
       "Supported input: #/##/### headings, blank-line paragraphs, flat bullet/ordered lists,",
-      "  header-row tables, --- dividers, fenced code, [^label] footnotes, `> [!NOTE]`-style alert callouts, inline spans (**bold**,",
+      "  header-row tables, --- dividers, fenced code, [^label] footnotes, `> [!NOTE]`-style alert callouts (inline formatting kept), `> quote` blocks (Quote style, up to 3 levels), inline spans (**bold**,",
       "  *italic*, `code`, [text](url)) applied as runs with real hyperlink targets, and standalone",
       "  block images/charts (![alt](path)) resolved from --allowed-dir. Out-of-scope input",
-      "  (raw HTML, custom styles, plain blockquotes, deeper headings, nested lists/tables,",
+      "  (raw HTML, custom styles, deeper headings, nested lists/tables,",
       "  task items) fails closed with E_VALIDATION plus a line number and writes nothing.",
       "  Subtitle: a line that is only italic (*text*), directly under the opening # title, gets the Subtitle style",
       "  (the style is already italic, so the emphasis is dropped). For italic body text there, put another",
@@ -40970,6 +41471,7 @@ function commandHelpText(cmd) {
       `Usage: ${CLI_NAME} stats <docx> [--allow-macros] [--strip-macros]`,
       "",
       "Print word/paragraph counts plus estimated pages: `STATS <file>: words=N paragraphs=M pages~P (est, 500 wpp)`.",
+      "Also prints `tables=N callouts=N images=N`; a callout (a one-cell filled table, such as a `> [!NOTE]` alert) counts in callouts, not in tables.",
       "  --allow-macros  preserve macro/active-content parts byte-identical (default refuses E_VALIDATION naming the parts)",
       "  --strip-macros  remove macro/active-content parts and continue (never with --allow-macros)",
       "Recipe: words count body paragraph text (non-whitespace tokens) plus table cell text (cells joined with spaces).",
@@ -42373,6 +42875,10 @@ async function runBatchJob(out, ctx) {
     const backupCode = await ensureBackupCopy(out, file, docx, target, ctx.backupState);
     if (backupCode !== void 0) return backupCode;
     const gateNormalized = skipValidate ? [] : readParserNormalizations(parser2);
+    try {
+      applyDocumentIdentity(ast, parser2);
+    } catch {
+    }
     const finalBytes = parser2.rezip({ reproducible: ctx.reproducible });
     const batchNormalized = mergeNormalized(readEngineNormalized(res), gateNormalized, readParserNormalizations(parser2));
     if (dupPreState && batchNormalized.some((l) => l.startsWith("Renumbered duplicate"))) {
@@ -42630,6 +43136,10 @@ async function runStreamSession(out, docx, opts, lines, emit) {
           remedy: `name the output "${path13.basename(target)}" with a .docm extension, or add --strip-macros to remove the macro parts`
         };
       }
+      try {
+        applyDocumentIdentity(await parser2.getAST(), parser2);
+      } catch {
+      }
       const finalBytes = parser2.rezip({ reproducible });
       await writeDocx(target, finalBytes);
       lastWritten = finalBytes;
@@ -44790,8 +45300,9 @@ async function cmdStats(out, args) {
     const ast = await parser2.getAST();
     const stats = computeDocStats(ast);
     print(out, `STATS ${file}: words=${stats.words} paragraphs=${stats.paragraphs} pages~${stats.pages} (est, 500 wpp)`);
+    print(out, `tables=${stats.tables} callouts=${stats.callouts} images=${stats.images} (a callout is a one-cell filled table and is not counted in tables)`);
     print(out, `recipe: body paragraphs + table cells; excludes headers/footers/footnotes/comments; pages~P rough estimate = max(1, ceil(words/500))`);
-    printJson(out, { ok: true, file, words: stats.words, paragraphs: stats.paragraphs, pages: stats.pages });
+    printJson(out, { ok: true, file, words: stats.words, paragraphs: stats.paragraphs, pages: stats.pages, tables: stats.tables, callouts: stats.callouts, images: stats.images });
     return EXIT_OK;
   } catch (err) {
     return failHuman(out, err, { file, fallbackCode: "E_VALIDATION" });
@@ -45323,6 +45834,10 @@ async function run(argv) {
 
 // src/cli.ts
 function isDirectEntry() {
+  try {
+    if (typeof require !== "undefined" && typeof module !== "undefined" && require.main === module) return true;
+  } catch {
+  }
   const entry = process.argv?.[1] ?? "";
   return entry.endsWith("packages/cli/src/cli.ts") || entry.includes("packages/cli/dist/") || /(^|[/\\])astra$/.test(entry);
 }