@contentrain/emitter-astro 0.17.0 → 0.18.0

package/README.md

@@ -185,6 +185,39 @@ The feed lists every post, as WordPress's does — a post the source kept out of
 
 **Archive feeds.** WordPress serves a feed for every archive page — `/category/news/feed/`, `/tag/x/feed/`, `/author/ada/feed/`. Every dynamic archive route with a query in the site's default language (not its paginated continuation) gets one per page it builds, at `<archive>/feed.xml` (`src/pages/<archive>/feed.xml.ts`): the 10 newest posts that page lists, each at its own address, titled with the page's title. Each archive page links its feed in its head, and `<archive>/feed/` gets a 301 to it in `astro.config` and the host's redirect file, as the main feed does. The feed redirects pass the checks the site's own rules do — none over a page the site builds or a case twin of one, and a source rule for the same address wins — and in a host file with a rule limit they come after the site's own rules, `/feed/` first, so an overflow drops a feed redirect, which the warning counts. The template head's own archive feed link names one term's feed on every page, so it is removed with the other feed links the site does not build (comments, Atom). `options.feed: false` turns these off with the main feed.
 
+## Unpublished entries
+
+The content store keeps every entry the source had; only the published ones are
+built. `EmitPost.status` is the entry's `EntryMeta.status` (unset reads as
+`published`) and `publish_at` its `EntryMeta.publish_at` — a WordPress post
+scheduled for later is imported as `published` with a `publish_at` ahead. An
+entry is built when its status is `published` and its `publish_at`, if set, is
+not after `options.now` (default: the time of the emit). `EmitPost.visibility`
+(the store's `visibility` field) other than `public` — a password-protected or
+private post — is never built, whatever its status. Every other entry — a
+draft, one in review, rejected or archived, one scheduled for later, one whose
+`publish_at` is not a date, one that is not public — is held back before anything reads the content: no
+page, sitemap line, feed item, llms.txt link, list card or hreflang alternate.
+`EmitResult.withheld.entries` names each with its reason, and a warning counts
+them.
+
+An entry with no `status` is published, as before statuses existed — which
+fails open if a producer forgets to pass one. `options.requireStatus: true`
+turns that around: every entry (in posts, collections and list items) must
+carry a status, and one without it is held back (`status_missing`) and
+reported. A producer that reads statuses from the content store sets it.
+
+The data files hold only what is live at the emit, so a scheduled entry is
+built by the first emit after its time; rebuilding the same files does not
+publish it.
+
+A link on a published page (its body or `excerpt_html`, on its own page or as a
+list card) to a held-back entry would 404: the anchor is replaced by its text
+and listed in `EmitResult.withheld.links`. A link to an address a published
+entry still builds is left alone. A redirect (`redirects` or `hostRedirects`)
+whose target is a held-back entry is not written; it is returned in
+`EmitResult.redirects.manual` with the reason.
+
 ## Binding the runtime later
 
 `src/data/runtime.json` is the only place the binding lives; the components
@@ -285,4 +318,4 @@ literal routes.
 
 ## Checking the emitted types
 
-The unit suite asserts what the emitter writes; `pnpm --filter @contentrain/emitter-astro test:astro` (after `pnpm build`) checks it the way a migrated site's build does. It emits a site with every kind of page and endpoint — posts, pages, nested category and tag archives with their feeds, an author profile, a list, a static page, the feed, llms.txt, redirects — once with trailing slashes and once without, installs it with npm from its own `package.json`, and runs `astro check`. A pass is a result naming 0 errors. CI and the release workflow run it on every change.
+The unit suite asserts what the emitter writes; `pnpm --filter @contentrain/emitter-astro test:astro` (after `pnpm build`) checks it the way a migrated site's build does. It emits a site with every kind of page and endpoint — posts, pages, nested category and tag archives with their feeds, an author profile, a list, a static page, the feed, llms.txt, redirects, and a draft, an entry in review, a post scheduled for later and password-protected and private posts beside published ones — once with trailing slashes and once without, installs it with npm from its own `package.json` the way a production host does (`NODE_ENV=production`, `CI` set, no terminal), and runs `astro check` and then the site's own `npm run build`. A pass is a result naming 0 errors and a completed build; Astro's "requires @astrojs/check" notice fails it even though Astro exits 0 there. The first site is then built with `astro build`, and the output is read: the published posts have pages, sitemap lines and feed items, the held-back ones have none (nor llms.txt links or list cards), no file holds the password-protected post's text, and the live page's links to held-back entries are text. CI and the release workflow run it on every change.

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ComponentDef, EntrySourceRef, ModelDefinition, ProjectIR, RawRedirect, RawRedirect as RawRedirect$1, RawSeoEntry, RouteModel, RuntimeBinding, RuntimeBinding as RuntimeBinding$1, SeoProvider } from "@contentrain/types";
+import { ComponentDef, ContentStatus, EntrySourceRef, ModelDefinition, ProjectIR, RawRedirect, RawRedirect as RawRedirect$1, RawSeoEntry, RouteModel, RuntimeBinding, RuntimeBinding as RuntimeBinding$1, SeoProvider } from "@contentrain/types";
 
 //#region src/types.d.ts
 /**
@@ -120,6 +120,49 @@ interface EmitPost {
   noindex?: boolean;
   /** The source page was `nofollow`: `<meta name="robots" content="nofollow">`. */
   nofollow?: boolean;
+  /**
+   * The entry's workflow status in the content store (`EntryMeta.status`).
+   * Only `published` is built; unset reads as published unless
+   * `EmitOptions.requireStatus` is set. Any other status
+   * keeps the entry out of the site — no page, sitemap line, feed item,
+   * llms.txt link or list card — and `EmitResult.withheld` names it.
+   */
+  status?: ContentStatus;
+  /**
+   * When a published entry goes live (`EntryMeta.publish_at`, ISO 8601) — a
+   * WordPress post scheduled for later. Until then it is held back like a
+   * draft; compared with `EmitOptions.now`. A value that is not a date holds
+   * the entry back too.
+   */
+  publish_at?: string;
+  /**
+   * Who may read the entry (the store's `visibility` field — WordPress
+   * `public`, `private`, or `password` for a password-protected post). Anything
+   * but `public` is never built, whatever `status` says: no page, sitemap
+   * line, feed item, list card, share card or link to it. Unset reads as public.
+   */
+  visibility?: 'public' | 'private' | 'password' | (string & {});
+}
+/** An entry the build leaves out because it is not published yet. */
+interface WithheldEntry {
+  collection: string;
+  slug: string;
+  status?: ContentStatus;
+  publish_at?: string;
+  visibility?: string;
+  /**
+   * `visibility`: password-protected or private · `status`: not published ·
+   * `status_missing`: no status, with `EmitOptions.requireStatus` ·
+   * `scheduled`: publish_at is ahead · `publish_at_invalid`: publish_at is not a date.
+   */
+  reason: 'visibility' | 'status' | 'status_missing' | 'scheduled' | 'publish_at_invalid';
+}
+/** A link on a published page to a held-back entry, kept as its text. */
+interface WithheldLink {
+  /** The page it was on (site-root path), or `<collection>/<slug>` when no route builds it. */
+  page: string;
+  /** The address it pointed at. */
+  href: string;
 }
 /**
  * One block of a list: a template, optional wrapper, and how many items it takes.
@@ -345,6 +388,20 @@ interface EmitOptions {
    * Cloudflare Pages site must name its host (no forced rules there).
    */
   redirectHost?: 'netlify' | 'cloudflare' | 'vercel';
+  /**
+   * The moment `EmitPost.publish_at` is compared with, ISO 8601. Default: the
+   * time of the emit. The data files hold only what is live then, so a
+   * scheduled entry is built by the first emit after its time.
+   */
+  now?: string;
+  /**
+   * Hold back every entry — in posts, collections and list items — that
+   * carries no `EmitPost.status`, and say so. Default false: an entry with
+   * no status is published, as before statuses existed. A producer that
+   * reads statuses from the content store sets it, so an entry it failed to
+   * give one fails closed instead of going out as published.
+   */
+  requireStatus?: boolean;
 }
 interface EmitInput {
   ir: ProjectIR;
@@ -401,6 +458,15 @@ interface EmitResult {
      */
     host_over_limit: string[];
   };
+  /**
+   * Present when entries were held back (`EmitPost.status`, `publish_at`):
+   * each one, and each link to one that a published page carried — kept as
+   * its text. Redirects to a held-back entry are in `redirects.manual`.
+   */
+  withheld?: {
+    entries: WithheldEntry[];
+    links: WithheldLink[];
+  };
 }
 //#endregion
 //#region src/css.d.ts
@@ -655,6 +721,28 @@ declare function balanceWarning(html: string): string | null;
 /** Site-root paths (directory format, `/a/b/`) of every noindex page, sorted. */
 declare function noindexPaths(routes: RouteModel[], content: EmitContent): string[];
 //#endregion
+//#region src/published.d.ts
+/**
+ * Why an entry is not built, or null when it is. `now` is epoch ms. With
+ * `requireStatus` an entry that carries no status is held back: the producer
+ * said it passes every entry's status, so a missing one is a gap, not a
+ * published entry.
+ */
+declare function holdReason(post: Pick<EmitPost, 'status' | 'publish_at' | 'visibility'>, now: number, requireStatus?: boolean): WithheldEntry['reason'] | null;
+interface PublishedContent {
+  content: EmitContent;
+  withheld: WithheldEntry[];
+  links: WithheldLink[];
+  /** The addresses held-back entries would have had and no published entry builds (`/a/b/`). */
+  gone: Set<string>;
+}
+/**
+ * The content with every unpublished entry removed — from its collection and
+ * from the list pages that carry it as an item — and links to them unwrapped.
+ * Content with nothing held back is returned as given.
+ */
+declare function publishedContent(routes: RouteModel[], content: EmitContent, now: number, siteUrl?: string, requireStatus?: boolean): PublishedContent;
+//#endregion
 //#region src/redirects.d.ts
 /** The statuses written to `astro.config`; any other is a manual rule. */
 declare const REDIRECT_STATUSES: readonly [301, 302, 307, 308];
@@ -731,5 +819,5 @@ declare function emitAstroProject(input: EmitInput): EmitResult;
 /** Write an EmitResult to disk. Separate from emit so the core stays pure. */
 declare function writeEmit(result: EmitResult, dir: string): Promise<void>;
 //#endregion
-export { type Alternate, type AlternatesResult, type AuthorProfile, type BalanceReport, type Breadcrumb, EMBED_TS, type EmitContent, type EmitCssFile, type EmitInput, type EmitOptions, type EmitPost, type EmitResult, type EmitTermRef, type EntrySourceRef, FEED_ITEMS, FEED_PATH, type FeedLinkResult, type HostRedirectFiles, type ImageMeta, LLMS_LINKS, type LinkSource, type ManualRedirect, type MountRef, type QueryPage, REDIRECT_STATUSES, RUNTIME_IMPLEMENTED, type RawRedirect, type RedirectHost, type RedirectPlan, type RedirectStatus, type RuntimeBinding, SEO_COMPONENT, type SeoFields, type SeoFromRawOptions, type SocialOverride, type StripResult, type TwitterOverride, UI_STRINGS_DIR, UI_STRINGS_MODEL, UI_STRING_DEFAULTS, type UiStringKey, astroRedirectsConfig, balanceWarning, bodySeoLeaks, builtAddresses, checkBalance, componentMarkers, emitAstroProject, entryPath, hostRedirectFiles, isRuntimeImplemented, linkSources, noindexPaths, pascalCase, patternToPagePath, planRedirects, publisherIdOf, rewriteFeedLinks, seoFromRawEntry, stableJson, stripSeoTags, websiteIdOf, withAlternates, wrapLegacyCss, writeEmit };
+export { type Alternate, type AlternatesResult, type AuthorProfile, type BalanceReport, type Breadcrumb, EMBED_TS, type EmitContent, type EmitCssFile, type EmitInput, type EmitOptions, type EmitPost, type EmitResult, type EmitTermRef, type EntrySourceRef, FEED_ITEMS, FEED_PATH, type FeedLinkResult, type HostRedirectFiles, type ImageMeta, LLMS_LINKS, type LinkSource, type ManualRedirect, type MountRef, type PublishedContent, type QueryPage, REDIRECT_STATUSES, RUNTIME_IMPLEMENTED, type RawRedirect, type RedirectHost, type RedirectPlan, type RedirectStatus, type RuntimeBinding, SEO_COMPONENT, type SeoFields, type SeoFromRawOptions, type SocialOverride, type StripResult, type TwitterOverride, UI_STRINGS_DIR, UI_STRINGS_MODEL, UI_STRING_DEFAULTS, type UiStringKey, type WithheldEntry, type WithheldLink, astroRedirectsConfig, balanceWarning, bodySeoLeaks, builtAddresses, checkBalance, componentMarkers, emitAstroProject, entryPath, holdReason, hostRedirectFiles, isRuntimeImplemented, linkSources, noindexPaths, pascalCase, patternToPagePath, planRedirects, publishedContent, publisherIdOf, rewriteFeedLinks, seoFromRawEntry, stableJson, stripSeoTags, websiteIdOf, withAlternates, wrapLegacyCss, writeEmit };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/css.ts","../src/feed.ts","../src/util.ts","../src/layouts.ts","../src/components.ts","../src/seo.ts","../src/seo-entry.ts","../src/alternates.ts","../src/embed.ts","../src/ui-strings.ts","../src/balance.ts","../src/noindex.ts","../src/redirects.ts","../src/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/css.ts","../src/feed.ts","../src/util.ts","../src/layouts.ts","../src/components.ts","../src/seo.ts","../src/seo-entry.ts","../src/alternates.ts","../src/embed.ts","../src/ui-strings.ts","../src/balance.ts","../src/noindex.ts","../src/published.ts","../src/redirects.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -722,9 +722,7 @@ function scaffoldFiles(ir, options, noindex = [], redirectsConfig = null, runtim
 				"@tailwindcss/vite": "^4.0.0"
 			} : {},
 			...sitemap ? { "@astrojs/sitemap": "^3.7.0" } : {},
-			...images ? { sharp: "^0.34.0" } : {}
-		},
-		devDependencies: {
+			...images ? { sharp: "^0.34.0" } : {},
 			"@astrojs/check": "^0.9.0",
 			typescript: "^5.7.0"
 		}
@@ -1733,7 +1731,9 @@ function scanTags(html) {
 		});
 		i = j + 1;
 		if (!closing && RAW_TEXT_TAGS.has(name)) {
-			const close = html.toLowerCase().indexOf(`</${name}`, i);
+			const end = new RegExp(`</${name}`, "gi");
+			end.lastIndex = i;
+			const close = end.exec(html)?.index ?? -1;
 			i = close === -1 ? html.length : close;
 		}
 	}
@@ -3766,7 +3766,7 @@ const REDIRECT_STATUSES = [
 /** Whitespace, a control character or DEL anywhere in the string. */
 const hasControlOrSpace = (value) => [...value].some((char) => char.charCodeAt(0) <= 32 || char.charCodeAt(0) === 127);
 /** `/old/` and `/old` are one address in the directory build format. */
-function addressKey$1(path) {
+function addressKey$2(path) {
 	return path === "/" ? "/" : `${path.replace(/\/+$/, "")}/`;
 }
 /**
@@ -3777,7 +3777,7 @@ function addressKey$1(path) {
 function builtAddresses(routes, content) {
 	const out = /* @__PURE__ */ new Map();
 	const put = (path, routeId) => {
-		if (path !== null && !out.has(addressKey$1(path))) out.set(addressKey$1(path), routeId);
+		if (path !== null && !out.has(addressKey$2(path))) out.set(addressKey$2(path), routeId);
 	};
 	for (const route of routes) {
 		const pagePath = patternToPagePath(route.pattern);
@@ -3879,7 +3879,7 @@ function planRedirects(redirects, built, options = {}) {
 			skip("to is not a site-root path or an http(s) URL");
 			continue;
 		}
-		const key = addressKey$1(from.path);
+		const key = addressKey$2(from.path);
 		const owner = built.get(key);
 		if (owner !== void 0) {
 			skip(`the migrated site builds a page at ${key} (route ${owner}) — the page is kept`);
@@ -3901,7 +3901,7 @@ function planRedirects(redirects, built, options = {}) {
 			} catch {
 				target = redirect.to;
 			}
-			if (addressKey$1(target) === key) {
+			if (addressKey$2(target) === key) {
 				skip("to is the same address as from");
 				continue;
 			}
@@ -4006,6 +4006,172 @@ function hostRedirectFiles(config, host) {
 	};
 }
 //#endregion
+//#region src/published.ts
+/**
+* Why an entry is not built, or null when it is. `now` is epoch ms. With
+* `requireStatus` an entry that carries no status is held back: the producer
+* said it passes every entry's status, so a missing one is a gap, not a
+* published entry.
+*/
+function holdReason(post, now, requireStatus = false) {
+	if (post.visibility !== void 0 && post.visibility !== "public") return "visibility";
+	if (post.status === void 0 && requireStatus) return "status_missing";
+	if (post.status !== void 0 && post.status !== "published") return "status";
+	if (post.publish_at === void 0) return null;
+	const at = Date.parse(post.publish_at);
+	if (Number.isNaN(at)) return "publish_at_invalid";
+	return at > now ? "scheduled" : null;
+}
+const bareHost = (host) => host.replace(/^www\./, "").toLowerCase();
+/** `/a/b` and `/a/b/` are one address. */
+const addressKey$1 = (path) => path === "/" ? "/" : `${path.replace(/\/+$/, "")}/`;
+/**
+* The held-back address an href points at, or null: a site-root path, or an
+* absolute URL on the site's own host (`www.` either way).
+*/
+function withheldTarget(href, gone, siteUrl) {
+	if (!gone.size) return null;
+	let site;
+	try {
+		site = siteUrl ? new URL(siteUrl) : void 0;
+	} catch {
+		site = void 0;
+	}
+	let url;
+	try {
+		url = new URL(href, site ?? "http://site.invalid");
+	} catch {
+		return null;
+	}
+	if (!(site ? bareHost(url.host) === bareHost(site.host) : url.host === "site.invalid") || !/^https?:$/.test(url.protocol)) return null;
+	let path = url.pathname;
+	try {
+		path = decodeURI(path);
+	} catch {}
+	return gone.has(addressKey$1(path)) ? path : null;
+}
+/**
+* The content with every unpublished entry removed — from its collection and
+* from the list pages that carry it as an item — and links to them unwrapped.
+* Content with nothing held back is returned as given.
+*/
+function publishedContent(routes, content, now, siteUrl, requireStatus = false) {
+	const withheld = [];
+	const keep = (collection) => (post) => {
+		const reason = holdReason(post, now, requireStatus);
+		if (!reason) return true;
+		withheld.push({
+			collection,
+			slug: post.slug,
+			...post.status ? { status: post.status } : {},
+			...post.visibility ? { visibility: post.visibility } : {},
+			...post.publish_at ? { publish_at: post.publish_at } : {},
+			reason
+		});
+		return false;
+	};
+	const collections = content.collections ? Object.fromEntries(Object.entries(content.collections).map(([name, posts]) => [name, posts.filter(keep(name))])) : void 0;
+	const isLive = (post) => holdReason(post, now, requireStatus) === null;
+	const posts = content.posts?.filter(content.collections?.["posts"] ? isLive : keep(DEFAULT_COLLECTION));
+	const queries = content.queries ? Object.fromEntries(Object.entries(content.queries).map(([id, pages]) => [id, pages.map((page) => page.items.every(isLive) ? page : {
+		...page,
+		items: page.items.filter(isLive)
+	})])) : void 0;
+	const listedOnly = Object.values(content.queries ?? {}).flat().flatMap((p) => p.items).some((item) => !isLive(item));
+	if (!withheld.length && !listedOnly) return {
+		content,
+		withheld,
+		links: [],
+		gone: /* @__PURE__ */ new Set()
+	};
+	const filtered = {
+		...content,
+		...posts ? { posts } : {},
+		...collections ? { collections } : {},
+		...queries ? { queries } : {}
+	};
+	const built = builtAddresses(routes, filtered);
+	const gone = /* @__PURE__ */ new Set();
+	for (const route of routes) {
+		const pagePath = patternToPagePath(route.pattern);
+		if (!pagePath || !pagePath.includes("[") || route.kind !== "single" && route.collection === void 0) continue;
+		const collection = route.collection ?? "posts";
+		for (const post of collectionItems(content, collection)) {
+			const path = entryPath(route.pattern, {
+				...post.params,
+				slug: post.slug
+			});
+			if (path && !isLive(post) && !built.has(addressKey$1(path))) gone.add(addressKey$1(path));
+		}
+	}
+	const links = [];
+	const unlink = (html, page) => {
+		if (!html || !gone.size) return html;
+		return html.replace(ANCHOR_RE, (anchor, double, single, inner) => {
+			const to = withheldTarget((double ?? single ?? "").replace(/&amp;/g, "&"), gone, siteUrl);
+			if (!to) return anchor;
+			links.push({
+				page,
+				href: to
+			});
+			return inner;
+		});
+	};
+	const unlinkPost = (post, page) => {
+		const body = unlink(post.body, page) ?? post.body;
+		const excerpt_html = unlink(post.excerpt_html, page);
+		return body === post.body && excerpt_html === post.excerpt_html ? post : {
+			...post,
+			body,
+			...excerpt_html !== void 0 ? { excerpt_html } : {}
+		};
+	};
+	const pageOf = (collection, post) => {
+		const route = routes.find((r) => (r.kind === "single" || r.collection !== void 0) && (r.collection ?? "posts") === collection);
+		return (route && entryPath(route.pattern, {
+			...post.params,
+			slug: post.slug
+		})) ?? `${collection}/${post.slug}`;
+	};
+	if (filtered.collections) filtered.collections = Object.fromEntries(Object.entries(filtered.collections).map(([name, list]) => [name, list.map((p) => unlinkPost(p, pageOf(name, p)))]));
+	if (filtered.posts) filtered.posts = filtered.posts.map((p) => unlinkPost(p, pageOf(DEFAULT_COLLECTION, p)));
+	if (filtered.queries) filtered.queries = Object.fromEntries(Object.entries(filtered.queries).map(([id, pages]) => [id, pages.map((page) => {
+		const route = routes.find((r) => r.query === id);
+		const at = (route && entryPath(route.pattern, page.params)) ?? `query ${id}`;
+		return {
+			...page,
+			items: page.items.map((item) => unlinkPost(item, at))
+		};
+	})]));
+	return {
+		content: filtered,
+		withheld,
+		links,
+		gone
+	};
+}
+const ANCHOR_RE = /<a\b[^>]*?\shref\s*=\s*(?:"([^"]*)"|'([^']*)')[^>]*>([\s\S]*?)<\/a\s*>/gi;
+/** The report lines for what was held back. */
+function withheldWarnings(withheld, links) {
+	const out = [];
+	if (withheld.length) {
+		const count = (reason) => withheld.filter((w) => w.reason === reason).length;
+		const parts = [
+			count("visibility") && `${count("visibility")} password-protected or private`,
+			count("status_missing") && `${count("status_missing")} with no status (options.requireStatus)`,
+			count("status") && `${count("status")} not published (draft, in review, rejected or archived)`,
+			count("scheduled") && `${count("scheduled")} scheduled for later — built by the first emit after their publish_at`,
+			count("publish_at_invalid") && `${count("publish_at_invalid")} with a publish_at that is not a date`
+		].filter(Boolean);
+		out.push(`unpublished: ${withheld.length} entries not built — ${parts.join("; ")}. They stay in the content store; EmitResult.withheld lists each`);
+	}
+	if (links.length) {
+		const sample = links.slice(0, 5).map((l) => `${l.href} (on ${l.page})`).join(", ");
+		out.push(`unpublished: ${links.length} links from published pages to unpublished entries kept as plain text — ${sample}${links.length > 5 ? " …" : ""}`);
+	}
+	return out;
+}
+//#endregion
 //#region src/seo-entry.ts
 /**
 * A plugin's unrendered template, in its own syntax: Yoast `%%title%%`,
@@ -4184,6 +4350,27 @@ function emitAstroProject(input) {
 			files[path] = content;
 		}
 	};
+	let now = Date.now();
+	if (input.options?.now !== void 0) {
+		const at = Date.parse(input.options.now);
+		if (Number.isNaN(at)) warnings.push(`options.now "${input.options.now}" is not a date — publish_at is compared with the time of this emit`);
+		else now = at;
+	}
+	const published = publishedContent(ir.routes, input.content ?? {}, now, ir.site.url, input.options?.requireStatus === true);
+	const content = published.content;
+	warnings.push(...withheldWarnings(published.withheld, published.links));
+	const withheldManual = [];
+	const toPublished = (rules) => rules?.filter((redirect) => {
+		const target = withheldTarget(redirect.to, published.gone, ir.site.url);
+		if (target) withheldManual.push({
+			redirect,
+			reason: `to ${target}, an entry that is not published — the build has no page there`
+		});
+		return !target;
+	});
+	const siteRedirects = toPublished(input.redirects);
+	const hostOnlyRedirects = toPublished(input.hostRedirects);
+	if (withheldManual.length) warnings.push(`unpublished: ${withheldManual.length} redirects point at unpublished entries — not written (EmitResult.redirects.manual has each)`);
 	const siteLang = ir.site.locales?.[0] ?? "en";
 	const linkable = ir.site.url ? linkSources(ir.routes, siteLang) : [];
 	const feedSource = input.options?.feed !== false ? linkable.find((s) => s.collection === DEFAULT_COLLECTION) : void 0;
@@ -4191,11 +4378,11 @@ function emitAstroProject(input) {
 	const archiveFeeds = feedSource ? archiveFeedSources(ir.routes, siteLang) : [];
 	const archiveFeedRoutes = new Set(archiveFeeds.map((a) => a.routeId));
 	if (!ir.site.url && (input.options?.feed !== false || input.options?.llms !== false)) warnings.push("site.url is empty — no RSS feed and no llms.txt are built; both name pages by absolute address");
-	const redirectPlan = input.redirects ? planRedirects(input.redirects, builtAddresses(ir.routes, input.content ?? {})) : void 0;
-	if (redirectPlan?.manual.length) warnings.push(`redirects: ${redirectPlan.manual.length} of ${input.redirects.length} rules not written to astro.config — set them up at the host (EmitResult.redirects.manual has each with its reason)`);
+	const redirectPlan = siteRedirects ? planRedirects(siteRedirects, builtAddresses(ir.routes, content)) : void 0;
+	if (redirectPlan?.manual.length) warnings.push(`redirects: ${redirectPlan.manual.length} of ${siteRedirects.length} rules not written to astro.config — set them up at the host (EmitResult.redirects.manual has each with its reason)`);
 	const seo = input.options?.seo !== false;
-	const noindex = noindexPaths(ir.routes, input.content ?? {});
-	const built = builtAddresses(ir.routes, input.content ?? {});
+	const noindex = noindexPaths(ir.routes, content);
+	const built = builtAddresses(ir.routes, content);
 	const sourceConfig = redirectPlan?.config ?? {};
 	const claimed = new Set(Object.keys(sourceConfig).map((from) => from.replace(/\/+$/, "").toLowerCase()));
 	const feedRules = [];
@@ -4210,7 +4397,7 @@ function emitAstroProject(input) {
 		});
 	};
 	if (feedSource) addFeedRule(FEED_REDIRECT_FROM, FEED_PATH);
-	for (const source of archiveFeeds) for (const page of input.content?.queries?.[source.query] ?? []) {
+	for (const source of archiveFeeds) for (const page of content.queries?.[source.query] ?? []) {
 		const address = entryPath(source.pattern, page.params);
 		if (address) addFeedRule(`${address}feed/`, `${address}feed.xml`);
 	}
@@ -4222,7 +4409,7 @@ function emitAstroProject(input) {
 	};
 	const hasRedirects = Object.keys(redirectConfig).length > 0;
 	add(scaffoldFiles(ir, input.options ?? {}, noindex, hasRedirects ? astroRedirectsConfig(sortedConfig(redirectConfig)) : null, input.runtime));
-	const hostOnlyPlan = input.hostRedirects ? planRedirects(input.hostRedirects, built, { hostOnly: true }) : void 0;
+	const hostOnlyPlan = hostOnlyRedirects ? planRedirects(hostOnlyRedirects, built, { hostOnly: true }) : void 0;
 	const hostOnlyConfig = {};
 	const hostOnlyRule = /* @__PURE__ */ new Map();
 	const hostOnlyManual = [...hostOnlyPlan?.manual ?? []];
@@ -4264,7 +4451,7 @@ function emitAstroProject(input) {
 	});
 	else if (hostOnlyOver.length) warnings.push(`hostRedirects: ${hostOnlyOver.length} host-only rules not written to vercel.json at its rule limit (${HOST_RULE_LIMIT / 2} rules) — public/_redirects (Netlify) has them; on Vercel they are not served. Name the host (options.redirectHost) to have them reported as manual`);
 	const unservedHostOnly = new Set(hostOnlyManual.map((m) => m.redirect));
-	if (hostOnlyManual.length) warnings.push(`hostRedirects: ${hostOnlyManual.length} of ${input.hostRedirects.length} host-only rules not written — set them up at the host (EmitResult.redirects.manual has each with its reason)`);
+	if (hostOnlyManual.length) warnings.push(`hostRedirects: ${hostOnlyManual.length} of ${hostOnlyRedirects.length} host-only rules not written — set them up at the host (EmitResult.redirects.manual has each with its reason)`);
 	if (hostRedirects) {
 		add(hostRedirects.files);
 		const overLimit = hostRedirects.over_limit.filter((from) => !hostOnly(from));
@@ -4300,7 +4487,7 @@ function emitAstroProject(input) {
 	const bodyMarkersByFamily = /* @__PURE__ */ new Map();
 	for (const route of ir.routes) {
 		if (route.kind !== "single" && route.collection === void 0) continue;
-		const posts = collectionItems(input.content ?? {}, route.collection ?? "posts");
+		const posts = collectionItems(content, route.collection ?? "posts");
 		const ids = bodyMarkersByFamily.get(route.family) ?? /* @__PURE__ */ new Set();
 		for (const post of posts) for (const id of componentMarkers(post.body)) ids.add(id);
 		if (ids.size) bodyMarkersByFamily.set(route.family, ids);
@@ -4309,7 +4496,7 @@ function emitAstroProject(input) {
 	const queryBound = /* @__PURE__ */ new Set();
 	for (const family of ir.families) for (const placement of family.components ?? []) {
 		if (!placement.query) continue;
-		const pages = input.content?.queries?.[placement.query];
+		const pages = content.queries?.[placement.query];
 		if (!pages) {
 			warnings.push(`family ${family.id}: placement "${placement.component}" binds query "${placement.query}", which is not in input.content.queries — binding dropped, region left as cloned markup`);
 			continue;
@@ -4342,23 +4529,23 @@ function emitAstroProject(input) {
 		for (const ref of refs ?? []) if (!providedCss.has(ref.split("/").pop() ?? ref)) warnings.push(`${owner}: css file "${ref}" not provided in input.css`);
 	};
 	for (const family of ir.families) missingCss(family.css.files, `family ${family.id}`);
-	const allPosts = [...input.content?.posts ?? [], ...Object.values(input.content?.collections ?? {}).flat()];
+	const allPosts = [...content.posts ?? [], ...Object.values(content.collections ?? {}).flat()];
 	for (const post of allPosts) missingCss(post.css, `post ${post.slug}`);
-	for (const [queryId, queryPages] of Object.entries(input.content?.queries ?? {})) for (const qp of queryPages) missingCss(qp.css, `query ${queryId}`);
-	const trailOwners = [...Object.entries(input.content?.collections ?? {}), ...input.content?.posts ? [[DEFAULT_COLLECTION, input.content.posts]] : []];
+	for (const [queryId, queryPages] of Object.entries(content.queries ?? {})) for (const qp of queryPages) missingCss(qp.css, `query ${queryId}`);
+	const trailOwners = [...Object.entries(content.collections ?? {}), ...content.posts ? [[DEFAULT_COLLECTION, content.posts]] : []];
 	for (const [name, posts] of trailOwners) {
 		const bad = (posts ?? []).filter((p) => badTrail(p.breadcrumbs)).length;
 		if (bad) warnings.push(`collection ${name}: ${bad} breadcrumb trails dropped — every crumb needs a name and a site-root-relative path`);
 		const badLd = (posts ?? []).filter((p) => badSchema(p.schema)).length;
 		if (badLd) warnings.push(`collection ${name}: ${badLd} schema values are not JSON-LD objects — those pages print the generated structured data instead`);
 	}
-	for (const [queryId, queryPages] of Object.entries(input.content?.queries ?? {})) {
+	for (const [queryId, queryPages] of Object.entries(content.queries ?? {})) {
 		const bad = queryPages.filter((qp) => badTrail(qp.breadcrumbs)).length;
 		if (bad) warnings.push(`query ${queryId}: ${bad} breadcrumb trails dropped — every crumb needs a name and a site-root-relative path`);
 		const badLd = queryPages.filter((qp) => badSchema(qp.schema)).length;
 		if (badLd) warnings.push(`query ${queryId}: ${badLd} schema values are not JSON-LD objects — those pages print the generated structured data instead`);
 	}
-	let routeContent = input.content ?? {};
+	let routeContent = content;
 	if (seo) {
 		const alternates = withAlternates(ir.routes, routeContent, lang);
 		routeContent = alternates.content;
@@ -4413,8 +4600,8 @@ function emitAstroProject(input) {
 		if (uncovered.length) warnings.push(`ui-strings: no dictionary ${declared ? "declared" : "declared in options.uiStrings.locales"} for ${uncovered.join(", ")} — comments and forms on those pages show English text unless ${stringsDir ?? ".contentrain/content/site/ui-strings"}/{locale}.json exists at build`);
 	}
 	if ((ir.components ?? []).some((c) => isRuntimeImplemented(c, input.runtime) && c.type === "comments")) {
-		const collections = { ...input.content?.collections };
-		if (input.content?.posts && !collections["posts"]) collections[DEFAULT_COLLECTION] = input.content.posts;
+		const collections = { ...content.collections };
+		if (content.posts && !collections["posts"]) collections[DEFAULT_COLLECTION] = content.posts;
 		for (const [name, posts] of Object.entries(collections)) {
 			const unbound = posts.filter((p) => !p.entry).length;
 			if (unbound) warnings.push(`collection ${name}: ${unbound} of ${posts.length} posts carry no entry address — the comments component renders nothing on those pages`);
@@ -4442,9 +4629,17 @@ function emitAstroProject(input) {
 		warnings,
 		...redirectPlan || hostOnlyPlan ? { redirects: {
 			written: [...redirectPlan?.written ?? [], ...[...hostOnlyRule.values()].filter((rule) => !unservedHostOnly.has(rule))],
-			manual: [...redirectPlan?.manual ?? [], ...hostOnlyManual],
+			manual: [
+				...redirectPlan?.manual ?? [],
+				...hostOnlyManual,
+				...withheldManual
+			],
 			host_files: hostRedirects?.written ?? [],
 			host_over_limit: (hostRedirects?.over_limit ?? []).filter((from) => !hostOnly(from) || namedHost === void 0)
+		} } : {},
+		...published.withheld.length || published.links.length ? { withheld: {
+			entries: published.withheld,
+			links: published.links
 		} } : {}
 	};
 }
@@ -4468,6 +4663,6 @@ async function writeEmit(result, dir) {
 	await Promise.all(Object.entries(result.files).map(([path, content]) => writeFile(join(dir, path), content, "utf8")));
 }
 //#endregion
-export { EMBED_TS, FEED_ITEMS, FEED_PATH, LLMS_LINKS, REDIRECT_STATUSES, RUNTIME_IMPLEMENTED, SEO_COMPONENT, UI_STRINGS_DIR, UI_STRINGS_MODEL, UI_STRING_DEFAULTS, astroRedirectsConfig, balanceWarning, bodySeoLeaks, builtAddresses, checkBalance, componentMarkers, emitAstroProject, entryPath, hostRedirectFiles, isRuntimeImplemented, linkSources, noindexPaths, pascalCase, patternToPagePath, planRedirects, publisherIdOf, rewriteFeedLinks, seoFromRawEntry, stableJson, stripSeoTags, websiteIdOf, withAlternates, wrapLegacyCss, writeEmit };
+export { EMBED_TS, FEED_ITEMS, FEED_PATH, LLMS_LINKS, REDIRECT_STATUSES, RUNTIME_IMPLEMENTED, SEO_COMPONENT, UI_STRINGS_DIR, UI_STRINGS_MODEL, UI_STRING_DEFAULTS, astroRedirectsConfig, balanceWarning, bodySeoLeaks, builtAddresses, checkBalance, componentMarkers, emitAstroProject, entryPath, holdReason, hostRedirectFiles, isRuntimeImplemented, linkSources, noindexPaths, pascalCase, patternToPagePath, planRedirects, publishedContent, publisherIdOf, rewriteFeedLinks, seoFromRawEntry, stableJson, stripSeoTags, websiteIdOf, withAlternates, wrapLegacyCss, writeEmit };
 
 //# sourceMappingURL=index.mjs.map