@ingcreators/annot-product-docs-xlsx 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @ingcreators/annot-product-docs-xlsx
 
+## 0.2.2
+
+### Patch Changes
+
+- Updated dependencies [b5d52f6]
+- Updated dependencies [fa712fd]
+- Updated dependencies [f09a6b1]
+- Updated dependencies [0d19345]
+  - @ingcreators/annot-product-docs@0.4.0
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/extract.d.ts

@@ -1,4 +1,4 @@
-import { AnnotFrontmatter, HistoryEntrySpec, OverlaySpec, ParsedMdx } from '@ingcreators/annot-product-docs';
+import { AnnotationsFile, AnnotFrontmatter, HistoryEntrySpec, OverlaySpec, ParsedMdx } from '@ingcreators/annot-product-docs';
 export interface ExcelMdxBundle {
     /** Absolute or cwd-relative path to the source `.mdx` file. */
     mdxPath: string;
@@ -34,15 +34,43 @@ export interface NormalisedOverlay {
     /** Markdown body — caller renders to rich text. */
     body: string;
 }
+/**
+ * Optional context for {@link extractFromParsed}. Phase 3d of
+ * `docs/plans/living-spec-authoring-roadmap.md`. When a `<Screen>`
+ * carries `annotations="…"`, the row generator wants the resolved
+ * yaml content — but we don't want `extractFromParsed` to do file
+ * I/O. The caller (`extractMdxFile`) pre-loads + parses each yaml
+ * keyed by the `annotations` path (relative to the MDX) and passes
+ * the map here. When the map is missing an entry (or this context
+ * isn't supplied), the extractor falls back to the legacy inline
+ * `<Overlay>` rows for that screen.
+ *
+ * `annotations[]` entries in the yaml are deliberately NOT
+ * surfaced as rows — they're image-only visual marking. The
+ * Astro Image Service composes them onto the PNG; the Excel
+ * adapter renders the resulting image in the spreadsheet's
+ * picture column and the items table stays scoped to overlays.
+ */
+export interface ExtractFromParsedOptions {
+    /** Pre-loaded annotation yaml content keyed by the screen's `annotations` value. */
+    annotationsYamlByPath?: ReadonlyMap<string, AnnotationsFile>;
+}
 /**
  * Extract a normalised bundle from a parsed MDX. Used directly
  * by `extractMdxFile` and re-exposed so tests can drive it
  * without filesystem I/O.
  */
-export declare function extractFromParsed(parsed: ParsedMdx, mdxPath: string): ExcelMdxBundle;
+export declare function extractFromParsed(parsed: ParsedMdx, mdxPath: string, options?: ExtractFromParsedOptions): ExcelMdxBundle;
 /**
  * Convenience: parse the MDX file and normalise. Returns `null`
  * for files without `annot:` frontmatter so the bulk-extract
  * caller can keep its glob noise-free.
+ *
+ * Phase 3d: when the MDX contains `<Screen annotations="…">`
+ * blocks, the matching yaml files are loaded + parsed from disk
+ * before {@link extractFromParsed} runs. Missing yaml files are
+ * a loud failure (`throw`) — the same behaviour the Astro Image
+ * Service uses, on the same "explicit reference, but file gone"
+ * reasoning.
  */
 export declare function extractMdxFile(mdxPath: string): Promise<ExcelMdxBundle | null>;

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { CliOptions } from './cli.js';
 export { main, main as cliMain } from './cli.js';
 export type { ApplyDefaultLayoutInput } from './default-layout.js';
 export { applyDefaultLayout, sanitiseSheetName, sortBundlesForLayout, } from './default-layout.js';
-export type { ExcelMdxBundle, NormalisedOverlay, NormalisedScreen, } from './extract.js';
+export type { ExcelMdxBundle, ExtractFromParsedOptions, NormalisedOverlay, NormalisedScreen, } from './extract.js';
 export { extractFromParsed, extractMdxFile } from './extract.js';
 export type { NamedRangeWriteInput } from './named-range.js';
 export { applyNamedRanges } from './named-range.js';

package/dist/index.js

@@ -1,46 +1,46 @@
-import { mkdir as e, readdir as t, writeFile as n } from "node:fs/promises";
-import { join as r, resolve as i } from "node:path";
-import { pathToFileURL as a } from "node:url";
-import { parseMdxFile as o } from "@ingcreators/annot-product-docs";
-import s from "exceljs";
+import { mkdir as e, readFile as t, readdir as n, writeFile as r } from "node:fs/promises";
+import { dirname as i, isAbsolute as a, join as o, resolve as s } from "node:path";
+import { pathToFileURL as c } from "node:url";
+import { parseAnnotationsYaml as l, parseMdxFile as u } from "@ingcreators/annot-product-docs";
+import d from "exceljs";
 //#region src/default-layout.ts
-var c = {
+var f = {
 	cover: 1,
 	history: 2,
 	list: 3,
 	screen: 4,
 	reference: 5
 };
-function l(e) {
-	let t = u(e.bundles);
+function p(e) {
+	let t = m(e.bundles);
 	for (let n of t) {
-		let t = n.frontmatter.xlsx?.role ?? "screen", r = g(n, t), i = e.workbook.addWorksheet(r);
+		let t = n.frontmatter.xlsx?.role ?? "screen", r = te(n, t), i = e.workbook.addWorksheet(r);
 		switch (t) {
 			case "cover":
-				d(i, n);
+				h(i, n);
 				break;
 			case "history":
-				f(i, n);
+				g(i, n);
 				break;
 			case "list":
-				p(i, e.bundles);
+				_(i, e.bundles);
 				break;
 			case "reference":
-				h(i, n);
+				v(i, n);
 				break;
-			default: m(i, n);
+			default: ee(i, n);
 		}
 	}
 }
-function u(e) {
+function m(e) {
 	return [...e].sort((e, t) => {
-		let n = c[e.frontmatter.xlsx?.role ?? "screen"] ?? 99, r = c[t.frontmatter.xlsx?.role ?? "screen"] ?? 99;
+		let n = f[e.frontmatter.xlsx?.role ?? "screen"] ?? 99, r = f[t.frontmatter.xlsx?.role ?? "screen"] ?? 99;
 		if (n !== r) return n - r;
 		let i = e.frontmatter.xlsx?.order ?? 100, a = t.frontmatter.xlsx?.order ?? 100;
 		return i === a ? e.mdxPath.localeCompare(t.mdxPath) : i - a;
 	});
 }
-function d(e, t) {
+function h(e, t) {
 	let n = t.frontmatter;
 	if (e.columns = [{
 		key: "label",
@@ -63,7 +63,7 @@ function d(e, t) {
 	});
 	e.getColumn(1).font = { bold: !0 };
 }
-function f(e, t) {
+function g(e, t) {
 	e.columns = [
 		{
 			header: "Version",
@@ -94,7 +94,7 @@ function f(e, t) {
 	});
 	e.getRow(1).font = { bold: !0 };
 }
-function p(e, t) {
+function _(e, t) {
 	e.columns = [
 		{
 			header: "ID",
@@ -125,7 +125,7 @@ function p(e, t) {
 	});
 	e.getRow(1).font = { bold: !0 };
 }
-function m(e, t) {
+function ee(e, t) {
 	let n = t.frontmatter;
 	e.addRow(["ID", n.id]), e.addRow(["Title", n.title ?? ""]), n.purpose && e.addRow(["Purpose", n.purpose]), e.addRow([]), e.addRow([
 		"#",
@@ -145,97 +145,137 @@ function m(e, t) {
 	]);
 	e.getColumn(1).width = 6, e.getColumn(2).width = 14, e.getColumn(3).width = 24, e.getColumn(4).width = 12, e.getColumn(5).width = 60, e.getColumn(1).font = { bold: !0 };
 }
-function h(e, t) {
+function v(e, t) {
 	e.addRow(["ID", t.frontmatter.id]), e.addRow(["Title", t.frontmatter.title ?? ""]), t.frontmatter.purpose && e.addRow(["Purpose", t.frontmatter.purpose]);
 }
-function g(e, t) {
+function te(e, t) {
 	let n = e.frontmatter.xlsx;
-	return typeof n?.sheet == "string" && n.sheet.length > 0 ? _(n.sheet) : t === "cover" ? "Cover" : t === "history" ? "Revision history" : t === "list" ? "Screen list" : _(t === "reference" ? e.frontmatter.id : e.frontmatter.title ?? e.frontmatter.id);
+	return typeof n?.sheet == "string" && n.sheet.length > 0 ? y(n.sheet) : t === "cover" ? "Cover" : t === "history" ? "Revision history" : t === "list" ? "Screen list" : y(t === "reference" ? e.frontmatter.id : e.frontmatter.title ?? e.frontmatter.id);
 }
-function _(e) {
+function y(e) {
 	let t = e.replace(/[\\/?*[\]:]/g, "_").slice(0, 31);
 	return t.length > 0 ? t : "Sheet";
 }
 //#endregion
 //#region src/extract.ts
-function v(e, t) {
-	let n = e.screens.map((e) => ({
+function b(e, t, n = {}) {
+	let r = n.annotationsYamlByPath, i = e.screens.map((e) => ({
 		id: e.id,
 		src: e.src,
-		overlayCount: e.overlays.length
-	})), r = [];
+		overlayCount: ne(e, r)
+	})), a = [];
 	for (let t of e.screens) {
-		let e = 1;
-		for (let n of t.overlays) {
-			let i = n.number ?? e++;
-			r.push({
+		let e = S(t, r);
+		if (e) for (let n of e) {
+			let e = t.callouts.find((e) => e.for === n.id);
+			a.push({
 				screenId: t.id,
-				number: i,
+				number: n.number,
 				intent: n.intent,
-				matchLabel: ee(n),
+				matchLabel: T(n),
 				matchRole: n.match.role,
 				matchName: n.match.name,
-				body: n.body
+				body: e?.body ?? ""
 			});
 		}
+		else {
+			let e = 1;
+			for (let n of t.overlays) {
+				let r = n.number ?? e++;
+				a.push({
+					screenId: t.id,
+					number: r,
+					intent: n.intent,
+					matchLabel: w(n),
+					matchRole: n.match.role,
+					matchName: n.match.name,
+					body: n.body
+				});
+			}
+		}
 	}
 	return {
 		mdxPath: t,
 		source: e.source,
 		frontmatter: e.frontmatter,
-		screens: n,
-		overlays: r,
+		screens: i,
+		overlays: a,
 		history: e.history,
 		snapshotYaml: e.commentBlocks.snapshot ?? "",
 		attributesYaml: e.commentBlocks.attributes ?? ""
 	};
 }
-async function y(e) {
-	let t = await o(e);
-	return t ? v(t, e) : null;
+async function x(e) {
+	let t = await u(e);
+	return t ? b(t, e, { annotationsYamlByPath: await C(t, e) }) : null;
+}
+function ne(e, t) {
+	let n = S(e, t);
+	return n ? n.length : e.overlays.length;
+}
+function S(e, t) {
+	return !t || !e.annotations ? null : t.get(e.annotations)?.overlays ?? null;
 }
-function ee(e) {
+async function C(e, n) {
+	let r = /* @__PURE__ */ new Map(), o = i(n);
+	for (let n of e.screens) {
+		if (!n.annotations || r.has(n.annotations)) continue;
+		let e = a(n.annotations) ? n.annotations : s(o, n.annotations), i;
+		try {
+			i = await t(e, "utf8");
+		} catch (t) {
+			throw Error(`extractMdxFile: <Screen annotations="${n.annotations}"> — failed to read ${e}: ${t.message}`);
+		}
+		r.set(n.annotations, l(i));
+	}
+	return r;
+}
+function w(e) {
+	let t = `${e.match.role} "${e.match.name}"`;
+	return e.match.under ? `${t} under ${e.match.under.role} "${e.match.under.name}"` : t;
+}
+function T(e) {
 	let t = `${e.match.role} "${e.match.name}"`;
 	return e.match.under ? `${t} under ${e.match.under.role} "${e.match.under.name}"` : t;
 }
 //#endregion
 //#region src/placeholder.ts
-var te = /\{([^{}]+)\}/g, b = "annot:";
-function x(e, t, n = {}) {
+var E = /\{([^{}]+)\}/g, D = "annot:";
+function O(e, t, n = {}) {
 	let r = n.totalSheets ?? e.worksheets.length;
 	e.worksheets.forEach((e, i) => {
-		S(e, t, {
+		k(e, t, {
 			...n,
 			sheetIndex: n.sheetIndex ?? i + 1,
 			totalSheets: r
 		});
 	});
 }
-function S(e, t, n = {}) {
+function k(e, t, n = {}) {
 	e.eachRow({ includeEmpty: !1 }, (e) => {
 		e.eachCell({ includeEmpty: !1 }, (e) => {
 			let r = e.value;
 			if (typeof r != "string") return;
-			let i = C(r, t, n);
+			let i = A(r, t, n);
 			i !== r && (e.value = i);
 		});
 	});
 }
-function C(e, t, n = {}) {
-	return e.replace(te, (e, r) => {
-		let { key: i, format: a } = w(r), o = T(i, t, n);
-		return o === void 0 ? e : a ? E(o, a) : o;
+function A(e, t, n = {}) {
+	return e.replace(E, (e, r) => {
+		let { key: i, format: a } = j(r), o = M(i, t, n);
+		return o === void 0 ? e : a ? N(o, a) : o;
 	});
 }
-function w(e) {
+function j(e) {
 	let t = e.trim();
-	if (t.startsWith(b)) {
+	if (t.startsWith(D)) {
 		let e = t.slice(6), n = e.indexOf(":");
 		return n < 0 ? {
 			key: t,
 			format: void 0
 		} : {
-			key: b + e.slice(0, n),
+			key: D + e.slice(0, n),
 			format: e.slice(n + 1)
 		};
 	}
@@ -248,11 +288,11 @@ function w(e) {
 		format: t.slice(n + 1)
 	};
 }
-function T(e, t, n) {
-	if (e.startsWith(b)) {
+function M(e, t, n) {
+	if (e.startsWith(D)) {
 		let t = e.slice(6), r = n.renderTime ?? /* @__PURE__ */ new Date();
 		switch (t) {
-			case "date": return O(r, "yyyy-MM-dd");
+			case "date": return F(r, "yyyy-MM-dd");
 			case "datetime": return r.toISOString();
 			case "sheetIndex": return n.sheetIndex === void 0 ? void 0 : String(n.sheetIndex);
 			case "totalSheets": return n.totalSheets === void 0 ? void 0 : String(n.totalSheets);
@@ -269,24 +309,24 @@ function T(e, t, n) {
 	let r = n.projectMeta?.[e];
 	if (r !== void 0) return String(r);
 }
-function E(e, t) {
-	let n = D(e);
-	return n ? O(n, t) : e;
+function N(e, t) {
+	let n = P(e);
+	return n ? F(n, t) : e;
 }
-function D(e) {
+function P(e) {
 	let t = e.trim(), n = t.match(/^(\d{4})-(\d{2})-(\d{2})$/);
 	if (n) return new Date(Number.parseInt(n[1], 10), Number.parseInt(n[2], 10) - 1, Number.parseInt(n[3], 10));
 	let r = new Date(t);
 	return Number.isNaN(r.getTime()) ? null : r;
 }
-function O(e, t) {
+function F(e, t) {
 	let n = String(e.getFullYear()).padStart(4, "0"), r = String(e.getMonth() + 1).padStart(2, "0"), i = String(e.getDate()).padStart(2, "0"), a = String(e.getHours()).padStart(2, "0"), o = String(e.getMinutes()).padStart(2, "0"), s = String(e.getSeconds()).padStart(2, "0");
 	return t.replace(/yyyy/g, n).replace(/MM/g, r).replace(/dd/g, i).replace(/HH/g, a).replace(/mm/g, o).replace(/ss/g, s);
 }
 //#endregion
 //#region src/template.ts
-function k(e) {
-	let t = u(e.bundles);
+function I(e) {
+	let t = m(e.bundles);
 	for (let n of t) {
 		let t = n.frontmatter.xlsx?.role ?? "screen", r = e.bookConfig.templateSheets?.[t];
 		if (!r) continue;
@@ -295,18 +335,18 @@ function k(e) {
 		let a = n.frontmatter.xlsx?.sheets;
 		if (a) {
 			let t = Object.entries(a);
-			for (let [, r] of t) S(j(e.workbook, i, _(r)), n, e.substitute ?? {});
+			for (let [, r] of t) k(R(e.workbook, i, y(r)), n, e.substitute ?? {});
 			continue;
 		}
-		let o = _(n.frontmatter.xlsx?.sheet ?? n.frontmatter.title ?? n.frontmatter.id);
-		S(j(e.workbook, i, o), n, e.substitute ?? {});
+		let o = y(n.frontmatter.xlsx?.sheet ?? n.frontmatter.title ?? n.frontmatter.id);
+		k(R(e.workbook, i, o), n, e.substitute ?? {});
 	}
 }
-async function A(e) {
-	let t = new s.Workbook();
+async function L(e) {
+	let t = new d.Workbook();
 	return await t.xlsx.readFile(e), t;
 }
-function j(e, t, n) {
+function R(e, t, n) {
 	let r = e.addWorksheet(n);
 	r.columns = t.columns.map((e) => ({
 		header: e.header,
@@ -320,23 +360,23 @@ function j(e, t, n) {
 			r.value = e.value, e.style && (r.style = e.style);
 		}), e.height !== void 0 && (n.height = e.height), n.commit();
 	});
-	for (let e of Object.values(M(t))) r.mergeCells(e);
+	for (let e of Object.values(z(t))) r.mergeCells(e);
 	return r;
 }
-function M(e) {
+function z(e) {
 	return e._merges ?? {};
 }
 //#endregion
 //#region src/workbook.ts
-function N(e) {
-	let t = new s.Workbook();
+function B(e) {
+	let t = new d.Workbook();
 	return t.creator = "@ingcreators/annot-product-docs-xlsx", t.created = /* @__PURE__ */ new Date(), t.title = e.book, t;
 }
-async function P(e) {
+async function V(e) {
 	let t = await e.xlsx.writeBuffer();
 	return t instanceof Buffer ? new Uint8Array(t.buffer, t.byteOffset, t.byteLength) : new Uint8Array(t);
 }
-function F(e, t) {
+function H(e, t) {
 	let n = /* @__PURE__ */ new Map();
 	for (let r of e) {
 		let e = r.frontmatter.xlsx?.book ?? t;
@@ -348,7 +388,7 @@ function F(e, t) {
 }
 //#endregion
 //#region src/cli.ts
-var I = [
+var U = [
 	"annot-docs-xlsx <command> [options]",
 	"",
 	"Commands:",
@@ -361,17 +401,17 @@ var I = [
 	"  --config <file>     Path to annot-docs.config.ts (default: ./annot-docs.config.ts)",
 	"  --help              Show this help"
 ].join("\n");
-async function L(e, t = {}) {
+async function W(e, t = {}) {
 	let n = t.stdout ?? ((e) => process.stdout.write(`${e}\n`)), r = t.stderr ?? ((e) => process.stderr.write(`${e}\n`)), i = t.cwd ?? process.cwd(), [, , a, ...o] = e;
-	if (a !== "render") return r(I), +!!a;
-	let s = R(o);
+	if (a !== "render") return r(U), +!!a;
+	let s = G(o);
 	try {
-		return await z(i, s, n);
+		return await K(i, s, n);
 	} catch (e) {
 		return r(`annot-docs-xlsx render: ${e.message}`), 1;
 	}
 }
-function R(e) {
+function G(e) {
 	let t = "docs", n = "dist/xlsx", r, i = "annot-docs.config.ts";
 	for (let a = 0; a < e.length; a++) {
 		let o = e[a];
@@ -384,99 +424,99 @@ function R(e) {
 		config: i
 	};
 }
-async function z(t, a, o) {
-	let s = await B(i(t, a.config), o), c = await H(await V(i(t, a.root)));
-	if (c.length === 0) return o(`annot-docs-xlsx render: no MDX files with \`annot:\` frontmatter under ${a.root}.`), 0;
-	let u = F(c, s.xlsx?.defaultBook), d = i(t, a.out);
-	await e(d, { recursive: !0 });
-	let f = 0;
-	for (let [e, c] of u.entries()) {
-		if (a.book && e !== a.book) continue;
-		let u = N({
+async function K(t, n, i) {
+	let a = await q(s(t, n.config), i), c = await J(await re(s(t, n.root)));
+	if (c.length === 0) return i(`annot-docs-xlsx render: no MDX files with \`annot:\` frontmatter under ${n.root}.`), 0;
+	let l = H(c, a.xlsx?.defaultBook), u = s(t, n.out);
+	await e(u, { recursive: !0 });
+	let d = 0;
+	for (let [e, c] of l.entries()) {
+		if (n.book && e !== n.book) continue;
+		let l = B({
 			book: e,
 			bundles: c
-		}), p = s.xlsx?.books?.[e], m = p?.template;
-		m ? k({
-			workbook: u,
-			template: await A(i(t, m)),
-			bookConfig: p,
+		}), f = a.xlsx?.books?.[e], m = f?.template;
+		m ? I({
+			workbook: l,
+			template: await L(s(t, m)),
+			bookConfig: f,
 			bundles: c,
 			substitute: {
-				projectMeta: s.meta,
+				projectMeta: a.meta,
 				renderTime: /* @__PURE__ */ new Date()
 			}
-		}) : l({
-			workbook: u,
+		}) : p({
+			workbook: l,
 			bundles: c
 		});
-		let h = await P(u), g = r(d, `${U(e)}.xlsx`);
-		await n(g, h), o(`  wrote ${g} (${c.length} MDX file(s))`), f++;
+		let h = await V(l), g = o(u, `${Y(e)}.xlsx`);
+		await r(g, h), i(`  wrote ${g} (${c.length} MDX file(s))`), d++;
 	}
-	return a.book && f === 0 ? (o(`annot-docs-xlsx render: book "${a.book}" not found (had: ${[...u.keys()].join(", ")}).`), 1) : (o(`annot-docs-xlsx render: emitted ${f} workbook(s) to ${a.out}`), 0);
+	return n.book && d === 0 ? (i(`annot-docs-xlsx render: book "${n.book}" not found (had: ${[...l.keys()].join(", ")}).`), 1) : (i(`annot-docs-xlsx render: emitted ${d} workbook(s) to ${n.out}`), 0);
 }
-async function B(e, t) {
+async function q(e, t) {
 	try {
-		let t = await import(a(e).href);
+		let t = await import(c(e).href);
 		return t.default ?? t;
 	} catch (n) {
 		if (n.code === "ERR_MODULE_NOT_FOUND") return t(`annot-docs-xlsx render: no config at ${e} — using defaults.`), {};
 		throw n;
 	}
 }
-async function V(e) {
-	let n = [], i = [e];
-	for (; i.length > 0;) {
-		let e = i.pop(), a;
+async function re(e) {
+	let t = [], r = [e];
+	for (; r.length > 0;) {
+		let e = r.pop(), i;
 		try {
-			a = await t(e, { withFileTypes: !0 });
+			i = await n(e, { withFileTypes: !0 });
 		} catch (e) {
 			if (e.code === "ENOENT") continue;
 			throw e;
 		}
-		for (let t of a) {
-			let a = r(e, t.name);
-			if (t.isDirectory()) {
-				if (t.name === "node_modules" || t.name.startsWith(".")) continue;
-				i.push(a);
-			} else t.isFile() && t.name.endsWith(".mdx") && n.push(a);
+		for (let n of i) {
+			let i = o(e, n.name);
+			if (n.isDirectory()) {
+				if (n.name === "node_modules" || n.name.startsWith(".")) continue;
+				r.push(i);
+			} else n.isFile() && n.name.endsWith(".mdx") && t.push(i);
 		}
 	}
-	return n.sort();
+	return t.sort();
 }
-async function H(e) {
+async function J(e) {
 	let t = [];
 	for (let n of e) try {
-		let e = await o(n);
-		e && t.push(v(e, n));
+		let e = await u(n);
+		e && t.push(b(e, n));
 	} catch {}
 	return t;
 }
-function U(e) {
+function Y(e) {
 	return e.replace(/[\\/?*[\]:<>|"]/g, "_");
 }
 //#endregion
 //#region src/named-range.ts
-var W = "annot";
-function G(e) {
-	for (let t of ie(e.workbook)) K(e, t);
+var X = "annot";
+function ie(e) {
+	for (let t of fe(e.workbook)) ae(e, t);
 }
-function K(e, t) {
-	let [n, r] = q(t.name.replace(/^annot/, ""));
+function ae(e, t) {
+	let [n, r] = oe(t.name.replace(/^annot/, ""));
 	switch (n) {
 		case "Image":
-			J(e, t, r);
+			se(e, t, r);
 			return;
 		case "ItemTable":
-			X(t, e.bundle);
+			ce(t, e.bundle);
 			return;
 		case "Transitions":
-			Z(t, e.bundle);
+			le(t, e.bundle);
 			return;
 		case "History":
-			ne(t, e.bundle);
+			ue(t, e.bundle);
 			return;
 		case "List":
-			re(t, e.allBundles ?? [e.bundle]);
+			de(t, e.allBundles ?? [e.bundle]);
 			return;
 		case "Snapshot":
 			Q(t, e.bundle.snapshotYaml);
@@ -486,11 +526,11 @@ function K(e, t) {
 			return;
 	}
 }
-function q(e) {
+function oe(e) {
 	let t = e.indexOf("_");
 	return t < 0 ? [e, void 0] : [e.slice(0, t), e.slice(t + 1)];
 }
-function J(e, t, n) {
+function se(e, t, n) {
 	let r = n ? e.imagesByScreenId?.[n] : e.defaultImage ?? e.imagesByScreenId?.[e.bundle.screens[0]?.id ?? ""];
 	if (!r) return;
 	let i = e.workbook.addImage({
@@ -499,7 +539,7 @@ function J(e, t, n) {
 	});
 	t.sheet.addImage(i, t.address);
 }
-function Y(e, t, n) {
+function Z(e, t, n) {
 	let { sheet: r, box: i } = e;
 	for (let e = 0; e < t.length; e++) {
 		let n = r.getCell(i.startRow, i.startCol + e);
@@ -511,8 +551,8 @@ function Y(e, t, n) {
 		for (let e = 0; e < t.length; e++) r.getCell(a, i.startCol + e).value = t[e] ?? "";
 	}
 }
-function X(e, t) {
-	Y(e, [
+function ce(e, t) {
+	Z(e, [
 		"#",
 		"Role",
 		"Name",
@@ -526,16 +566,16 @@ function X(e, t) {
 		e.body
 	]));
 }
-function Z(e, t) {
-	Y(e, [
+function le(e, t) {
+	Z(e, [
 		"Trigger",
 		"Event",
 		"Target",
 		"Notes"
 	], []);
 }
-function ne(e, t) {
-	Y(e, [
+function ue(e, t) {
+	Z(e, [
 		"Version",
 		"Date",
 		"Author",
@@ -547,8 +587,8 @@ function ne(e, t) {
 		e.body
 	]));
 }
-function re(e, t) {
-	Y(e, [
+function de(e, t) {
+	Z(e, [
 		"ID",
 		"Title",
 		"Screens",
@@ -567,13 +607,13 @@ function Q(e, t) {
 		vertical: "top"
 	};
 }
-function ie(e) {
+function fe(e) {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e.worksheets) n.eachRow({ includeEmpty: !0 }, (e, r) => {
 		e.eachCell({ includeEmpty: !0 }, (e, i) => {
-			let a = ae(e);
+			let a = pe(e);
 			for (let e of a) {
-				if (!e.startsWith(W)) continue;
+				if (!e.startsWith(X)) continue;
 				let a = `${n.name}|${e}`, o = t.get(a);
 				o || (o = {
 					sheet: n,
@@ -601,7 +641,7 @@ function ie(e) {
 		};
 	});
 }
-function ae(e) {
+function pe(e) {
 	return e.names ?? [];
 }
 function $(e) {
@@ -613,4 +653,4 @@ function $(e) {
 	return n;
 }
 //#endregion
-export { l as applyDefaultLayout, G as applyNamedRanges, x as applyPlaceholders, S as applyPlaceholdersToSheet, k as applyTemplateLayout, N as buildEmptyWorkbook, L as cliMain, L as main, v as extractFromParsed, y as extractMdxFile, F as groupBundlesByBook, A as loadTemplateWorkbook, C as resolvePlaceholders, _ as sanitiseSheetName, u as sortBundlesForLayout, P as writeWorkbookToBytes };
+export { p as applyDefaultLayout, ie as applyNamedRanges, O as applyPlaceholders, k as applyPlaceholdersToSheet, I as applyTemplateLayout, B as buildEmptyWorkbook, W as cliMain, W as main, b as extractFromParsed, x as extractMdxFile, H as groupBundlesByBook, L as loadTemplateWorkbook, A as resolvePlaceholders, y as sanitiseSheetName, m as sortBundlesForLayout, V as writeWorkbookToBytes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingcreators/annot-product-docs-xlsx",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Excel adapter for `@ingcreators/annot-product-docs`. Walks MDX files with `annot:` frontmatter, fills customer-supplied Excel templates via `{var}` placeholders + named ranges, and emits one `.xlsx` per book. Phase 3 of docs/plans/living-product-docs.md.",
   "license": "Apache-2.0",
   "author": "ingcreators",
@@ -47,12 +47,12 @@
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "vite": "^8.0.13",
-    "vite-plugin-dts": "^5.0.1"
+    "vite": "^8.0.16",
+    "vite-plugin-dts": "^5.0.3"
   },
   "dependencies": {
     "exceljs": "^4.4.0",
-    "@ingcreators/annot-product-docs": "0.3.0"
+    "@ingcreators/annot-product-docs": "0.4.0"
   },
   "scripts": {
     "build": "vite build",