@plumix/core 0.2.0 → 0.4.0

package/dist/route/render/resolved-entry.d.ts

@@ -4,10 +4,11 @@ import type { Term } from "../../db/schema/terms.js";
 /** Public-safe author projection — query select narrows away email + auth columns. */
 export interface ResolvedAuthor {
     readonly id: number;
+    readonly slug: string;
     readonly name: string | null;
     readonly avatarUrl: string | null;
 }
-interface ResolvedTerm extends Term {
+export interface ResolvedTerm extends Term {
     readonly url: string | null;
 }
 export interface ResolvedEntry extends Entry {
@@ -16,7 +17,8 @@ export interface ResolvedEntry extends Entry {
     readonly author: ResolvedAuthor;
     readonly url: string | null;
 }
-export interface SingleData<TEntry extends ResolvedEntry = ResolvedEntry> {
+export interface EntryData<TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "entry";
     readonly entry: TEntry;
 }
 export interface Pagination {
@@ -26,33 +28,72 @@ export interface Pagination {
     readonly pageCount: number;
 }
 export interface ArchiveData<TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "archive";
     readonly contentType: string;
     readonly entries: readonly TEntry[];
     readonly pagination: Pagination;
 }
-export interface TaxonomyData<TEntry extends ResolvedEntry = ResolvedEntry> {
+export interface TaxonomyData<TTerm extends ResolvedTerm = ResolvedTerm, TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "taxonomy";
     readonly taxonomy: string;
-    readonly term: ResolvedTerm;
+    readonly term: TTerm;
+    readonly entries: readonly TEntry[];
+    readonly pagination: Pagination;
+}
+/**
+ * Payload for an author archive (`/authors/{slug}`). Carries the resolved author
+ * as the subject (like `TaxonomyData.term`) plus their published entries.
+ */
+export interface AuthorArchiveData<TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "author";
+    readonly author: ResolvedAuthor;
+    readonly entries: readonly TEntry[];
+    readonly pagination: Pagination;
+}
+/**
+ * Payload for a date archive (`/YYYY[/MM[/DD]]`). `year` is always set;
+ * `month`/`day` are 1-based and `null` at a coarser granularity (a year archive
+ * has `month: null, day: null`).
+ */
+export interface DateArchiveData<TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "date";
+    readonly year: number;
+    readonly month: number | null;
+    readonly day: number | null;
     readonly entries: readonly TEntry[];
     readonly pagination: Pagination;
 }
 export interface FrontPageData<TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "frontPage";
     readonly entries: readonly TEntry[];
     readonly pagination: Pagination;
 }
 export interface SearchData<TEntry extends ResolvedEntry = ResolvedEntry> {
+    readonly kind: "search";
     readonly query: string;
     readonly entries: readonly TEntry[];
     readonly pagination: Pagination;
 }
+/**
+ * Base payload for a plugin-registered archive (`registerArchiveType`). The
+ * `kind`/`name` discriminate it; a plugin extends this with its own fields
+ * (entries, pagination, whatever the archive lists) and declares the extended
+ * shape in `ArchiveTypeRegistry` so `forArchiveType(name)` types `data`. Core
+ * only ever sees the base — the resolver and template come from the plugin.
+ */
+export interface CustomArchiveData {
+    readonly kind: "custom";
+    /** The registered archive-type name (`registerArchiveType(name, …)`). */
+    readonly name: string;
+}
 /**
  * Payload threaded to a theme's `404` / `500` template. Public-safe by
  * shape — there is no Error field, so internal exception messages have
  * no path to the rendered output.
  */
 export interface ErrorData {
+    readonly kind: "error";
     readonly request: Request;
     readonly hint?: string;
 }
-export {};
 //# sourceMappingURL=resolved-entry.d.ts.map

package/dist/route/render/resolved-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolved-entry.d.ts","sourceRoot":"","sources":["../../../src/route/render/resolved-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAKD,UAAU,YAAa,SAAQ,IAAI;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAQD,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,QAAQ,CAAC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAMD,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"resolved-entry.d.ts","sourceRoot":"","sources":["../../../src/route/render/resolved-entry.ts"],"names":[],"mappings":"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"}

package/dist/route/render/template-builders.d.ts

@@ -0,0 +1,124 @@
+import type { ArchiveDataOf, ArchiveTypeName, EntryProjection, EntryTypeName, MetaOf, TermMetaOf, TermProjection, TermTaxonomyName } from "../../template-registry.js";
+import type { TemplateData, TemplateEntry, TemplateRule, ThemeDescriptor } from "../../theme.js";
+import type { ArchiveData, AuthorArchiveData, DateArchiveData, EntryData, ErrorData, FrontPageData, SearchData, TaxonomyData } from "./resolved-entry.js";
+/** Universal catch-all — matches any resolved node. */
+export declare function fallback(template: TemplateEntry<TemplateData>): TemplateRule;
+/** A single entry (any type). */
+export declare function entry(template: TemplateEntry<EntryData>): TemplateRule;
+/** A content-type archive listing. */
+export declare function archive(template: TemplateEntry<ArchiveData>): TemplateRule;
+/** A term archive (any taxonomy). */
+export declare function taxonomy(template: TemplateEntry<TaxonomyData>): TemplateRule;
+/** An author archive (any author). */
+export declare function author(template: TemplateEntry<AuthorArchiveData>): TemplateRule;
+/** A date archive (any year/month/day). */
+export declare function date(template: TemplateEntry<DateArchiveData>): TemplateRule;
+/** The static front page. */
+export declare function frontPage(template: TemplateEntry<FrontPageData>): TemplateRule;
+/** Search results. */
+export declare function search(template: TemplateEntry<SearchData>): TemplateRule;
+/** The 404 handler. */
+export declare function notFound(template: TemplateEntry<ErrorData>): TemplateRule;
+/** The 500 handler. */
+export declare function serverError(template: TemplateEntry<ErrorData>): TemplateRule;
+/**
+ * Normalize a theme's `templates` to a rule array — the array form as-is, or a
+ * bare component wrapped as the fallback tier.
+ */
+export declare function templateRules(templates: ThemeDescriptor["templates"]): readonly TemplateRule[];
+/**
+ * Reserved entry-meta key holding an author's `named`-template choice — the
+ * editor writes it, the resolver reads it. Part of the `__plumix_*` namespace.
+ */
+export declare const NAMED_TEMPLATE_META_KEY = "__plumix_template";
+interface EntrySelector<K extends EntryTypeName> {
+    /** Bind the template for the selected entry. */
+    template(t: TemplateEntry<EntryData<EntryProjection<K>>>): TemplateRule;
+}
+interface EntryTypeBuilder<K extends EntryTypeName> extends EntrySelector<K> {
+    /** Narrow to one entry by slug. */
+    slug(slug: string): EntrySelector<K>;
+    /** Narrow to one entry by numeric id. */
+    id(id: number): EntrySelector<K>;
+    /** Narrow by an entry-meta value, typed against the type's meta projection. */
+    whereMeta<M extends keyof MetaOf<K>>(key: M, value: MetaOf<K>[M]): EntrySelector<K>;
+    /** Narrow by an arbitrary predicate over the resolved data. */
+    where(predicate: (data: EntryData<EntryProjection<K>>) => boolean): EntrySelector<K>;
+    /** Register an author-selectable template, matched from stored entry meta. */
+    named(id: string, label: string): EntrySelector<K>;
+    /** The content-type archive listing. */
+    readonly archive: {
+        template(t: TemplateEntry<ArchiveData<EntryProjection<K>>>): TemplateRule;
+    };
+}
+/**
+ * Target a registered entry type. `name` autocompletes and rejects typos
+ * (`keyof EntryTypeRegistry`); the template's `data.entry` is typed from the
+ * type's projection.
+ */
+export declare function forEntryType<K extends EntryTypeName>(name: K): EntryTypeBuilder<K>;
+interface TaxonomySelector<K extends TermTaxonomyName> {
+    /** Bind the template for the selected term(s). */
+    template(t: TemplateEntry<TaxonomyData<TermProjection<K>>>): TemplateRule;
+}
+interface TermTaxonomyBuilder<K extends TermTaxonomyName> extends TaxonomySelector<K> {
+    /** Narrow to one term by slug. */
+    slug(slug: string): TaxonomySelector<K>;
+    /** Narrow to one term by numeric id. */
+    id(id: number): TaxonomySelector<K>;
+    /** Narrow by a term-meta value, typed against the taxonomy's meta projection. */
+    whereMeta<M extends keyof TermMetaOf<K>>(key: M, value: TermMetaOf<K>[M]): TaxonomySelector<K>;
+    /** Narrow by an arbitrary predicate over the resolved taxonomy data. */
+    where(predicate: (data: TaxonomyData<TermProjection<K>>) => boolean): TaxonomySelector<K>;
+    /** Register an author-selectable template, matched from stored term meta. */
+    named(id: string, label: string): TaxonomySelector<K>;
+}
+/**
+ * Target a registered taxonomy. `name` autocompletes and rejects typos; the
+ * template's `data.term` is typed from the taxonomy's term projection.
+ */
+export declare function forTermTaxonomy<K extends TermTaxonomyName>(name: K): TermTaxonomyBuilder<K>;
+interface AuthorSelector {
+    /** Bind the template for the selected author. */
+    template(t: TemplateEntry<AuthorArchiveData>): TemplateRule;
+}
+interface AuthorBuilder extends AuthorSelector {
+    /** Narrow to one author by slug. */
+    slug(slug: string): AuthorSelector;
+    /** Narrow to one author by numeric id. */
+    id(id: number): AuthorSelector;
+}
+/**
+ * Target author archives. There is a single author "kind" (no registry to
+ * autocomplete), so `forAuthor()` takes no name — chain `.slug(...)` / `.id(...)`
+ * to narrow to one author, mirroring `forEntryType` / `forTermTaxonomy`. The
+ * bare `.template()` matches every author archive (like the `author()` tier).
+ */
+export declare function forAuthor(): AuthorBuilder;
+interface DateSelector {
+    /** Bind the template for the selected period. */
+    template(t: TemplateEntry<DateArchiveData>): TemplateRule;
+}
+/**
+ * Target one date archive. Date components are hierarchical (a month has no
+ * meaning without a year), so `forDate` takes them positionally and matches the
+ * archive of that exact granularity: `forDate(2026)` → the year archive,
+ * `forDate(2026, 7)` → that month, `forDate(2026, 7, 21)` → that day. The
+ * generic `date()` tier styles every date archive.
+ */
+export declare function forDate(year: number): DateSelector;
+export declare function forDate(year: number, month: number): DateSelector;
+export declare function forDate(year: number, month: number, day: number): DateSelector;
+interface ArchiveTypeSelector<K extends ArchiveTypeName> {
+    /** Bind the template for the selected archive type. */
+    template(t: TemplateEntry<ArchiveDataOf<K>>): TemplateRule;
+}
+/**
+ * Target a plugin-registered archive type (`registerArchiveType`). `name`
+ * autocompletes against `ArchiveTypeRegistry` and types the template's `data`
+ * from the registered projection — the same shape as `forEntryType` /
+ * `forTermTaxonomy`, for archives that live in a plugin rather than core.
+ */
+export declare function forArchiveType<K extends ArchiveTypeName>(name: K): ArchiveTypeSelector<K>;
+export {};
+//# sourceMappingURL=template-builders.d.ts.map

package/dist/route/render/template-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-builders.d.ts","sourceRoot":"","sources":["../../../src/route/render/template-builders.ts"],"names":[],"mappings":"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"}

package/dist/route/render/template-builders.js

@@ -0,0 +1,172 @@
+// The per-tier data type is erased to the union in the stored rule. Each
+// builder types its input to the tier's data shape (so `data.entry`/`data.term`
+// are typed at the call site), then erases on output — the resolver only ever
+// invokes a rule's template with the matching node's data, so the erasure is
+// sound and it keeps the `templates` array a homogeneous element type.
+function rule(tier, template) {
+    return { tier, template: template };
+}
+/** Universal catch-all — matches any resolved node. */
+export function fallback(template) {
+    return rule("fallback", template);
+}
+/** A single entry (any type). */
+export function entry(template) {
+    return rule("entry", template);
+}
+/** A content-type archive listing. */
+export function archive(template) {
+    return rule("archive", template);
+}
+/** A term archive (any taxonomy). */
+export function taxonomy(template) {
+    return rule("taxonomy", template);
+}
+/** An author archive (any author). */
+export function author(template) {
+    return rule("author", template);
+}
+/** A date archive (any year/month/day). */
+export function date(template) {
+    return rule("date", template);
+}
+/** The static front page. */
+export function frontPage(template) {
+    return rule("frontPage", template);
+}
+/** Search results. */
+export function search(template) {
+    return rule("search", template);
+}
+/** The 404 handler. */
+export function notFound(template) {
+    return rule("notFound", template);
+}
+/** The 500 handler. */
+export function serverError(template) {
+    return rule("serverError", template);
+}
+/**
+ * Normalize a theme's `templates` to a rule array — the array form as-is, or a
+ * bare component wrapped as the fallback tier.
+ */
+export function templateRules(templates) {
+    // `Array.isArray` widens a `readonly T[]` to `any[]`, so re-assert the element
+    // type on the array branch rather than leaning on the narrowing.
+    return Array.isArray(templates)
+        ? templates
+        : [fallback(templates)];
+}
+// ── Targeted builders ───────────────────────────────────────────────────────
+// `forEntryType`/`forTermTaxonomy` produce match rules keyed off the registered
+// names. Each selector types the template to the tier's data shape (with the
+// registry projection) and erases to the union like the generic builders above.
+function matchRule(match, template) {
+    return {
+        match,
+        template: template,
+    };
+}
+/**
+ * Reserved entry-meta key holding an author's `named`-template choice — the
+ * editor writes it, the resolver reads it. Part of the `__plumix_*` namespace.
+ */
+export const NAMED_TEMPLATE_META_KEY = "__plumix_template";
+/** A predicate matching when a content entry's meta value equals `value`. */
+function metaEquals(key, value) {
+    return (data) => "entry" in data && data.entry.meta[key] === value;
+}
+/** A predicate matching when a resolved term's meta value equals `value`. */
+function termMetaEquals(key, value) {
+    return (data) => "term" in data && data.term.meta[key] === value;
+}
+/**
+ * Target a registered entry type. `name` autocompletes and rejects typos
+ * (`keyof EntryTypeRegistry`); the template's `data.entry` is typed from the
+ * type's projection.
+ */
+export function forEntryType(name) {
+    // Each selector adds its narrowing to the shared content-node prefix.
+    const content = (extra) => ({
+        template: (t) => matchRule({ nodeKind: "content", type: name, ...extra }, t),
+    });
+    return {
+        template: (t) => matchRule({ nodeKind: "content", type: name }, t),
+        slug: (slug) => content({ slug }),
+        id: (id) => content({ id }),
+        whereMeta: (key, value) => content({ predicate: metaEquals(String(key), value) }),
+        where: (predicate) => content({
+            predicate: predicate,
+        }),
+        named: (id, label) => content({
+            named: { id, label },
+            predicate: metaEquals(NAMED_TEMPLATE_META_KEY, id),
+        }),
+        archive: {
+            template: (t) => matchRule({ nodeKind: "content-type-archive", type: name }, t),
+        },
+    };
+}
+/**
+ * Target a registered taxonomy. `name` autocompletes and rejects typos; the
+ * template's `data.term` is typed from the taxonomy's term projection.
+ */
+export function forTermTaxonomy(name) {
+    // Each selector adds its narrowing to the shared term-node prefix.
+    const term = (extra) => ({
+        template: (t) => matchRule({ nodeKind: "term", type: name, ...extra }, t),
+    });
+    return {
+        template: (t) => matchRule({ nodeKind: "term", type: name }, t),
+        slug: (slug) => term({ slug }),
+        id: (id) => term({ id }),
+        whereMeta: (key, value) => term({ predicate: termMetaEquals(String(key), value) }),
+        where: (predicate) => term({
+            predicate: predicate,
+        }),
+        named: (id, label) => term({
+            named: { id, label },
+            predicate: termMetaEquals(NAMED_TEMPLATE_META_KEY, id),
+        }),
+    };
+}
+/**
+ * Target author archives. There is a single author "kind" (no registry to
+ * autocomplete), so `forAuthor()` takes no name — chain `.slug(...)` / `.id(...)`
+ * to narrow to one author, mirroring `forEntryType` / `forTermTaxonomy`. The
+ * bare `.template()` matches every author archive (like the `author()` tier).
+ */
+export function forAuthor() {
+    // Each selector adds its narrowing to the shared author-node prefix.
+    const authorNode = (extra) => ({
+        template: (t) => matchRule({ nodeKind: "author", type: "author", ...extra }, t),
+    });
+    return {
+        template: (t) => matchRule({ nodeKind: "author", type: "author" }, t),
+        slug: (slug) => authorNode({ slug }),
+        id: (id) => authorNode({ id }),
+    };
+}
+export function forDate(year, month, day) {
+    return {
+        template: (t) => matchRule({
+            nodeKind: "date",
+            type: "date",
+            year,
+            ...(month !== undefined ? { month } : {}),
+            ...(day !== undefined ? { day } : {}),
+        }, t),
+    };
+}
+/**
+ * Target a plugin-registered archive type (`registerArchiveType`). `name`
+ * autocompletes against `ArchiveTypeRegistry` and types the template's `data`
+ * from the registered projection — the same shape as `forEntryType` /
+ * `forTermTaxonomy`, for archives that live in a plugin rather than core.
+ */
+export function forArchiveType(name) {
+    return {
+        template: (t) => matchRule({ nodeKind: "custom", type: name }, t),
+    };
+}
+//# sourceMappingURL=template-builders.js.map

package/dist/route/render/template-builders.js.map

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

package/dist/route/render/template-hierarchy.d.ts

@@ -1,37 +1,36 @@
 /**
- * The WordPress template hierarchy, ported to a typed React world.
+ * Template resolution for the array-based `templates`. `resolveTemplate` walks a
+ * theme's rules — targeted matchers (`forEntryType`/`forTermTaxonomy`) in
+ * declaration order, then the generic tier for the node's kind, then the
+ * universal `fallback`. `resolveErrorTemplate` looks up the 404/500 tiers.
  *
- * `getPossibleTemplates(node)` is a pure function returning the ordered
- * candidate template names a theme can register for a given resolved
- * request. The render pipeline walks this list greedy-first-match
- * against the registered template map.
- *
- * Mirrors WordPress's hierarchy verbatim — including the `category-…` /
- * `tag-…` aliases for the built-in taxonomies (a hard-coded WP rule that
- * predates the generic `taxonomy-{tax}-…` chain) and the fall-through to
- * `archive` / `index`. Faust.js exposes the same shape from
- * `getTemplate.ts`; the two implementations should produce identical
- * candidate lists for the same input.
- *
- * `resolveTemplateCandidates(node, hooks)` is the async orchestrator the
- * renderer calls: it runs the pure walker, then applies the
- * `template:hierarchy` filter chain so plugins can mutate the list.
+ * The `ResolvedNode` shapes carry the identity the resolver matches on (kind +
+ * type + slug/id).
  */
-import type { HookExecutor } from "../../hooks/registry.js";
-declare module "../../hooks/types.js" {
-    interface FilterRegistry {
-        "template:hierarchy": (candidates: readonly string[], ctx: {
-            readonly node: ResolvedNode;
-        }) => readonly string[] | Promise<readonly string[]>;
-    }
-}
-export type ResolvedNode = ResolvedTermNode | ResolvedContentNode | ResolvedContentTypeArchive | ResolvedFrontPage | ResolvedPostsPage | ResolvedSearch;
+import type { TemplateData, TemplateRule } from "../../theme.js";
+export type ResolvedNode = ResolvedTermNode | ResolvedContentNode | ResolvedContentTypeArchive | ResolvedAuthorNode | ResolvedDateNode | ResolvedCustomNode | ResolvedFrontPage | ResolvedSearch;
 interface ResolvedTermNode {
     readonly kind: "term";
     readonly taxonomy: string;
     readonly slug: string;
     readonly databaseId: number;
 }
+interface ResolvedAuthorNode {
+    readonly kind: "author";
+    readonly slug: string;
+    readonly databaseId: number;
+}
+interface ResolvedDateNode {
+    readonly kind: "date";
+    readonly year: number;
+    readonly month: number | null;
+    readonly day: number | null;
+}
+interface ResolvedCustomNode {
+    readonly kind: "custom";
+    /** The registered archive-type name (`registerArchiveType`). */
+    readonly name: string;
+}
 interface ResolvedContentNode {
     readonly kind: "content";
     readonly entryType: string;
@@ -45,24 +44,56 @@ interface ResolvedContentTypeArchive {
 interface ResolvedFrontPage {
     readonly kind: "front-page";
 }
+interface ResolvedSearch {
+    readonly kind: "search";
+}
+/**
+ * Resolve a node to its template rule from a theme's `templates` array:
+ * (1) targeted rules (`forEntryType`/`forTermTaxonomy`, incl. `whereMeta`/`where`/
+ * `named` predicates) in declaration order, first match wins; (2) the generic
+ * tier for the node's kind; (3) the universal `fallback`. Returns `undefined`
+ * when nothing matches — the caller then renders the `notFound` (404) template.
+ * `data` is required for predicate rules to match.
+ */
+export declare function resolveTemplate(rules: readonly TemplateRule[], node: ResolvedNode, data?: TemplateData): TemplateRule | undefined;
 /**
- * The "posts page" — when a site assigns a page as the blog home in
- * Settings → Reading. Falls through to `home` then `index`. Distinct from
- * `front-page` because the front page may or may not be the posts page.
+ * Look up an error-tier template (`notFound` → 404, `serverError` → 500).
+ * Separate from `resolveTemplate` because error pages are triggered by a
+ * condition (no match, or a render throw), not by a resolved node.
  */
-interface ResolvedPostsPage {
-    readonly kind: "posts-page";
+export declare function resolveErrorTemplate(rules: readonly TemplateRule[], tier: "notFound" | "serverError"): TemplateRule | undefined;
+/**
+ * A short human label for a rule — its tier, or (for a targeted rule) the type
+ * plus any `:slug` / `#id` narrowing. Used by the debug bar and as the
+ * normalize-error slot name.
+ */
+export declare function ruleLabel(rule: TemplateRule): string;
+/** What happened to a rule during resolution. */
+type ResolutionStatus = "matched" | "skipped" | "never-evaluated";
+export interface ResolutionStep {
+    readonly label: string;
+    readonly status: ResolutionStatus;
+    /**
+     * Present for a targeted rule carrying a `whereMeta`/`where`/`named`
+     * predicate. `fired` is whether the predicate function actually ran (its
+     * rule's identity matched and `data` was present); `result` is its return.
+     */
+    readonly predicate?: {
+        readonly fired: boolean;
+        readonly result: boolean;
+    };
 }
-interface ResolvedSearch {
-    readonly kind: "search";
+export interface ResolutionTrace {
+    readonly steps: readonly ResolutionStep[];
+    /** The winning rule's label, or `null` when nothing matched (a 404). */
+    readonly winner: string | null;
 }
-export declare function getPossibleTemplates(node: ResolvedNode): readonly string[];
 /**
- * The async orchestrator the renderer calls: runs the pure walker, then
- * applies the `template:hierarchy` filter chain. Kept separate from the
- * pure walker so unit tests don't need a HookRegistry to exercise the
- * branching logic.
+ * Replay `resolveTemplate` and classify every rule for the debug bar: which one
+ * won, which targeted rules were evaluated-but-skipped (with their predicate
+ * result), and which were never reached because an earlier zone already won.
+ * Dev-only — `resolveTemplate` stays allocation-free on the render hot path.
  */
-export declare function resolveTemplateCandidates(node: ResolvedNode, hooks: HookExecutor): Promise<readonly string[]>;
+export declare function explainTemplateResolution(rules: readonly TemplateRule[], node: ResolvedNode, data?: TemplateData): ResolutionTrace;
 export {};
 //# sourceMappingURL=template-hierarchy.d.ts.map

package/dist/route/render/template-hierarchy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/route/render/template-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,cAAc;QACtB,oBAAoB,EAAE,CACpB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,GAAG,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;SAAE,KACjC,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;KACrD;CACF;AAED,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,0BAA0B,GAC1B,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,CAAC;AAEnB,UAAU,gBAAgB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED;;;;GAIG;AACH,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAwB1E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAG5B"}
+{"version":3,"file":"template-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/route/render/template-hierarchy.ts"],"names":[],"mappings":"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"}