@lupinum/ginko-content 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @lupinum/ginko-content
 
+## 0.6.0
+
+### Patch Changes
+
+- Updated dependencies [[`ee8c8a9`](https://github.com/lupinum-dev/ginko/commit/ee8c8a982a64ee15a1cab906b7a3b58fe8c686e6)]:
+  - @lupinum/ginko@0.6.0
+
+## 0.5.0
+
+### Minor Changes
+
+- [#23](https://github.com/lupinum-dev/ginko/pull/23) [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Change multi-choice values in content files: `none` says there are none, and an empty list on a required field is an error, so deleting the values no longer publishes "none".
+
+- [#23](https://github.com/lupinum-dev/ginko/pull/23) [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Add scheduled entries for file content: in a collection with drafts that lists its entries newest first by a date (such as `posts()` with `drafts: true`), an entry dated after the build day is left out of the build like a draft, and the first build on or after its date publishes it. The `blog` template feature relies on it (`templates/_features/blog`).
+
+### Patch Changes
+
+- [#23](https://github.com/lupinum-dev/ginko/pull/23) [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Change the `ginko check` messages for content files: they name the key you typed, a list row by its place (`row 3`), and the format to write (euros, `YYYY-MM-DD`, `HH:MM`, a period, an entry id). A YAML error in Markdown frontmatter now names the file and the line.
+
+- [#23](https://github.com/lupinum-dev/ginko/pull/23) [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Fix `ginko check` and the build hiding broken entries: a scheduling date that is not a valid `YYYY-MM-DD` date is now reported instead of leaving the entry out, a scheduled entry is checked like a published one, and a translation must have the same number of list rows as the main file
+
+- [#23](https://github.com/lupinum-dev/ginko/pull/23) [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Change the message for an entry that exists twice: it names both files, so the owner sees the one they just added.
+
+- [#21](https://github.com/lupinum-dev/ginko/pull/21) [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Fix the build keeping an entry whose required reference names a draft, such as the sessions of a draft event: it is now left out with the draft.
+
+- [#21](https://github.com/lupinum-dev/ginko/pull/21) [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Change platform Markdown fields to `{ ref }` in page state, as file bricks already are, so a page's payload carries only the texts it shows.
+  
+  Site code that reads a text's tree from an entry (`entry.data.body.nodes`) gets nothing now: load it with `useGinkoMarkdown(() => entry.value.data.body)` or, for several texts in one `useAsyncData`, `fetchGinkoMarkdown(value)`. `<GinkoMarkdown>` needs no change. A client navigation loads a text it has not shown yet from `/__ginko/platform/<locale>/<rev>/md/…`.
+
+- [#21](https://github.com/lupinum-dev/ginko/pull/21) [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991) Thanks [@Mat4m0](https://github.com/Mat4m0)! - Fix the silent loss of text after a block component without its closing `::` line: it is now refused with the line it starts on (Studio, agent tools, releases, `ginko check` and the build). Close every block component with a `::` line, also one at the very end of a text; for content files, `ginko check` and the build now fail and name the file and line.
+- Updated dependencies [[`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`c28d1e3`](https://github.com/lupinum-dev/ginko/commit/c28d1e3e4ba1e558f8c71d7b69961f7474a221d1), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`7b165c2`](https://github.com/lupinum-dev/ginko/commit/7b165c25e17ed2f4fb50e8054febf618a6af10d7), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991), [`80f93a4`](https://github.com/lupinum-dev/ginko/commit/80f93a4f6bd171e1146b929913254039becdd991)]:
+  - @lupinum/ginko@0.5.0
+
 ## 0.4.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { Locale, MarkdownValue, MarkdownTree } from '@lupinum/ginko';
-import { Schema, Bundle } from '@lupinum/ginko/internal';
+import { Schema, StoredEntry, FileInfo, Bundle } from '@lupinum/ginko/internal';
+import { Locale, MarkdownTree } from '@lupinum/ginko';
 import { SearchIndexJson } from '@lupinum/ginko/search';
 
 interface ContentError {
@@ -7,6 +7,8 @@ interface ContentError {
     file: string;
     /** Field path as in validate() issues, when the error belongs to one field. */
     path?: string;
+    /** The place as the owner reads it (`exceptions, row 3, closed`), when it differs from `path` (row ids, 0-based indexes). */
+    display?: string;
     message: string;
     /** 1-based line in the file, when the error belongs to one (YAML, JSON and CSV parse errors, CSV rows). */
     line?: number;
@@ -17,16 +19,48 @@ interface ContentError {
  */
 declare function errorLine(e: ContentError): string;
 interface ReadOptions {
-    /** `false` leaves out entries marked `draft: true`. Default `true` (dev shows drafts). */
+    /**
+     * `false` leaves out entries marked `draft: true`, and scheduled entries: in a collection with drafts that lists its
+     * entries newest first by a date (`drafts: true`, `order: { field, dir: 'desc' }`), an entry dated after `today`.
+     * Default `true` (dev shows both).
+     */
     drafts?: boolean;
+    /** The build day (`YYYY-MM-DD`) for scheduled entries. Default: today in the schema's time zone. */
+    today?: string;
+    /** `text` keeps each Markdown field as its source text, the form the platform stores and the Studio edits
+     * (`pnpm local:files-export`). Default `tree`: the parsed tree the site's bundle carries. */
+    markdown?: 'tree' | 'text';
 }
-
-/**
- * The bundle for page state: every markdown tree replaced by `{ ref, toc }` (CONTENT.md, Phase 14).
- * `trees` collects the trees by their ref, for the route that serves them.
- * @internal Loaded by the Ginko module and CLI; sites do not import it.
+interface ReadResult {
+    /** Stored-format entries per file brick, ready for buildBundle. */
+    entries: Record<string, StoredEntry[]>;
+    /** Images and files referenced from frontmatter, by their path under `public/` (the stored `file` id). */
+    files: Record<string, FileInfo>;
+    /** Images placed next to Markdown files: served URL (`/_ginko/img/<hash>.<ext>`) to absolute path. */
+    images: Map<string, string>;
+    errors: ContentError[];
+}
+/** Reads every brick with `source: 'files'` from `contentDir` (layout and rules: CONTENT.md "Dateien").
+ *
+ * - Collection `docs`: `docs/<n>.<name>.md` (main locale) and `docs/<n>.<name>.<locale>.md`.
+ *   Id `docs/<name>`, `order` = n (files without a number come after, by name); entries sorted by order. Slug from
+ *   frontmatter `slug`, else `<name>`; a translation may set its own `slug`.
+ * - Single `legal`: `legal.md` and `legal.<locale>.md`. One entry, id `legal`.
+ * - Frontmatter keys are field names in simple form; the body fills the brick's markdown field.
+ *   Translatable fields collect one locale per file into `{ de, en }`. Simple forms: money `12.5` →
+ *   `{ amount: 1250 }`; image `{ src: '/img/a.jpg', alt: '…' }` → `{ file: '/img/a.jpg', alt: { de: '…' } }`
+ *   (alt per locale file); file `'/docs/a.pdf'` → `{ file: '/docs/a.pdf' }`; choices `none` → `[]` (an empty list on a
+ *   required field is an error, so "none" is never left behind by deleting values); list rows get `_id`
+ *   `r` + 9 chars of sha256(`<entry id>:<row index>`) and translations merge by row index.
+ * - `prints` mark every translation as fresh (printOf of the main value), so a present translation
+ *   is never a fallback.
+ * - Errors, never thrown: unknown frontmatter key, a locale suffix the site does not have, a
+ *   translation without its main file, two entries with the same slug in one locale, a missing
+ *   image or file under `publicDir`, and every validate() error of the built entry (mode 'create').
+ *   A file with an error is left out; the others are still read.
  */
-declare function withMarkdownRefs(bundle: Bundle, schema: Schema, trees: Map<string, MarkdownValue>): Bundle;
+declare function readContent(contentDir: string, publicDir: string, schema: Schema, options?: ReadOptions): Promise<ReadResult>;
+
 /**
  * The bundle a site serves to everyone (`/__ginko/files/*`, page state, search): items whose visibility window
  * ended before `now` are left out (an expired offer is not private data to publish), and the repo path
@@ -71,4 +105,4 @@ interface BuildResult {
  */
 declare function searchIndex(bundle: Bundle, trees: Map<string, MarkdownTree>, schema: Schema): Promise<SearchIndexJson>;
 
-export { buildFileBundles, errorLine, publicBundle, searchIndex, withMarkdownRefs };
+export { buildFileBundles, errorLine, publicBundle, readContent, searchIndex };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Locale, MarkdownValue, MarkdownTree } from '@lupinum/ginko';
-import { Schema, Bundle } from '@lupinum/ginko/internal';
+import { Schema, StoredEntry, FileInfo, Bundle } from '@lupinum/ginko/internal';
+import { Locale, MarkdownTree } from '@lupinum/ginko';
 import { SearchIndexJson } from '@lupinum/ginko/search';
 
 interface ContentError {
@@ -7,6 +7,8 @@ interface ContentError {
     file: string;
     /** Field path as in validate() issues, when the error belongs to one field. */
     path?: string;
+    /** The place as the owner reads it (`exceptions, row 3, closed`), when it differs from `path` (row ids, 0-based indexes). */
+    display?: string;
     message: string;
     /** 1-based line in the file, when the error belongs to one (YAML, JSON and CSV parse errors, CSV rows). */
     line?: number;
@@ -17,16 +19,48 @@ interface ContentError {
  */
 declare function errorLine(e: ContentError): string;
 interface ReadOptions {
-    /** `false` leaves out entries marked `draft: true`. Default `true` (dev shows drafts). */
+    /**
+     * `false` leaves out entries marked `draft: true`, and scheduled entries: in a collection with drafts that lists its
+     * entries newest first by a date (`drafts: true`, `order: { field, dir: 'desc' }`), an entry dated after `today`.
+     * Default `true` (dev shows both).
+     */
     drafts?: boolean;
+    /** The build day (`YYYY-MM-DD`) for scheduled entries. Default: today in the schema's time zone. */
+    today?: string;
+    /** `text` keeps each Markdown field as its source text, the form the platform stores and the Studio edits
+     * (`pnpm local:files-export`). Default `tree`: the parsed tree the site's bundle carries. */
+    markdown?: 'tree' | 'text';
 }
-
-/**
- * The bundle for page state: every markdown tree replaced by `{ ref, toc }` (CONTENT.md, Phase 14).
- * `trees` collects the trees by their ref, for the route that serves them.
- * @internal Loaded by the Ginko module and CLI; sites do not import it.
+interface ReadResult {
+    /** Stored-format entries per file brick, ready for buildBundle. */
+    entries: Record<string, StoredEntry[]>;
+    /** Images and files referenced from frontmatter, by their path under `public/` (the stored `file` id). */
+    files: Record<string, FileInfo>;
+    /** Images placed next to Markdown files: served URL (`/_ginko/img/<hash>.<ext>`) to absolute path. */
+    images: Map<string, string>;
+    errors: ContentError[];
+}
+/** Reads every brick with `source: 'files'` from `contentDir` (layout and rules: CONTENT.md "Dateien").
+ *
+ * - Collection `docs`: `docs/<n>.<name>.md` (main locale) and `docs/<n>.<name>.<locale>.md`.
+ *   Id `docs/<name>`, `order` = n (files without a number come after, by name); entries sorted by order. Slug from
+ *   frontmatter `slug`, else `<name>`; a translation may set its own `slug`.
+ * - Single `legal`: `legal.md` and `legal.<locale>.md`. One entry, id `legal`.
+ * - Frontmatter keys are field names in simple form; the body fills the brick's markdown field.
+ *   Translatable fields collect one locale per file into `{ de, en }`. Simple forms: money `12.5` →
+ *   `{ amount: 1250 }`; image `{ src: '/img/a.jpg', alt: '…' }` → `{ file: '/img/a.jpg', alt: { de: '…' } }`
+ *   (alt per locale file); file `'/docs/a.pdf'` → `{ file: '/docs/a.pdf' }`; choices `none` → `[]` (an empty list on a
+ *   required field is an error, so "none" is never left behind by deleting values); list rows get `_id`
+ *   `r` + 9 chars of sha256(`<entry id>:<row index>`) and translations merge by row index.
+ * - `prints` mark every translation as fresh (printOf of the main value), so a present translation
+ *   is never a fallback.
+ * - Errors, never thrown: unknown frontmatter key, a locale suffix the site does not have, a
+ *   translation without its main file, two entries with the same slug in one locale, a missing
+ *   image or file under `publicDir`, and every validate() error of the built entry (mode 'create').
+ *   A file with an error is left out; the others are still read.
  */
-declare function withMarkdownRefs(bundle: Bundle, schema: Schema, trees: Map<string, MarkdownValue>): Bundle;
+declare function readContent(contentDir: string, publicDir: string, schema: Schema, options?: ReadOptions): Promise<ReadResult>;
+
 /**
  * The bundle a site serves to everyone (`/__ginko/files/*`, page state, search): items whose visibility window
  * ended before `now` are left out (an expired offer is not private data to publish), and the repo path
@@ -71,4 +105,4 @@ interface BuildResult {
  */
 declare function searchIndex(bundle: Bundle, trees: Map<string, MarkdownTree>, schema: Schema): Promise<SearchIndexJson>;
 
-export { buildFileBundles, errorLine, publicBundle, searchIndex, withMarkdownRefs };
+export { buildFileBundles, errorLine, publicBundle, readContent, searchIndex };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { readFileSync, statSync, openSync, readSync, closeSync, existsSync, renameSync, mkdirSync } from 'node:fs';
 import { readFile, readdir } from 'node:fs/promises';
 import { resolve, sep, dirname, join, extname, basename } from 'node:path';
-import { imageInfo, parseMarkdown, validate, coreMessage, printOf, urlsFor, urlClashes, effectiveProfile, slugify, isTranslatable, sha256, resolveRouteLinks, buildBundle, todayIn, isVisible } from '@lupinum/ginko/internal';
+import { imageInfo, parseMarkdown, todayIn, validate, printOf, routeUrls, urlClashes, effectiveProfile, coreMessage, isDate, slugify, isTranslatable, sha256, resolveRouteLinks, isVisible, buildBundle } from '@lupinum/ginko/internal';
 import { load } from 'js-yaml';
 import { createHash } from 'node:crypto';
 import { execFile } from 'node:child_process';
@@ -81,7 +81,7 @@ function cellValue(fields, column, cell) {
     case "image":
     case "choices":
     case "daterange":
-      return { error: `Column \u201C${column}\u201D: \u201C${field.label}\u201D cannot be written in CSV. Use a YAML or Markdown file for it.` };
+      return { error: `Column \u201C${column}\u201D cannot be written in CSV. Use a YAML or Markdown file for it.` };
     default:
       return { value: text };
   }
@@ -261,7 +261,7 @@ async function withPreviews(nodes, parse) {
 }
 
 function errorLine(e) {
-  return `content/${e.file}${e.line !== void 0 ? `:${e.line}` : ""}${e.path ? ` (${e.path})` : ""}: ${e.message}`;
+  return `content/${e.file}${e.line !== void 0 ? `:${e.line}` : ""}${e.display ?? e.path ? ` (${e.display ?? e.path})` : ""}: ${e.message}`;
 }
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const extensions = ["md", "yml", "yaml", "json", "csv"];
@@ -275,8 +275,10 @@ function parseFileName(file) {
   return { name: rest.slice(0, dot), number: numbered ? Number(numbered[1]) : void 0, locale: rest.slice(dot + 1) };
 }
 const rowId = (entryId, index) => `r${sha256(`${entryId}:${index}`).slice(0, 9)}`;
+const displayOf = (where, prefix, path) => [...where, path.slice(prefix.length)].join(", ");
 function fail(cx, path, message) {
-  cx.errors.push({ file: cx.file, path, message, ...cx.line !== void 0 ? { line: cx.line } : {} });
+  const display = cx.where.length > 0 ? displayOf(cx.where, cx.prefix, path) : void 0;
+  cx.errors.push({ file: cx.file, path, ...display !== void 0 && display !== path ? { display } : {}, message, ...cx.line !== void 0 ? { line: cx.line } : {} });
 }
 function redirectPaths(cx, value) {
   const list = Array.isArray(value) ? value : [value];
@@ -311,6 +313,18 @@ function jsonErrorOffset(text, reason) {
   }
   return low;
 }
+const isYamlError = (error) => error instanceof Error && error.name === "YAMLException";
+function yamlError(error, text, file, lineShift) {
+  const { reason, mark } = error;
+  const why = reason ?? (error instanceof Error ? error.message : String(error)).split("\n")[0];
+  const line = typeof mark?.line === "number" ? mark.line + 1 + lineShift : void 0;
+  let hint = "";
+  if (why.startsWith("bad indentation of a mapping entry")) {
+    const slip = line === void 0 ? null : /^\s*([^:\s][^:]*):\s+([^:]*:)\s/.exec(text.split("\n")[line - 1] ?? "");
+    hint = slip ? ` Put text with a colon in quotes: ${slip[1]}: "${slip[2]} \u2026"` : " Put text with a colon in quotes.";
+  }
+  return { file, message: `Invalid YAML: ${why}.${hint}`, ...line !== void 0 ? { line } : {} };
+}
 function parseDataFile(text, ext, rel, errors) {
   let data;
   try {
@@ -320,9 +334,7 @@ function parseDataFile(text, ext, rel, errors) {
     if (ext === "json") {
       errors.push({ file: rel, message: `Invalid JSON: ${reason}`, line: lineAt(text, jsonErrorOffset(text, reason)) });
     } else {
-      const mark = error.mark;
-      const why = error.reason ?? reason.split("\n")[0];
-      errors.push({ file: rel, message: `Invalid YAML: ${why}`, ...typeof mark?.line === "number" ? { line: mark.line + 1 } : {} });
+      errors.push(yamlError(error, text, rel, 0));
     }
     return void 0;
   }
@@ -354,11 +366,11 @@ function convertFields(fields, data, cx) {
       continue;
     }
     if (field.type === "markdown") {
-      fail(cx, path, `\u201C${field.label}\u201D is the text of the file, not a frontmatter key.`);
+      fail(cx, path, `\u201C${key}\u201D is the text of the file, not a frontmatter key.`);
       continue;
     }
     if (!cx.isMain && !isTranslatable(field) && field.type !== "list" && field.type !== "image") {
-      fail(cx, path, `\u201C${field.label}\u201D is set in the main-language file only.`);
+      fail(cx, path, `\u201C${key}\u201D is set in the main-language file only.`);
       continue;
     }
     switch (field.type) {
@@ -371,13 +383,27 @@ function convertFields(fields, data, cx) {
           out[key] = { file: value };
         } else out[key] = value;
         break;
+      case "choices": {
+        if (value === "none") {
+          out[key] = field.options.some((o) => o.value === "none") ? ["none"] : [];
+          break;
+        }
+        if (Array.isArray(value) && value.length === 0 && !field.optional) {
+          const [first, second] = field.options.map((o) => o.value);
+          const example = second === void 0 ? `[${first}]` : `[${first}, ${second}]`;
+          fail(cx, path, `\u201C${key}\u201D is empty: write the values, like ${example}, or none when there are none.`);
+          break;
+        }
+        out[key] = value;
+        break;
+      }
       case "image": {
         if (!isRecord(value)) {
-          fail(cx, path, `\u201C${field.label}\u201D needs src and alt.`);
+          fail(cx, path, `\u201C${key}\u201D needs src and alt.`);
           break;
         }
         if (!cx.isMain && value.src !== void 0) {
-          fail(cx, path, `\u201C${field.label}\u201D: src is set in the main-language file only.`);
+          fail(cx, path, `\u201C${key}\u201D: src is set in the main-language file only.`);
           break;
         }
         if (typeof value.src === "string") checkPublicFile(cx, path, value.src);
@@ -388,10 +414,10 @@ function convertFields(fields, data, cx) {
         const only = Object.keys(field.of).length === 1 ? Object.keys(field.of)[0] : void 0;
         const rows = Array.isArray(value) && only !== void 0 ? value.map((row) => isRecord(row) ? row : { [only]: row }) : value;
         if (!Array.isArray(rows) || !rows.every(isRecord)) {
-          fail(cx, path, `\u201C${field.label}\u201D must be a list of objects.`);
+          fail(cx, path, `\u201C${key}\u201D must be a list of objects.`);
           break;
         }
-        out[key] = rows.map((row, i) => convertFields(field.of, row, { ...cx, prefix: `${path}.${i}.` }));
+        out[key] = rows.map((row, i) => convertFields(field.of, row, { ...cx, prefix: `${path}.${i}.`, where: [...cx.where, displayOf(cx.where, cx.prefix, path), `row ${i + 1}`] }));
         break;
       }
       default:
@@ -425,8 +451,10 @@ function merge(fields, views, cx) {
     } else if (field.type === "list") {
       const mainRows = rowsOf(mainView[key]);
       for (const locale of cx.locales) {
-        if (rowsOf(views[locale]?.[key]).length > mainRows.length) {
-          cx.errors.push({ file: cx.rels[locale] ?? "", path, message: `\u201C${field.label}\u201D has more rows than in the main language.` });
+        const count = views[locale]?.[key] === void 0 ? mainRows.length : rowsOf(views[locale]?.[key]).length;
+        if (locale !== cx.main && count !== mainRows.length) {
+          const display = displayOf(cx.where, cx.prefix, path);
+          cx.errors.push({ file: cx.rels[locale] ?? "", path, ...display !== path ? { display } : {}, message: `\u201C${key}\u201D has ${count} rows here and ${mainRows.length} in content/${cx.rels[cx.main] ?? ""}. Each row translates the row at the same place in the main file; write - {} for a row with nothing to translate.` });
         }
       }
       out[key] = mainRows.map((_, i) => {
@@ -436,7 +464,7 @@ function merge(fields, views, cx) {
           const row = rowsOf(views[locale]?.[key])[i];
           if (row) rowViews[locale] = row;
         }
-        return { _id: id, ...merge(field.of, rowViews, { ...cx, prefix: `${path}.${id}.` }) };
+        return { _id: id, ...merge(field.of, rowViews, { ...cx, prefix: `${path}.${id}.`, where: [...cx.where, displayOf(cx.where, cx.prefix, path), `row ${i + 1}`] }) };
       });
     } else if (field.type === "image") {
       const image = mainView[key];
@@ -456,6 +484,7 @@ function merge(fields, views, cx) {
 }
 async function readContent(contentDir, publicDir, schema, options = {}) {
   const drafts = options.drafts ?? true;
+  const today = options.today ?? todayIn(schema.timeZone);
   const errors = [];
   const entries = {};
   const files = {};
@@ -467,11 +496,15 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
   const times = await fileTimes(contentDir);
   const urlOwners = [];
   const known = /* @__PURE__ */ new Map();
+  const idExamples = /* @__PURE__ */ new Map();
   for (const [key, brick] of Object.entries(schema.bricks)) {
     if (brick.source !== "files" || brick.kind !== "collection") continue;
     known.set(key, new Set((await entryNames(join(contentDir, key))).map((name) => `${key}/${name}`)));
+    const first = (await dataNames(join(contentDir, key))).find((file) => extOf(file) !== "csv" && parseFileName(file).locale === void 0);
+    if (first !== void 0) idExamples.set(key, `content/${key}/${first} is ${key}/${parseFileName(first).name}`);
   }
   const refs = (brick, id) => known.get(brick)?.has(id) ?? true;
+  const leftOut = /* @__PURE__ */ new Set();
   for (const [key, brick] of Object.entries(schema.bricks)) {
     if (brick.source !== "files") continue;
     entries[key] = [];
@@ -495,12 +528,12 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
       const group = groups.get(parsed.name) ?? { rank, translations: {} };
       groups.set(parsed.name, group);
       if (locale === main) {
-        if (group.main !== void 0) return report(`Entry \u201C${relOf(parsed.name)}\u201D exists twice.`);
+        if (group.main !== void 0) return report(`Entry \u201C${relOf(parsed.name)}\u201D is in two files: content/${group.main.rel} and content/${rel}. Keep one and delete or rename the other.`);
         group.main = src;
         group.number = parsed.number;
         group.rank = rank;
       } else {
-        if (group.translations[locale] !== void 0) return report(`Language \u201C${locale}\u201D exists twice for this entry.`);
+        if (group.translations[locale] !== void 0) return report(`Language \u201C${locale}\u201D of \u201C${relOf(parsed.name)}\u201D is in two files: content/${group.translations[locale].rel} and content/${rel}. Keep one and delete or rename the other.`);
         group.translations[locale] = src;
       }
     };
@@ -550,6 +583,7 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
     });
     let next = Math.max(0, ...sorted.map(([, g]) => g.number ?? 0));
     const slugKey = slugKeyOf(brick);
+    const dateKey = scheduleKeyOf(brick);
     const slugOwner = /* @__PURE__ */ new Map();
     for (const [name, group] of sorted) {
       if (group.main === void 0) {
@@ -560,11 +594,13 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
       const order = folder ? group.number ?? ++next : void 0;
       const mainRel = group.main.rel;
       const mainView = await readDoc(group.main, true);
+      if (mainView === "draft") leftOut.add(id);
       if (mainView === void 0 || mainView === "draft") continue;
       const views = { [main]: mainView.view };
       const trees = { [main]: mainView.tree };
       const rels = { [main]: mainRel };
       const lines = { [main]: group.main.csv?.row.line };
+      const bodyLines = { [main]: mainView.bodyLine };
       for (const locale of schema.locales) {
         const src = group.translations[locale];
         if (src === void 0) continue;
@@ -574,10 +610,11 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
         if (doc.tree) trees[locale] = doc.tree;
         rels[locale] = src.rel;
         lines[locale] = src.csv?.row.line;
+        bodyLines[locale] = doc.bodyLine;
       }
       const prints = {};
       const mergeErrors = [];
-      const data = merge(brick.fields, views, { main, locales: schema.locales, entryId: id, prefix: "", prints, rels, errors: mergeErrors });
+      const data = merge(brick.fields, views, { main, locales: schema.locales, entryId: id, prefix: "", prints, rels, errors: mergeErrors, where: [] });
       if (mergeErrors.length > 0) {
         errors.push(...mergeErrors);
         continue;
@@ -588,13 +625,25 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
           const last = issue.path.split(".").pop();
           const locale = schema.locales.find((l) => l === last);
           const at = locale && rels[locale] ? locale : main;
-          errors.push({ file: rels[at] ?? mainRel, path: issue.path, message: coreMessage("en", issue.key, issue.params), ...lines[at] !== void 0 ? { line: lines[at] } : {} });
+          const bodyLine = bodyLines[at];
+          const textLine = issue.key === "issues.markdownAt" && issue.path.split(".")[0] === markdownKeyOf(brick) ? issue.params?.line : void 0;
+          const line = typeof textLine === "number" && bodyLine !== void 0 ? bodyLine + textLine - 1 : lines[at];
+          const params = line !== void 0 && textLine !== void 0 ? { ...issue.params, line } : issue.params;
+          const where = locate(brick.fields, data, issue.path);
+          const display = where.shown.join(", ");
+          errors.push({
+            file: rels[at] ?? mainRel,
+            path: issue.path,
+            ...display !== issue.path ? { display } : {},
+            message: filesMessage(issue.key, params, where, { currency: schema.currency, refs, idExamples }),
+            ...line !== void 0 ? { line } : {}
+          });
         }
         continue;
       }
       const markdownKey = markdownKeyOf(brick);
       const texts = markdownKey === void 0 ? void 0 : data[markdownKey];
-      if (markdownKey !== void 0 && isRecord(texts)) {
+      if (options.markdown !== "text" && markdownKey !== void 0 && isRecord(texts)) {
         data[markdownKey] = Object.fromEntries(Object.entries(texts).map(([locale, text]) => [locale, trees[locale] ?? text]));
         for (const locale of Object.keys(prints[markdownKey] ?? {})) prints[markdownKey][locale] = printOf(data[markdownKey][main]);
       }
@@ -614,7 +663,7 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
       const entry = { id, data };
       if (mainView.redirectFrom?.length) entry.data.redirectFrom = mainView.redirectFrom;
       if (mainView.draft) entry.data.draft = true;
-      const urls = brick.kind === "collection" ? urlsFor(schema, key, brick, entry, (fileId) => files[fileId]) : {};
+      const urls = brick.kind === "collection" ? routeUrls(schema, brick, entry) : {};
       const urlClash = urlClashes([...urlOwners, { id, urls }]).find((c) => c.second === id);
       if (urlClash) {
         errors.push({ file: rels[urlClash.locale] ?? mainRel, path: slugKey, message: `URL \u201C${urlClash.url}\u201D is already taken by \u201C${urlClash.first}\u201D.` });
@@ -622,6 +671,10 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
       }
       urlOwners.push({ id, urls });
       for (const t of taken) slugOwner.set(t.key, id);
+      if (mainView.scheduled) {
+        leftOut.add(id);
+        continue;
+      }
       if (order !== void 0) entry.order = order;
       entry.updatedAt = times.updatedAt(Object.values(rels));
       entry.sources = Object.fromEntries(Object.entries(rels).map(([locale, rel]) => [locale, times.source(rel)]));
@@ -633,9 +686,10 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
       const ext = extOf(rel);
       const markdownKey = markdownKeyOf(brick);
       const fileErrors = [];
-      const cx = { file: rel, isMain, prefix: "", publicDir, files, errors: fileErrors, line: src.csv?.row.line };
+      const cx = { file: rel, isMain, prefix: "", publicDir, files, errors: fileErrors, line: src.csv?.row.line, where: [] };
       let data;
       let parsed;
+      let bodyLine;
       if (src.csv) {
         data = {};
         const { columns, row } = src.csv;
@@ -650,13 +704,20 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
         const text = await readFile(src.path, "utf8");
         if (ext === "md") {
           const field = markdownKey === void 0 ? void 0 : brick.fields[markdownKey];
-          parsed = await parseFile(text, { profile: field?.type === "markdown" ? effectiveProfile(field) : void 0, components: schema.components });
+          try {
+            parsed = await parseFile(text, { profile: field?.type === "markdown" ? effectiveProfile(field) : void 0, components: schema.components });
+          } catch (error) {
+            if (!isYamlError(error)) throw error;
+            errors.push(yamlError(error, text, rel, 1));
+            return void 0;
+          }
           for (const problem of parsed.previewProblems) fail(cx, markdownKey ?? "body", `In a \`\`\`md preview fence: ${coreMessage("en", problem.key, problem.params)}`);
           data = parsed.frontmatter;
           const imageCx = { contentDir, publicDir, file: rel, images, renames: /* @__PURE__ */ new Map(), imageProps, sized, fail: (message) => fileErrors.push({ file: rel, message }) };
           rewriteImages(parsed.value.nodes, imageCx);
           rewriteImages(parsed.value.summary, imageCx);
           parsed.body = renameInText(parsed.body, imageCx.renames);
+          bodyLine = text.split("\n").length - parsed.body.split("\n").length + 1;
         } else {
           const raw = parseDataFile(text, ext, rel, errors);
           if (raw === void 0) return void 0;
@@ -667,21 +728,88 @@ async function readContent(contentDir, publicDir, schema, options = {}) {
       const redirects = redirectFrom === void 0 ? void 0 : redirectPaths(cx, redirectFrom);
       if (draft !== void 0 && typeof draft !== "boolean") fail(cx, "draft", "\u201Cdraft\u201D must be true or false.");
       if (draft === true && !drafts && fileErrors.length === 0) return "draft";
+      const dateValue = dateKey === void 0 ? void 0 : fields[dateKey];
+      const scheduled = isMain && !drafts && isDate(dateValue) && dateValue > today;
       const view = convertFields(brick.fields, fields, cx);
       const hasBody = parsed !== void 0 && parsed.value.nodes.length > 0;
       if (parsed === void 0 && markdownKey !== void 0) {
-        const label = brick.fields[markdownKey].label;
-        fail(cx, markdownKey, `\u201C${label}\u201D is a markdown field: it is the text of a .md file, and ${ext === "csv" ? "CSV" : ext.toUpperCase()} files have no text.`);
+        fail(cx, markdownKey, `\u201C${markdownKey}\u201D is a markdown field: it is the text of a .md file, and ${ext === "csv" ? "CSV" : ext.toUpperCase()} files have no text.`);
       }
       if (parsed !== void 0 && markdownKey !== void 0 && hasBody) view[markdownKey] = parsed.body;
       if (markdownKey === void 0 && hasBody) fail(cx, "body", `The text fits no field of \u201C${key}\u201D (it has no markdown field).`);
       if (slugKey !== void 0 && view[slugKey] === void 0) view[slugKey] = src.csv ? src.name : slugify(src.name);
       errors.push(...fileErrors);
-      return fileErrors.length > 0 ? void 0 : { view, tree: markdownKey !== void 0 && hasBody ? parsed.value : void 0, redirectFrom: redirects, draft: draft === true ? true : void 0 };
+      return fileErrors.length > 0 ? void 0 : { view, tree: markdownKey !== void 0 && hasBody ? parsed.value : void 0, bodyLine, redirectFrom: redirects, draft: draft === true ? true : void 0, scheduled: scheduled ? true : void 0 };
+    }
+  }
+  for (let size = -1; size !== leftOut.size; ) {
+    size = leftOut.size;
+    for (const [key, list] of Object.entries(entries)) {
+      const owners = Object.entries(schema.bricks[key]?.fields ?? {}).filter(([, field]) => field.type === "ref" && !field.multiple && !field.optional).map(([name]) => name);
+      if (owners.length === 0) continue;
+      entries[key] = list.filter((entry) => {
+        const draft = owners.some((name) => leftOut.has(entry.data[name]));
+        if (draft) leftOut.add(entry.id);
+        return !draft;
+      });
     }
   }
   return { entries, files, images, errors };
 }
+const labelTexts = (field) => typeof field.label === "string" ? [field.label] : Object.values(field.label);
+function locate(root, data, path) {
+  const sets = [root];
+  const shown = [];
+  let fields = root;
+  let field;
+  let value = data;
+  for (const segment of path.split(".")) {
+    if (field?.type === "list") {
+      const rows = Array.isArray(value) ? value : [];
+      const index = rows.findIndex((row) => isRecord(row) && row._id === segment);
+      shown.push(index < 0 ? segment : `row ${index + 1}`);
+      value = rows[index];
+      fields = field.of;
+      sets.push(fields);
+      field = void 0;
+    } else if (field) {
+      shown[shown.length - 1] += `.${segment}`;
+      value = isRecord(value) ? value[segment] : void 0;
+    } else {
+      field = Object.hasOwn(fields, segment) ? fields[segment] : void 0;
+      shown.push(segment);
+      value = isRecord(value) ? value[segment] : void 0;
+    }
+  }
+  return { sets, field, value, shown };
+}
+function filesMessage(key, params, at, site) {
+  const keys = /* @__PURE__ */ new Map();
+  for (const set of at.sets) for (const [name2, field] of Object.entries(set)) for (const text of labelTexts(field)) keys.set(text, name2);
+  const named = Object.fromEntries(Object.entries(params ?? {}).map(([name2, value]) => [name2, keys.get(value) ?? value]));
+  const name = at.shown[at.shown.length - 1]?.split(".")[0] ?? "";
+  switch (key) {
+    case "issues.notMoney": {
+      const currency = at.field?.type === "money" && at.field.currency ? at.field.currency : site.currency;
+      return `\u201C${name}\u201D must be a number in ${currency}, like 65 or 12.50 (no currency sign, no thousands separator).`;
+    }
+    case "issues.badDate":
+      return `\u201C${name}\u201D is not a valid date: write it as YYYY-MM-DD, like 2026-10-24.`;
+    case "issues.badTime":
+      return `\u201C${name}\u201D is not a valid time: write it as HH:MM, like 09:30.`;
+    case "issues.badDateRange":
+      return `\u201C${name}\u201D needs from and to: ${name}: { from: 2026-11-14, to: 2026-11-14 } (the same date twice for one day).`;
+    case "issues.refGone": {
+      const to = at.field?.type === "ref" ? at.field.to : void 0;
+      const ids = Array.isArray(at.value) ? at.value : [at.value];
+      const missing = to === void 0 ? void 0 : ids.find((id) => typeof id === "string" && !site.refs(to, id));
+      const example = to === void 0 ? void 0 : site.idExamples.get(to);
+      return `There is no entry \u201C${String(missing ?? at.value)}\u201D. An id is the folder and the file name without number and language${example ? `: ${example}` : ""}.`;
+    }
+    default:
+      return coreMessage("en", key, named);
+  }
+}
 function markdownKeyOf(brick) {
   return Object.keys(brick.fields).find((k) => brick.fields[k].type === "markdown");
 }
@@ -712,6 +840,10 @@ async function dataNames(dir) {
 function slugKeyOf(brick) {
   return brick.fields.slug?.type === "slug" ? "slug" : void 0;
 }
+function scheduleKeyOf(brick) {
+  if (brick.kind !== "collection" || brick.drafts !== true || brick.order === "manual" || brick.order.dir !== "desc") return void 0;
+  return brick.fields[brick.order.field]?.type === "date" ? brick.order.field : void 0;
+}
 function brickProblemsOf(brick) {
   const problems = [];
   if (Object.values(brick.fields).filter((f) => f.type === "markdown" && !f.retired).length > 1) {
@@ -743,24 +875,6 @@ async function makeVariants(path, hash, width, dir, names, counter) {
 function fileSchema(schema) {
   return { ...schema, bricks: Object.fromEntries(Object.entries(schema.bricks).filter(([, brick]) => brick.source === "files")) };
 }
-function markdownRef(locale, brick, id, field) {
-  return `/__ginko/files/${locale}/md/${encodeURIComponent(brick)}/${id.split("/").map(encodeURIComponent).join("/")}/${encodeURIComponent(field)}.json`;
-}
-function withMarkdownRefs(bundle, schema, trees) {
-  const swap = (brick, id, data) => {
-    const out = { ...data };
-    for (const [name, field] of Object.entries(schema.bricks[brick]?.fields ?? {})) {
-      const value = out[name];
-      if (field.type !== "markdown" || !value || !("nodes" in value)) continue;
-      const ref = markdownRef(bundle.locale, brick, id, name);
-      trees.set(ref, value);
-      out[name] = value.toc === void 0 ? { ref } : { ref, toc: value.toc };
-    }
-    return out;
-  };
-  const bricks = Object.fromEntries(Object.entries(bundle.bricks).map(([key, b]) => [key, b.kind === "single" ? { ...b, data: swap(key, key, b.data) } : { ...b, items: b.items.map((item) => ({ ...item, data: swap(key, item.id, item.data) })) }]));
-  return { ...bundle, bricks };
-}
 function publicBundle(bundle, schema, now, options = {}) {
   const today = todayIn(schema.timeZone, now);
   const bricks = Object.fromEntries(Object.entries(bundle.bricks).map(([key, brick]) => {
@@ -774,22 +888,22 @@ function publicBundle(bundle, schema, now, options = {}) {
 async function buildFileBundles(options) {
   const { contentDir, publicDir, schema, now = /* @__PURE__ */ new Date() } = options;
   const files = fileSchema(schema);
-  const { entries, files: fileInfo, images, errors } = await readContent(contentDir, publicDir, files, options);
+  const { entries, files: fileInfo, images, errors } = await readContent(contentDir, publicDir, files, { today: todayIn(schema.timeZone, now), ...options });
   const imageFiles = /* @__PURE__ */ new Set();
   if (options.imageDir) await addVariants(fileInfo, images, publicDir, options.imageDir, imageFiles);
+  const build = (locale) => buildBundle({
+    schema: files,
+    requestedLocale: locale,
+    entries,
+    files: (id) => fileInfo[id],
+    schemaRev: 0,
+    contentRev: 0,
+    generatedAt: now.toISOString(),
+    today: todayIn(schema.timeZone, now)
+  });
+  const main = build(schema.locales[0]);
   const bundles = {};
-  for (const locale of schema.locales) {
-    bundles[locale] = resolveRouteLinks(buildBundle({
-      schema: files,
-      requestedLocale: locale,
-      entries,
-      files: (id) => fileInfo[id],
-      schemaRev: 0,
-      contentRev: 0,
-      generatedAt: now.toISOString(),
-      today: todayIn(schema.timeZone, now)
-    }), files);
-  }
+  for (const locale of schema.locales) bundles[locale] = resolveRouteLinks(locale === main.locale ? main : build(locale), files, main);
   return { bundles, images, imageFiles, errors };
 }
 async function addVariants(fileInfo, images, publicDir, imageDir, names) {
@@ -819,4 +933,4 @@ function searchIndex(bundle, trees, schema) {
   return buildIndex(searchSections(bundle, { schema, trees }), bundle.locale);
 }
 
-export { buildFileBundles, errorLine, publicBundle, searchIndex, withMarkdownRefs };
+export { buildFileBundles, errorLine, publicBundle, readContent, searchIndex };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-content",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Ginko bricks from Markdown files in the site's repo. Installed, not imported: the Ginko module loads it.",
   "license": "MIT",
@@ -36,12 +36,12 @@
     "shiki": "^4.3.1"
   },
   "devDependencies": {
-    "@lupinum/ginko": "0.4.0",
+    "@lupinum/ginko": "0.6.0",
     "sharp": "0.35.5",
     "unbuild": "3.6.1"
   },
   "peerDependencies": {
-    "@lupinum/ginko": "^0.4.0",
+    "@lupinum/ginko": "^0.6.0",
     "sharp": "^0.33.0 || ^0.34.0 || ^0.35.0"
   },
   "peerDependenciesMeta": {