@geekity/cms 0.30.0 → 0.32.0

package/dist/web/listing-pages.d.ts

@@ -0,0 +1,19 @@
+import type { Context } from 'hono';
+import type { GeekityEnv } from './env.ts';
+import type { ListingRequest } from './listing-subject.ts';
+import type { Representation } from './negotiate.ts';
+/** One page of a listing, in whichever representation the request settled on. */
+export declare function listing(c: Context<GeekityEnv>, request: ListingRequest, representation?: Representation | undefined): Response;
+/**
+ * One page of search results, in whichever representation the request settled
+ * on.
+ *
+ * What it finds is what the listings would show: the index holds the search to
+ * published, untrashed, already-due documents, so a draft cannot be found by
+ * its words any more than it can be found by its URL. A search with no query
+ * is the page with the form on it and nothing found, rather than an error,
+ * because that is where a link to the search from a theme lands. A page past
+ * the last one 404s, as it does on a listing.
+ */
+export declare function search(c: Context<GeekityEnv>, representation: Representation | undefined): Response;
+//# sourceMappingURL=listing-pages.d.ts.map

package/dist/web/listing-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-pages.d.ts","sourceRoot":"","sources":["../../src/web/listing-pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAY3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAgHrD,iFAAiF;AACjF,wBAAgB,OAAO,CACrB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EACtB,OAAO,EAAE,cAAc,EACvB,cAAc,GAAE,cAAc,GAAG,SAAwD,GACxF,QAAQ,CAyCV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CACpB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EACtB,cAAc,EAAE,cAAc,GAAG,SAAS,GACzC,QAAQ,CAwCV"}

package/dist/web/listing-pages.js

@@ -0,0 +1,147 @@
+import { archiveOf } from './listing-subject.js';
+import { listingMarkdown } from './markdown-representation.js';
+import { documentJson, latestModified, LISTING_REPRESENTATIONS, MEDIA_TYPES, notAcceptableResponse, representationEtag, representationResponse, SEARCH_REPRESENTATIONS, } from './negotiate.js';
+import { offsetForPage, paginate } from './pagination.js';
+import { conditionalHeaders, drawnForSomebody, notFound, queryFeedFormat, selectFromAccept, wantsFullDocuments, } from './request.js';
+import { searchHref, searchJson, searchPageIndex, searchQuery, SEARCH_PAGE_PARAM, SEARCH_QUERY_PARAM, } from './search.js';
+import { siteView } from './site-view.js';
+function openPage(c, options) {
+    const { pageNumber, hrefForPage, representation } = options;
+    const size = c.var.renderer.pageSize();
+    const pagination = paginate({ total: options.total, size, pageNumber, hrefForPage });
+    if (pageNumber >= pagination.totalPages)
+        return notFound(c);
+    const href = hrefForPage(pageNumber);
+    if (representation === undefined)
+        return notAcceptableResponse(href, options.available);
+    return {
+        pagination,
+        href,
+        representation,
+        paging: { limit: size, offset: offsetForPage(pageNumber, size) },
+    };
+}
+function pagedResponse(c, page, options) {
+    const { representation, href, pagination } = page;
+    const { documents } = options;
+    const sendsValidators = representation !== 'html' || !c.var.config.watch;
+    const fingerprint = options.fingerprint ??
+        listingFingerprint(href, pagination, documents, options.full ?? false, c.var.devMode);
+    return representationResponse({
+        body: options.body,
+        representation,
+        href,
+        available: options.available,
+        ...(options.links === undefined ? {} : { links: options.links }),
+        ...(drawnForSomebody(c, representation) ? { private: true } : {}),
+        ...(sendsValidators
+            ? {
+                etag: representationEtag(representation, fingerprint),
+                lastModified: latestModified(documents),
+            }
+            : {}),
+        conditional: conditionalHeaders(c),
+    });
+}
+/**
+ * What a listing page is made of, as one string to hash.
+ *
+ * The documents on the page are not the whole story: the same two posts on a
+ * differently sized archive are a different page, and a summary is not the
+ * body, so the pagination and the `full` flag are in the fingerprint too.
+ */
+function listingFingerprint(href, pagination, documents, full, devMode) {
+    return [
+        href,
+        ...(devMode ? ['dev mode'] : []),
+        `${String(pagination.pageNumber)}/${String(pagination.totalPages)}/${String(pagination.total)}`,
+        full ? 'full' : 'summary',
+        ...documents.map((document) => document.hash),
+    ].join('\n');
+}
+/** One page of a listing, in whichever representation the request settled on. */
+export function listing(c, request, representation = selectFromAccept(c, LISTING_REPRESENTATIONS)) {
+    const { renderer, config } = c.var;
+    const archive = archiveOf(siteView(c), request.subject);
+    // WordPress served every feed as a query on the listing before it served one
+    // at a path, and the links are still out there. `/?feed=rss2` and
+    // `/{base}/x/?feed=atom` land on the feed the listing now has.
+    const asked = queryFeedFormat(c);
+    if (asked !== undefined)
+        return c.redirect(archive.feedHref(asked), 301);
+    const page = openPage(c, {
+        total: archive.count(),
+        pageNumber: request.pageNumber,
+        hrefForPage: archive.href,
+        representation,
+        available: LISTING_REPRESENTATIONS,
+    });
+    if (page instanceof Response)
+        return page;
+    const documents = archive.list(page.paging);
+    const title = archive.pageTitle(renderer.site());
+    const available = LISTING_REPRESENTATIONS;
+    if (page.representation === 'markdown' || page.representation === 'text') {
+        const body = listingMarkdown(c, archive, { ...page, title, documents });
+        return pagedResponse(c, page, { body, documents, available, fingerprint: body });
+    }
+    const full = wantsFullDocuments(c);
+    const body = page.representation === 'json'
+        ? documents.map((document) => documentJson(document, { baseUrl: config.baseUrl, body: full }))
+        : renderer.renderListing({
+            title,
+            url: page.href,
+            documents,
+            pagination: page.pagination,
+            ...archive.context,
+        });
+    return pagedResponse(c, page, { body, documents, available, full });
+}
+/**
+ * One page of search results, in whichever representation the request settled
+ * on.
+ *
+ * What it finds is what the listings would show: the index holds the search to
+ * published, untrashed, already-due documents, so a draft cannot be found by
+ * its words any more than it can be found by its URL. A search with no query
+ * is the page with the form on it and nothing found, rather than an error,
+ * because that is where a link to the search from a theme lands. A page past
+ * the last one 404s, as it does on a listing.
+ */
+export function search(c, representation) {
+    const { store, renderer, config } = c.var;
+    const query = searchQuery(c.req.query(SEARCH_QUERY_PARAM));
+    const pageNumber = searchPageIndex(c.req.query(SEARCH_PAGE_PARAM));
+    if (pageNumber === undefined)
+        return notFound(c);
+    const page = openPage(c, {
+        total: store.countSearch(query),
+        pageNumber,
+        hrefForPage: (index) => searchHref(query, index),
+        representation,
+        available: SEARCH_REPRESENTATIONS,
+    });
+    if (page instanceof Response)
+        return page;
+    const hits = store.search(query, page.paging);
+    const full = wantsFullDocuments(c);
+    const body = page.representation === 'json'
+        ? searchJson({
+            query,
+            hits,
+            pagination: page.pagination,
+            baseUrl: config.baseUrl,
+            body: full,
+        })
+        : renderer.renderSearch({ query, url: page.href, hits, pagination: page.pagination });
+    return pagedResponse(c, page, {
+        body,
+        documents: hits.map((hit) => hit.document),
+        // The alternates are spelled here rather than by the negotiator, because
+        // they carry the query and a listing's never have one to carry.
+        available: [page.representation],
+        links: SEARCH_REPRESENTATIONS.filter((other) => other !== page.representation).map((other) => `<${searchHref(query, pageNumber, other)}>; rel="alternate"; type="${MEDIA_TYPES[other]}"`),
+        full,
+    });
+}
+//# sourceMappingURL=listing-pages.js.map

package/dist/web/listing-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-pages.js","sourceRoot":"","sources":["../../src/web/listing-pages.ts"],"names":[],"mappings":"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"}

package/dist/web/listing-subject.d.ts

@@ -0,0 +1,58 @@
+import type { Document } from '../content/document.ts';
+import type { ListOptions } from '../content/store.ts';
+import type { AuthorContext } from '../site/authors.ts';
+import type { SiteData } from '../theme/site-data.ts';
+import type { FeedFormat } from './feeds.ts';
+import type { Listing } from './render.ts';
+import type { AuthorListing, FrontPages, SiteView } from './site-view.ts';
+import type { TaxonomyBases, TaxonomyTerm } from '../content/taxonomy.ts';
+export type ListingSubject = {
+    kind: 'home';
+    postsPage: Document | undefined;
+} | {
+    kind: 'term';
+    term: TaxonomyTerm;
+} | {
+    kind: 'author';
+    author: AuthorListing;
+};
+/** Which page of which listing a request is for. */
+export interface ListingRequest {
+    subject: ListingSubject;
+    /** Zero-based index of the page. */
+    pageNumber: number;
+}
+export declare const SITE_POSTS: ListingSubject;
+type ListingContext = Pick<Listing, 'tag' | 'category' | 'author' | 'template' | 'document'>;
+export interface Archive {
+    count: () => number;
+    list: (paging?: ListOptions) => Document[];
+    href: (index: number) => string;
+    feedHref: (format: FeedFormat) => string;
+    pageTitle: (site: SiteData) => string;
+    feedTitle: (site: SiteData) => string;
+    description: (site: SiteData) => string;
+    author: AuthorContext | undefined;
+    context: ListingContext;
+}
+export declare function archiveOf(view: Pick<SiteView, 'store' | 'bases'>, subject: ListingSubject): Archive;
+export declare function homeListing(pages: FrontPages): ListingSubject | undefined;
+/** The URL of a page of the home listing, by zero-based index. */
+export declare function homeHref(index: number): string;
+/**
+ * The URL of a page of the listing that hangs off `root`, by zero-based index.
+ *
+ * The first page is the root itself: `/` or the posts page's own permalink,
+ * which is what makes a posts page one URL rather than two.
+ */
+export declare function listingPageHref(root: string, index: number): string;
+/**
+ * The URL of a feed: the whole site's, or one taxonomy archive's.
+ *
+ * WordPress's layout, so a subscriber of a migrated site keeps polling the URL
+ * they already hold: `/feed/` is RSS 2.0, `/feed/atom/` and `/feed/json/` are
+ * its siblings, and an archive's feeds hang off the archive.
+ */
+export declare function feedHref(term: TaxonomyTerm | undefined, format: FeedFormat, bases: TaxonomyBases): string;
+export {};
+//# sourceMappingURL=listing-subject.d.ts.map

package/dist/web/listing-subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-subject.d.ts","sourceRoot":"","sources":["../../src/web/listing-subject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9C,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,UAAU,EAAE,cAAuD,CAAC;AAEjF,KAAK,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;AAE7F,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,QAAQ,EAAE,CAAC;IAC3C,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;IACxC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,EACvC,OAAO,EAAE,cAAc,GACtB,OAAO,CA2DT;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAGzE;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,aAAa,GACnB,MAAM,CAER"}

package/dist/web/listing-subject.js

@@ -0,0 +1,89 @@
+import { authorFeedHref } from './feed-source.js';
+import { authorHref } from '../content/authors.js';
+import { profileContext } from '../site/authors.js';
+import { feedPathUnder } from './feeds.js';
+import { TEMPLATES } from './render.js';
+import { PAGE_SEGMENT, termHref } from '../content/taxonomy.js';
+export const SITE_POSTS = { kind: 'home', postsPage: undefined };
+export function archiveOf(view, subject) {
+    const { store, bases } = view;
+    if (subject.kind === 'home') {
+        const { postsPage } = subject;
+        const root = postsPage?.permalink ?? '/';
+        return {
+            count: () => store.counts().posts,
+            list: (paging) => store.listPosts(paging),
+            href: (index) => listingPageHref(root, index),
+            feedHref: (format) => feedPathUnder('/', format),
+            pageTitle: (site) => postsPage?.title || site.title,
+            feedTitle: (site) => site.title,
+            description: (site) => postsPage?.description ?? site.tagline ?? '',
+            author: undefined,
+            // Its words go above the posts, which is what a posts page is for: a
+            // theme prints `{{ content | safe }}` over the list.
+            context: postsPage === undefined ? {} : { document: postsPage },
+        };
+    }
+    const about = (name) => ({
+        pageTitle: () => name,
+        feedTitle: (site) => `${site.title}: ${name}`,
+    });
+    if (subject.kind === 'term') {
+        const { term } = subject;
+        return {
+            count: () => term.taxonomy === 'tag' ? store.countByTag(term.term) : store.countByCategory(term.term),
+            list: (paging) => term.taxonomy === 'tag'
+                ? store.listByTag(term.term, paging)
+                : store.listByCategory(term.term, paging),
+            href: (index) => termHref(term, index, bases),
+            feedHref: (format) => feedPathUnder(termHref(term, 0, bases), format),
+            ...about(term.term),
+            description: () => '',
+            author: undefined,
+            context: term.taxonomy === 'tag'
+                ? { tag: term.term, template: TEMPLATES.tag }
+                : { category: term.term, template: TEMPLATES.category },
+        };
+    }
+    const { user, names } = subject.author;
+    const profile = profileContext(user);
+    return {
+        count: () => store.countByAuthor(names),
+        list: (paging) => store.listByAuthor(names, paging),
+        href: (index) => authorHref(user.username, index),
+        feedHref: (format) => authorFeedHref(user.username, format),
+        ...about(user.profile?.displayName ?? user.username),
+        description: () => '',
+        author: profile,
+        context: { author: profile, template: TEMPLATES.author },
+    };
+}
+export function homeListing(pages) {
+    if (pages.home === undefined)
+        return SITE_POSTS;
+    return pages.posts === undefined ? undefined : { kind: 'home', postsPage: pages.posts };
+}
+/** The URL of a page of the home listing, by zero-based index. */
+export function homeHref(index) {
+    return listingPageHref('/', index);
+}
+/**
+ * The URL of a page of the listing that hangs off `root`, by zero-based index.
+ *
+ * The first page is the root itself: `/` or the posts page's own permalink,
+ * which is what makes a posts page one URL rather than two.
+ */
+export function listingPageHref(root, index) {
+    return index === 0 ? root : `${root}${PAGE_SEGMENT}/${String(index + 1)}/`;
+}
+/**
+ * The URL of a feed: the whole site's, or one taxonomy archive's.
+ *
+ * WordPress's layout, so a subscriber of a migrated site keeps polling the URL
+ * they already hold: `/feed/` is RSS 2.0, `/feed/atom/` and `/feed/json/` are
+ * its siblings, and an archive's feeds hang off the archive.
+ */
+export function feedHref(term, format, bases) {
+    return feedPathUnder(term === undefined ? '/' : termHref(term, 0, bases), format);
+}
+//# sourceMappingURL=listing-subject.js.map

package/dist/web/listing-subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing-subject.js","sourceRoot":"","sources":["../../src/web/listing-subject.ts"],"names":[],"mappings":"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"}

package/dist/web/llms.d.ts

@@ -1,10 +1,12 @@
+import type { MarkdownUrl } from './markdown-page.ts';
 import type { ConditionalHeaders } from './negotiate.ts';
 /**
  * `/llms.txt` (TASK-149): the site described for a language model, in the
  * llmstxt.org shape. A heading with the site's title, its tagline as a quote,
- * then its pages and its recent posts as lists of links, each to the Markdown
- * the site already serves for that document, which is what a model wants to
- * read.
+ * then the site's navigation and every page and every post the site lists as
+ * lists of links, each to the Markdown the site already serves for what it
+ * names, which is what a model wants to read. One file however large the site:
+ * the format has no pagination.
  *
  * A fixed route at the root for the reason `robots.txt` is one: it is the only
  * place a tool looks, and no permalink may take it.
@@ -21,9 +23,14 @@ export declare const LLMS_TXT_LINK = "</llms.txt>; rel=\"describedby\"; type=\"t
 /** One document the file lists. */
 export interface LlmsEntry {
     title: string;
-    /** The site-relative URL of the document's Markdown. */
+    /**
+     * The canonical URL of what it names; the writer links its Markdown. A
+     * navigation entry may name another site.
+     */
     href: string;
     description?: string | undefined;
+    /** A post's calendar day, `YYYY-MM-DD`, written ahead of its description. */
+    date?: string | undefined;
     /** When it last changed, for the file's `Last-Modified`. */
     lastModified?: Date | undefined;
 }
@@ -32,8 +39,10 @@ export interface LlmsIndex {
     title: string;
     /** The site's tagline, or empty for none. */
     description: string;
+    /** The site's menus, every item once. */
+    navigation: readonly LlmsEntry[];
     pages: readonly LlmsEntry[];
-    /** Newest first. */
+    /** Every listed post, newest first. */
     posts: readonly LlmsEntry[];
 }
 /** The file as it is served: its bytes, and when what it describes changed. */
@@ -41,18 +50,10 @@ export interface LlmsTxtFile {
     body: string;
     lastModified: Date | undefined;
 }
-export interface LlmsListing {
-    title: string;
-    description?: string | undefined;
-    posts: readonly LlmsEntry[];
-    newer?: string | undefined;
-    older?: string | undefined;
-}
 /** The index as llms.txt Markdown, every link absolute. */
-export declare function llmsTxt(index: LlmsIndex, baseUrl: string): string;
-export declare function llmsListingTxt(listing: LlmsListing, baseUrl: string): string;
+export declare function llmsTxt(index: LlmsIndex, baseUrl: string, markdownUrl: MarkdownUrl): string;
 /** A generated file, dated by the newest entry in it. */
-export declare function generatedLlmsTxt(index: LlmsIndex, baseUrl: string): LlmsTxtFile;
+export declare function generatedLlmsTxt(index: LlmsIndex, baseUrl: string, markdownUrl: MarkdownUrl): LlmsTxtFile;
 /**
  * The site's own `content/llms.txt`, served as written in place of the
  * generated one, or `undefined` when it has none.

package/dist/web/llms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/web/llms.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;GASG;AAEH,sBAAsB;AACtB,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,aAAa,6DAAgE,CAAC;AAI3F,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACjC;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,oBAAoB;IACpB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQjE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAS/E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,QAAQ,CAaV"}
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/web/llms.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;;GAUG;AAEH,sBAAsB;AACtB,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,aAAa,6DAAgE,CAAC;AAI3F,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACjC;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IACjC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,uCAAuC;IACvC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC;CAChC;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAU3F;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,GACvB,WAAW,CASb;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,QAAQ,CAaV"}

package/dist/web/llms.js

@@ -1,12 +1,16 @@
 import { readFileSync, statSync } from 'node:fs';
 import path from 'node:path';
-import { absoluteUrl, contentEtag, isNotModified } from './negotiate.js';
+import { escapeLinkText } from '../content/markdown-links.js';
+import { absoluteUrl } from '../util/url.js';
+import { oneLine } from './markdown-page.js';
+import { contentEtag, isNotModified } from './negotiate.js';
 /**
  * `/llms.txt` (TASK-149): the site described for a language model, in the
  * llmstxt.org shape. A heading with the site's title, its tagline as a quote,
- * then its pages and its recent posts as lists of links, each to the Markdown
- * the site already serves for that document, which is what a model wants to
- * read.
+ * then the site's navigation and every page and every post the site lists as
+ * lists of links, each to the Markdown the site already serves for what it
+ * names, which is what a model wants to read. One file however large the site:
+ * the format has no pagination.
  *
  * A fixed route at the root for the reason `robots.txt` is one: it is the only
  * place a tool looks, and no permalink may take it.
@@ -22,30 +26,19 @@ export const OWN_LLMS_TXT_FILE = 'llms.txt';
 export const LLMS_TXT_LINK = `<${LLMS_TXT_PATH}>; rel="describedby"; type="text/markdown"`;
 const LLMS_TXT_CONTENT_TYPE = 'text/markdown; charset=utf-8';
 /** The index as llms.txt Markdown, every link absolute. */
-export function llmsTxt(index, baseUrl) {
+export function llmsTxt(index, baseUrl, markdownUrl) {
     const description = oneLine(index.description);
+    const link = (href) => absoluteUrl(markdownUrl(href), baseUrl);
     return markdownFile([
         `# ${oneLine(index.title)}`,
         ...(description === '' ? [] : [`> ${description}`]),
-        ...section('Pages', index.pages, baseUrl),
-        ...section('Recent posts', index.posts, baseUrl),
-    ]);
-}
-export function llmsListingTxt(listing, baseUrl) {
-    const pager = [
-        ...(listing.newer === undefined ? [] : [{ title: 'Newer posts', href: listing.newer }]),
-        ...(listing.older === undefined ? [] : [{ title: 'Older posts', href: listing.older }]),
-    ];
-    const description = oneLine(listing.description ?? '');
-    return markdownFile([
-        `# ${oneLine(listing.title)}`,
-        ...(description === '' ? [] : [`> ${description}`]),
-        ...section('Posts', listing.posts, baseUrl),
-        ...section('More posts', pager, baseUrl),
+        ...section('Navigation', index.navigation, link),
+        ...section('Pages', index.pages, link),
+        ...section('Posts', index.posts, link),
     ]);
 }
 /** A generated file, dated by the newest entry in it. */
-export function generatedLlmsTxt(index, baseUrl) {
+export function generatedLlmsTxt(index, baseUrl, markdownUrl) {
     let lastModified;
     for (const entry of [...index.pages, ...index.posts]) {
         if (entry.lastModified === undefined)
@@ -54,7 +47,7 @@ export function generatedLlmsTxt(index, baseUrl) {
             lastModified = entry.lastModified;
         }
     }
-    return { body: llmsTxt(index, baseUrl), lastModified };
+    return { body: llmsTxt(index, baseUrl, markdownUrl), lastModified };
 }
 /**
  * The site's own `content/llms.txt`, served as written in place of the
@@ -89,21 +82,16 @@ export function llmsTxtResponse(file, conditional) {
 function markdownFile(blocks) {
     return `${blocks.join('\n\n')}\n`;
 }
-function section(heading, entries, baseUrl) {
+function section(heading, entries, link) {
     return entries.length === 0
         ? []
-        : [`## ${heading}`, entries.map((entry) => entryLine(entry, baseUrl)).join('\n')];
-}
-function entryLine(entry, baseUrl) {
-    const description = oneLine(entry.description ?? '');
-    const link = `- [${escapeLinkText(oneLine(entry.title))}](${absoluteUrl(entry.href, baseUrl)})`;
-    return description === '' ? link : `${link}: ${description}`;
-}
-/** A list item is one line, so a folded description is unfolded. */
-function oneLine(text) {
-    return text.replace(/\s+/g, ' ').trim();
+        : [`## ${heading}`, entries.map((entry) => entryLine(entry, link)).join('\n')];
 }
-function escapeLinkText(text) {
-    return text.replace(/[\\[\]]/g, (character) => `\\${character}`);
+function entryLine(entry, link) {
+    const notes = [entry.date, oneLine(entry.description ?? '')]
+        .filter((note) => note !== undefined && note !== '')
+        .join('. ');
+    const line = `- [${escapeLinkText(oneLine(entry.title))}](${link(entry.href)})`;
+    return notes === '' ? line : `${line}: ${notes}`;
 }
 //# sourceMappingURL=llms.js.map

package/dist/web/llms.js.map

@@ -1 +1 @@
-{"version":3,"file":"llms.js","sourceRoot":"","sources":["../../src/web/llms.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llms.js","sourceRoot":"","sources":["../../src/web/llms.ts"],"names":[],"mappings":"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"}

package/dist/web/maintenance.d.ts

@@ -1,5 +1,5 @@
 import type { MiddlewareHandler } from 'hono';
-import type { GeekityEnv } from '../env.ts';
+import type { GeekityEnv } from './env.ts';
 /**
  * Turn the site away while it is in maintenance mode (TASK-130).
  *

package/dist/web/maintenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../src/web/maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAIvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAsE5C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,CAAC,UAAU,CAYzD,CAAC"}
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../src/web/maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAIvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AA+D3C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,EAAE,iBAAiB,CAAC,UAAU,CAYzD,CAAC"}

package/dist/web/maintenance.js

@@ -1,10 +1,9 @@
-import { ADMIN_PREFIX } from '../admin/session.js';
-import { signedInCommenter } from '../comments/viewer.js';
-import { THEME_ASSET_PREFIX } from './assets.js';
-import { representationOf } from './errors.js';
+import { ADMIN_PREFIX } from '../site/admin-paths.js';
+import { signedInAccount } from './signed-in.js';
+import { THEME_ASSET_PREFIX } from '../theme/assets.js';
+import { representationOf, CONTENT_TYPES, PRIVATE_CACHE_CONTROL } from './negotiate.js';
 import { HEALTH_PATH } from './health.js';
-import { CONTENT_TYPES } from './negotiate.js';
-import { requestPath } from './routes.js';
+import { requestPath } from './request.js';
 import { CHANGE_PASSWORD_WELL_KNOWN_PATH, SECURITY_TXT_PATH } from './well-known.js';
 /**
  * What a client is told to wait when the operator named no return time: long
@@ -14,11 +13,6 @@ import { CHANGE_PASSWORD_WELL_KNOWN_PATH, SECURITY_TXT_PATH } from './well-known
 const DEFAULT_RETRY_AFTER_SECONDS = 600;
 /** Never stored: a cached 503 would outlive the maintenance it announced. */
 const NO_STORE = 'no-store';
-/**
- * A signed-in admin's view of the public site during maintenance is theirs
- * alone, so no shared cache may keep it and hand it to a stranger.
- */
-const PRIVATE_NO_STORE = 'private, no-store';
 const STATIC_PAGE = `<!doctype html>
 <html lang="en">
   <head>
@@ -69,16 +63,16 @@ function isExempt(pathname) {
  * comment form applies: a live session naming a user who still exists.
  */
 export const maintenanceGate = async (c, next) => {
-    const window = c.var.maintenance();
+    const { on, until } = await c.var.maintenance();
     const pathname = requestPath(c);
-    if (window === undefined || isExempt(pathname))
+    if (!on || isExempt(pathname))
         return await next();
-    if (signedInCommenter(c) !== undefined) {
+    if (signedInAccount(c) !== undefined) {
         await next();
-        c.res.headers.set('cache-control', PRIVATE_NO_STORE);
+        c.res.headers.set('cache-control', PRIVATE_CACHE_CONTROL);
         return;
     }
-    return unavailable(c, pathname, window.until);
+    return unavailable(c, pathname, until === '' ? undefined : new Date(until));
 };
 function unavailable(c, pathname, until) {
     const upcoming = until !== undefined && until > c.var.config.now() ? until : undefined;

package/dist/web/maintenance.js.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../src/web/maintenance.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../src/web/maintenance.ts"],"names":[],"mappings":"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"}

package/dist/web/manifest.d.ts

@@ -1,7 +1,7 @@
 import type { ManifestIcon } from '../images/icons.ts';
 import type { ImageConfig } from '../images/paths.ts';
 import type { ConditionalHeaders } from './negotiate.ts';
-import type { ThemeColors } from './themes.ts';
+import type { ThemeColors } from '../theme/themes.ts';
 /**
  * The web app manifest (TASK-147): what a browser reads before it offers to
  * install the site, and what a launcher draws it with.