@plumix/core 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/debug-bar/panels/template.d.ts +5 -8
  2. package/dist/debug-bar/panels/template.d.ts.map +1 -1
  3. package/dist/debug-bar/panels/template.js +22 -8
  4. package/dist/debug-bar/panels/template.js.map +1 -1
  5. package/dist/debug-bar/primitives.d.ts +1 -1
  6. package/dist/debug-bar/primitives.d.ts.map +1 -1
  7. package/dist/debug-bar/primitives.js +1 -1
  8. package/dist/debug-bar/primitives.js.map +1 -1
  9. package/dist/debug-bar/styles.d.ts.map +1 -1
  10. package/dist/debug-bar/styles.js +9 -14
  11. package/dist/debug-bar/styles.js.map +1 -1
  12. package/dist/debug-bar/template-node-label.d.ts.map +1 -1
  13. package/dist/debug-bar/template-node-label.js +0 -2
  14. package/dist/debug-bar/template-node-label.js.map +1 -1
  15. package/dist/index.d.ts +7 -6
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +4 -3
  18. package/dist/index.js.map +1 -1
  19. package/dist/route/render/render-template.d.ts +6 -4
  20. package/dist/route/render/render-template.d.ts.map +1 -1
  21. package/dist/route/render/render-template.js +36 -48
  22. package/dist/route/render/render-template.js.map +1 -1
  23. package/dist/route/render/resolved-entry.d.ts +10 -5
  24. package/dist/route/render/resolved-entry.d.ts.map +1 -1
  25. package/dist/route/render/template-builders.d.ts +72 -0
  26. package/dist/route/render/template-builders.d.ts.map +1 -0
  27. package/dist/route/render/template-builders.js +113 -0
  28. package/dist/route/render/template-builders.js.map +1 -0
  29. package/dist/route/render/template-hierarchy.d.ts +53 -38
  30. package/dist/route/render/template-hierarchy.d.ts.map +1 -1
  31. package/dist/route/render/template-hierarchy.js +127 -74
  32. package/dist/route/render/template-hierarchy.js.map +1 -1
  33. package/dist/route/resolve.d.ts +3 -3
  34. package/dist/route/resolve.d.ts.map +1 -1
  35. package/dist/route/resolve.js +30 -32
  36. package/dist/route/resolve.js.map +1 -1
  37. package/dist/runtime/app.d.ts +0 -8
  38. package/dist/runtime/app.d.ts.map +1 -1
  39. package/dist/runtime/app.js +0 -38
  40. package/dist/runtime/app.js.map +1 -1
  41. package/dist/runtime/dispatcher.d.ts.map +1 -1
  42. package/dist/runtime/dispatcher.js +4 -7
  43. package/dist/runtime/dispatcher.js.map +1 -1
  44. package/dist/template-deps.js +1 -1
  45. package/dist/template-registry.d.ts +57 -0
  46. package/dist/template-registry.d.ts.map +1 -0
  47. package/dist/template-registry.js +1 -0
  48. package/dist/template-registry.js.map +1 -0
  49. package/dist/template.d.ts +2 -2
  50. package/dist/test/default-theme.d.ts.map +1 -1
  51. package/dist/test/default-theme.js +7 -6
  52. package/dist/test/default-theme.js.map +1 -1
  53. package/dist/theme-errors.d.ts +0 -3
  54. package/dist/theme-errors.d.ts.map +1 -1
  55. package/dist/theme-errors.js +7 -18
  56. package/dist/theme-errors.js.map +1 -1
  57. package/dist/theme.d.ts +59 -23
  58. package/dist/theme.d.ts.map +1 -1
  59. package/dist/theme.js +21 -10
  60. package/dist/theme.js.map +1 -1
  61. package/dist/welcome-theme.d.ts +2 -2
  62. package/dist/welcome-theme.d.ts.map +1 -1
  63. package/dist/welcome-theme.js +7 -6
  64. package/dist/welcome-theme.js.map +1 -1
  65. package/package.json +7 -7
  66. package/dist/route/render/archive-props.d.ts +0 -39
  67. package/dist/route/render/archive-props.d.ts.map +0 -1
  68. package/dist/route/render/archive-props.js +0 -32
  69. package/dist/route/render/archive-props.js.map +0 -1
@@ -0,0 +1,72 @@
1
+ import type { EntryProjection, EntryTypeName, MetaOf, TermProjection, TermTaxonomyName } from "../../template-registry.js";
2
+ import type { TemplateData, TemplateEntry, TemplateRule, ThemeDescriptor } from "../../theme.js";
3
+ import type { ArchiveData, EntryData, ErrorData, FrontPageData, SearchData, TaxonomyData } from "./resolved-entry.js";
4
+ /** Universal catch-all — matches any resolved node. */
5
+ export declare function fallback(template: TemplateEntry<TemplateData>): TemplateRule;
6
+ /** A single entry (any type). */
7
+ export declare function entry(template: TemplateEntry<EntryData>): TemplateRule;
8
+ /** A content-type archive listing. */
9
+ export declare function archive(template: TemplateEntry<ArchiveData>): TemplateRule;
10
+ /** A term archive (any taxonomy). */
11
+ export declare function taxonomy(template: TemplateEntry<TaxonomyData>): TemplateRule;
12
+ /** The static front page. */
13
+ export declare function frontPage(template: TemplateEntry<FrontPageData>): TemplateRule;
14
+ /** Search results. */
15
+ export declare function search(template: TemplateEntry<SearchData>): TemplateRule;
16
+ /** The 404 handler. */
17
+ export declare function notFound(template: TemplateEntry<ErrorData>): TemplateRule;
18
+ /** The 500 handler. */
19
+ export declare function serverError(template: TemplateEntry<ErrorData>): TemplateRule;
20
+ /**
21
+ * Normalize a theme's `templates` to a rule array — the array form as-is, or a
22
+ * bare component wrapped as the fallback tier.
23
+ */
24
+ export declare function templateRules(templates: ThemeDescriptor["templates"]): readonly TemplateRule[];
25
+ /**
26
+ * Reserved entry-meta key holding an author's `named`-template choice — the
27
+ * editor writes it, the resolver reads it. Part of the `__plumix_*` namespace.
28
+ */
29
+ export declare const NAMED_TEMPLATE_META_KEY = "__plumix_template";
30
+ interface EntrySelector<K extends EntryTypeName> {
31
+ /** Bind the template for the selected entry. */
32
+ template(t: TemplateEntry<EntryData<EntryProjection<K>>>): TemplateRule;
33
+ }
34
+ interface EntryTypeBuilder<K extends EntryTypeName> extends EntrySelector<K> {
35
+ /** Narrow to one entry by slug. */
36
+ slug(slug: string): EntrySelector<K>;
37
+ /** Narrow to one entry by numeric id. */
38
+ id(id: number): EntrySelector<K>;
39
+ /** Narrow by an entry-meta value, typed against the type's meta projection. */
40
+ whereMeta<M extends keyof MetaOf<K>>(key: M, value: MetaOf<K>[M]): EntrySelector<K>;
41
+ /** Narrow by an arbitrary predicate over the resolved data. */
42
+ where(predicate: (data: EntryData<EntryProjection<K>>) => boolean): EntrySelector<K>;
43
+ /** Register an author-selectable template, matched from stored entry meta. */
44
+ named(id: string, label: string): EntrySelector<K>;
45
+ /** The content-type archive listing. */
46
+ readonly archive: {
47
+ template(t: TemplateEntry<ArchiveData<EntryProjection<K>>>): TemplateRule;
48
+ };
49
+ }
50
+ /**
51
+ * Target a registered entry type. `name` autocompletes and rejects typos
52
+ * (`keyof EntryTypeRegistry`); the template's `data.entry` is typed from the
53
+ * type's projection.
54
+ */
55
+ export declare function forEntryType<K extends EntryTypeName>(name: K): EntryTypeBuilder<K>;
56
+ interface TaxonomySelector<K extends TermTaxonomyName> {
57
+ /** Bind the template for the selected term(s). */
58
+ template(t: TemplateEntry<TaxonomyData<TermProjection<K>>>): TemplateRule;
59
+ }
60
+ interface TermTaxonomyBuilder<K extends TermTaxonomyName> extends TaxonomySelector<K> {
61
+ /** Narrow to one term by slug. */
62
+ slug(slug: string): TaxonomySelector<K>;
63
+ /** Narrow to one term by numeric id. */
64
+ id(id: number): TaxonomySelector<K>;
65
+ }
66
+ /**
67
+ * Target a registered taxonomy. `name` autocompletes and rejects typos; the
68
+ * template's `data.term` is typed from the taxonomy's term projection.
69
+ */
70
+ export declare function forTermTaxonomy<K extends TermTaxonomyName>(name: K): TermTaxonomyBuilder<K>;
71
+ export {};
72
+ //# sourceMappingURL=template-builders.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-builders.d.ts","sourceRoot":"","sources":["../../../src/route/render/template-builders.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ // The per-tier data type is erased to the union in the stored rule. Each
2
+ // builder types its input to the tier's data shape (so `data.entry`/`data.term`
3
+ // are typed at the call site), then erases on output — the resolver only ever
4
+ // invokes a rule's template with the matching node's data, so the erasure is
5
+ // sound and it keeps the `templates` array a homogeneous element type.
6
+ function rule(tier, template) {
7
+ return { tier, template: template };
8
+ }
9
+ /** Universal catch-all — matches any resolved node. */
10
+ export function fallback(template) {
11
+ return rule("fallback", template);
12
+ }
13
+ /** A single entry (any type). */
14
+ export function entry(template) {
15
+ return rule("entry", template);
16
+ }
17
+ /** A content-type archive listing. */
18
+ export function archive(template) {
19
+ return rule("archive", template);
20
+ }
21
+ /** A term archive (any taxonomy). */
22
+ export function taxonomy(template) {
23
+ return rule("taxonomy", template);
24
+ }
25
+ /** The static front page. */
26
+ export function frontPage(template) {
27
+ return rule("frontPage", template);
28
+ }
29
+ /** Search results. */
30
+ export function search(template) {
31
+ return rule("search", template);
32
+ }
33
+ /** The 404 handler. */
34
+ export function notFound(template) {
35
+ return rule("notFound", template);
36
+ }
37
+ /** The 500 handler. */
38
+ export function serverError(template) {
39
+ return rule("serverError", template);
40
+ }
41
+ /**
42
+ * Normalize a theme's `templates` to a rule array — the array form as-is, or a
43
+ * bare component wrapped as the fallback tier.
44
+ */
45
+ export function templateRules(templates) {
46
+ // `Array.isArray` widens a `readonly T[]` to `any[]`, so re-assert the element
47
+ // type on the array branch rather than leaning on the narrowing.
48
+ return Array.isArray(templates)
49
+ ? templates
50
+ : [fallback(templates)];
51
+ }
52
+ // ── Targeted builders ───────────────────────────────────────────────────────
53
+ // `forEntryType`/`forTermTaxonomy` produce match rules keyed off the registered
54
+ // names. Each selector types the template to the tier's data shape (with the
55
+ // registry projection) and erases to the union like the generic builders above.
56
+ function matchRule(match, template) {
57
+ return {
58
+ match,
59
+ template: template,
60
+ };
61
+ }
62
+ /**
63
+ * Reserved entry-meta key holding an author's `named`-template choice — the
64
+ * editor writes it, the resolver reads it. Part of the `__plumix_*` namespace.
65
+ */
66
+ export const NAMED_TEMPLATE_META_KEY = "__plumix_template";
67
+ /** A predicate matching when a content entry's meta value equals `value`. */
68
+ function metaEquals(key, value) {
69
+ return (data) => "entry" in data && data.entry.meta[key] === value;
70
+ }
71
+ /**
72
+ * Target a registered entry type. `name` autocompletes and rejects typos
73
+ * (`keyof EntryTypeRegistry`); the template's `data.entry` is typed from the
74
+ * type's projection.
75
+ */
76
+ export function forEntryType(name) {
77
+ // Each selector adds its narrowing to the shared content-node prefix.
78
+ const content = (extra) => ({
79
+ template: (t) => matchRule({ nodeKind: "content", type: name, ...extra }, t),
80
+ });
81
+ return {
82
+ template: (t) => matchRule({ nodeKind: "content", type: name }, t),
83
+ slug: (slug) => content({ slug }),
84
+ id: (id) => content({ id }),
85
+ whereMeta: (key, value) => content({ predicate: metaEquals(String(key), value) }),
86
+ where: (predicate) => content({
87
+ predicate: predicate,
88
+ }),
89
+ named: (id, label) => content({
90
+ named: { id, label },
91
+ predicate: metaEquals(NAMED_TEMPLATE_META_KEY, id),
92
+ }),
93
+ archive: {
94
+ template: (t) => matchRule({ nodeKind: "content-type-archive", type: name }, t),
95
+ },
96
+ };
97
+ }
98
+ /**
99
+ * Target a registered taxonomy. `name` autocompletes and rejects typos; the
100
+ * template's `data.term` is typed from the taxonomy's term projection.
101
+ */
102
+ export function forTermTaxonomy(name) {
103
+ return {
104
+ template: (t) => matchRule({ nodeKind: "term", type: name }, t),
105
+ slug: (slug) => ({
106
+ template: (t) => matchRule({ nodeKind: "term", type: name, slug }, t),
107
+ }),
108
+ id: (id) => ({
109
+ template: (t) => matchRule({ nodeKind: "term", type: name, id }, t),
110
+ }),
111
+ };
112
+ }
113
+ //# sourceMappingURL=template-builders.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"template-builders.js","sourceRoot":"","sources":["../../../src/route/render/template-builders.ts"],"names":[],"mappings":"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"}
@@ -1,31 +1,14 @@
1
1
  /**
2
- * The WordPress template hierarchy, ported to a typed React world.
2
+ * Template resolution for the array-based `templates`. `resolveTemplate` walks a
3
+ * theme's rules — targeted matchers (`forEntryType`/`forTermTaxonomy`) in
4
+ * declaration order, then the generic tier for the node's kind, then the
5
+ * universal `fallback`. `resolveErrorTemplate` looks up the 404/500 tiers.
3
6
  *
4
- * `getPossibleTemplates(node)` is a pure function returning the ordered
5
- * candidate template names a theme can register for a given resolved
6
- * request. The render pipeline walks this list greedy-first-match
7
- * against the registered template map.
8
- *
9
- * Mirrors WordPress's hierarchy verbatim — including the `category-…` /
10
- * `tag-…` aliases for the built-in taxonomies (a hard-coded WP rule that
11
- * predates the generic `taxonomy-{tax}-…` chain) and the fall-through to
12
- * `archive` / `index`. Faust.js exposes the same shape from
13
- * `getTemplate.ts`; the two implementations should produce identical
14
- * candidate lists for the same input.
15
- *
16
- * `resolveTemplateCandidates(node, hooks)` is the async orchestrator the
17
- * renderer calls: it runs the pure walker, then applies the
18
- * `template:hierarchy` filter chain so plugins can mutate the list.
7
+ * The `ResolvedNode` shapes carry the identity the resolver matches on (kind +
8
+ * type + slug/id).
19
9
  */
20
- import type { HookExecutor } from "../../hooks/registry.js";
21
- declare module "../../hooks/types.js" {
22
- interface FilterRegistry {
23
- "template:hierarchy": (candidates: readonly string[], ctx: {
24
- readonly node: ResolvedNode;
25
- }) => readonly string[] | Promise<readonly string[]>;
26
- }
27
- }
28
- export type ResolvedNode = ResolvedTermNode | ResolvedContentNode | ResolvedContentTypeArchive | ResolvedFrontPage | ResolvedPostsPage | ResolvedSearch;
10
+ import type { TemplateData, TemplateRule } from "../../theme.js";
11
+ export type ResolvedNode = ResolvedTermNode | ResolvedContentNode | ResolvedContentTypeArchive | ResolvedFrontPage | ResolvedSearch;
29
12
  interface ResolvedTermNode {
30
13
  readonly kind: "term";
31
14
  readonly taxonomy: string;
@@ -45,24 +28,56 @@ interface ResolvedContentTypeArchive {
45
28
  interface ResolvedFrontPage {
46
29
  readonly kind: "front-page";
47
30
  }
31
+ interface ResolvedSearch {
32
+ readonly kind: "search";
33
+ }
48
34
  /**
49
- * The "posts page" when a site assigns a page as the blog home in
50
- * Settings Reading. Falls through to `home` then `index`. Distinct from
51
- * `front-page` because the front page may or may not be the posts page.
35
+ * Resolve a node to its template rule from a theme's `templates` array:
36
+ * (1) targeted rules (`forEntryType`/`forTermTaxonomy`, incl. `whereMeta`/`where`/
37
+ * `named` predicates) in declaration order, first match wins; (2) the generic
38
+ * tier for the node's kind; (3) the universal `fallback`. Returns `undefined`
39
+ * when nothing matches — the caller then renders the `notFound` (404) template.
40
+ * `data` is required for predicate rules to match.
52
41
  */
53
- interface ResolvedPostsPage {
54
- readonly kind: "posts-page";
42
+ export declare function resolveTemplate(rules: readonly TemplateRule[], node: ResolvedNode, data?: TemplateData): TemplateRule | undefined;
43
+ /**
44
+ * Look up an error-tier template (`notFound` → 404, `serverError` → 500).
45
+ * Separate from `resolveTemplate` because error pages are triggered by a
46
+ * condition (no match, or a render throw), not by a resolved node.
47
+ */
48
+ export declare function resolveErrorTemplate(rules: readonly TemplateRule[], tier: "notFound" | "serverError"): TemplateRule | undefined;
49
+ /**
50
+ * A short human label for a rule — its tier, or (for a targeted rule) the type
51
+ * plus any `:slug` / `#id` narrowing. Used by the debug bar and as the
52
+ * normalize-error slot name.
53
+ */
54
+ export declare function ruleLabel(rule: TemplateRule): string;
55
+ /** What happened to a rule during resolution. */
56
+ type ResolutionStatus = "matched" | "skipped" | "never-evaluated";
57
+ export interface ResolutionStep {
58
+ readonly label: string;
59
+ readonly status: ResolutionStatus;
60
+ /**
61
+ * Present for a targeted rule carrying a `whereMeta`/`where`/`named`
62
+ * predicate. `fired` is whether the predicate function actually ran (its
63
+ * rule's identity matched and `data` was present); `result` is its return.
64
+ */
65
+ readonly predicate?: {
66
+ readonly fired: boolean;
67
+ readonly result: boolean;
68
+ };
55
69
  }
56
- interface ResolvedSearch {
57
- readonly kind: "search";
70
+ export interface ResolutionTrace {
71
+ readonly steps: readonly ResolutionStep[];
72
+ /** The winning rule's label, or `null` when nothing matched (a 404). */
73
+ readonly winner: string | null;
58
74
  }
59
- export declare function getPossibleTemplates(node: ResolvedNode): readonly string[];
60
75
  /**
61
- * The async orchestrator the renderer calls: runs the pure walker, then
62
- * applies the `template:hierarchy` filter chain. Kept separate from the
63
- * pure walker so unit tests don't need a HookRegistry to exercise the
64
- * branching logic.
76
+ * Replay `resolveTemplate` and classify every rule for the debug bar: which one
77
+ * won, which targeted rules were evaluated-but-skipped (with their predicate
78
+ * result), and which were never reached because an earlier zone already won.
79
+ * Dev-only — `resolveTemplate` stays allocation-free on the render hot path.
65
80
  */
66
- export declare function resolveTemplateCandidates(node: ResolvedNode, hooks: HookExecutor): Promise<readonly string[]>;
81
+ export declare function explainTemplateResolution(rules: readonly TemplateRule[], node: ResolvedNode, data?: TemplateData): ResolutionTrace;
67
82
  export {};
68
83
  //# sourceMappingURL=template-hierarchy.d.ts.map
@@ -1 +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"}
1
+ {"version":3,"file":"template-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/route/render/template-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAGV,YAAY,EACZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,0BAA0B,GAC1B,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,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAsDD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,IAAI,EAAE,YAAY,EAClB,IAAI,CAAC,EAAE,YAAY,GAClB,YAAY,GAAG,SAAS,CAW1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,IAAI,EAAE,UAAU,GAAG,aAAa,GAC/B,YAAY,GAAG,SAAS,CAE1B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CASpD;AAED,iDAAiD;AACjD,KAAK,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5E;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,IAAI,EAAE,YAAY,EAClB,IAAI,CAAC,EAAE,YAAY,GAClB,eAAe,CAoCjB"}
@@ -1,88 +1,141 @@
1
1
  /**
2
- * The WordPress template hierarchy, ported to a typed React world.
2
+ * Template resolution for the array-based `templates`. `resolveTemplate` walks a
3
+ * theme's rules — targeted matchers (`forEntryType`/`forTermTaxonomy`) in
4
+ * declaration order, then the generic tier for the node's kind, then the
5
+ * universal `fallback`. `resolveErrorTemplate` looks up the 404/500 tiers.
3
6
  *
4
- * `getPossibleTemplates(node)` is a pure function returning the ordered
5
- * candidate template names a theme can register for a given resolved
6
- * request. The render pipeline walks this list greedy-first-match
7
- * against the registered template map.
8
- *
9
- * Mirrors WordPress's hierarchy verbatim including the `category-…` /
10
- * `tag-…` aliases for the built-in taxonomies (a hard-coded WP rule that
11
- * predates the generic `taxonomy-{tax}-…` chain) and the fall-through to
12
- * `archive` / `index`. Faust.js exposes the same shape from
13
- * `getTemplate.ts`; the two implementations should produce identical
14
- * candidate lists for the same input.
15
- *
16
- * `resolveTemplateCandidates(node, hooks)` is the async orchestrator the
17
- * renderer calls: it runs the pure walker, then applies the
18
- * `template:hierarchy` filter chain so plugins can mutate the list.
7
+ * The `ResolvedNode` shapes carry the identity the resolver matches on (kind +
8
+ * type + slug/id).
9
+ */
10
+ // Maps each resolved-node kind to the generic tier that renders it. `fallback`
11
+ // (universal) and the `notFound`/`serverError` handlers are not node-matched —
12
+ // the former is the terminal, the latter fire on a condition, not a node.
13
+ const GENERIC_TIER_FOR_NODE = {
14
+ content: "entry",
15
+ "content-type-archive": "archive",
16
+ term: "taxonomy",
17
+ "front-page": "frontPage",
18
+ search: "search",
19
+ };
20
+ /**
21
+ * The identity part of a match: node kind + type name, then the optional
22
+ * `slug`/`id` narrowing — an unset selector matches any.
19
23
  */
20
- export function getPossibleTemplates(node) {
21
- const candidates = [];
24
+ function matchesIdentity(match, node) {
25
+ if (match.nodeKind !== node.kind)
26
+ return false;
22
27
  switch (node.kind) {
23
- case "term":
24
- appendTermNodeCandidates(node, candidates);
25
- break;
26
- case "content":
27
- appendContentNodeCandidates(node, candidates);
28
- break;
29
28
  case "content-type-archive":
30
- candidates.push(`archive-${node.entryType}`, "archive");
31
- break;
32
- case "front-page":
33
- candidates.push("front-page", "home");
34
- break;
35
- case "posts-page":
36
- candidates.push("home");
37
- break;
38
- case "search":
39
- candidates.push("search");
40
- break;
29
+ return match.type === node.entryType;
30
+ case "content":
31
+ return (match.type === node.entryType &&
32
+ (match.slug === undefined || match.slug === node.slug) &&
33
+ (match.id === undefined || match.id === node.databaseId));
34
+ case "term":
35
+ return (match.type === node.taxonomy &&
36
+ (match.slug === undefined || match.slug === node.slug) &&
37
+ (match.id === undefined || match.id === node.databaseId));
38
+ default:
39
+ return false;
41
40
  }
42
- candidates.push("index");
43
- return candidates;
44
41
  }
45
42
  /**
46
- * The async orchestrator the renderer calls: runs the pure walker, then
47
- * applies the `template:hierarchy` filter chain. Kept separate from the
48
- * pure walker so unit tests don't need a HookRegistry to exercise the
49
- * branching logic.
43
+ * Does a targeted matcher apply? Identity first, then the optional data
44
+ * predicate (`whereMeta`/`where`/`named`) which needs the resolved data, so a
45
+ * predicate rule never matches when `data` is absent.
50
46
  */
51
- export async function resolveTemplateCandidates(node, hooks) {
52
- const initial = getPossibleTemplates(node);
53
- return hooks.applyFilter("template:hierarchy", initial, { node });
47
+ function matchesNode(match, node, data) {
48
+ if (!matchesIdentity(match, node))
49
+ return false;
50
+ if (match.predicate === undefined)
51
+ return true;
52
+ return data !== undefined && match.predicate(data);
54
53
  }
55
- function appendTermNodeCandidates(node, out) {
56
- // Built-in taxonomies retain their WP-historical aliases. New taxonomies
57
- // (registered via `registerTermTaxonomy('region', …)`) flow through the
58
- // generic `taxonomy-{tax}-…` chain below.
59
- if (node.taxonomy === "category" || node.taxonomy === "tag") {
60
- out.push(`${node.taxonomy}-${node.slug}`);
61
- out.push(`${node.taxonomy}-${node.databaseId}`);
62
- out.push(node.taxonomy);
63
- }
64
- else {
65
- out.push(`taxonomy-${node.taxonomy}-${node.slug}`);
66
- out.push(`taxonomy-${node.taxonomy}-${node.databaseId}`);
67
- out.push(`taxonomy-${node.taxonomy}`);
68
- out.push("taxonomy");
54
+ /**
55
+ * Resolve a node to its template rule from a theme's `templates` array:
56
+ * (1) targeted rules (`forEntryType`/`forTermTaxonomy`, incl. `whereMeta`/`where`/
57
+ * `named` predicates) in declaration order, first match wins; (2) the generic
58
+ * tier for the node's kind; (3) the universal `fallback`. Returns `undefined`
59
+ * when nothing matches — the caller then renders the `notFound` (404) template.
60
+ * `data` is required for predicate rules to match.
61
+ */
62
+ export function resolveTemplate(rules, node, data) {
63
+ for (const rule of rules) {
64
+ if (rule.match !== undefined && matchesNode(rule.match, node, data)) {
65
+ return rule;
66
+ }
69
67
  }
70
- out.push("archive");
68
+ const tier = GENERIC_TIER_FOR_NODE[node.kind];
69
+ return (rules.find((r) => r.tier === tier) ??
70
+ rules.find((r) => r.tier === "fallback"));
71
71
  }
72
- function appendContentNodeCandidates(node, out) {
73
- // `page` short-circuits the `single` chain — page-{slug}, page-{id}, page,
74
- // then singular. Every other entry type (post + custom CPTs) walks the
75
- // full single-* chain.
76
- if (node.entryType === "page") {
77
- out.push(`page-${node.slug}`);
78
- out.push(`page-${node.databaseId}`);
79
- out.push("page");
80
- }
81
- else {
82
- out.push(`single-${node.entryType}-${node.slug}`);
83
- out.push(`single-${node.entryType}`);
84
- out.push("single");
85
- }
86
- out.push("singular");
72
+ /**
73
+ * Look up an error-tier template (`notFound` 404, `serverError` → 500).
74
+ * Separate from `resolveTemplate` because error pages are triggered by a
75
+ * condition (no match, or a render throw), not by a resolved node.
76
+ */
77
+ export function resolveErrorTemplate(rules, tier) {
78
+ return rules.find((r) => r.tier === tier);
79
+ }
80
+ /**
81
+ * A short human label for a rule — its tier, or (for a targeted rule) the type
82
+ * plus any `:slug` / `#id` narrowing. Used by the debug bar and as the
83
+ * normalize-error slot name.
84
+ */
85
+ export function ruleLabel(rule) {
86
+ if (rule.tier !== undefined)
87
+ return rule.tier;
88
+ const m = rule.match;
89
+ if (m === undefined)
90
+ return "?";
91
+ let sel = "";
92
+ if (m.slug !== undefined)
93
+ sel = `:${m.slug}`;
94
+ else if (m.id !== undefined)
95
+ sel = `#${m.id}`;
96
+ const prefix = m.nodeKind === "content-type-archive" ? "archive:" : "";
97
+ return `${prefix}${m.type}${sel}`;
98
+ }
99
+ /**
100
+ * Replay `resolveTemplate` and classify every rule for the debug bar: which one
101
+ * won, which targeted rules were evaluated-but-skipped (with their predicate
102
+ * result), and which were never reached because an earlier zone already won.
103
+ * Dev-only — `resolveTemplate` stays allocation-free on the render hot path.
104
+ */
105
+ export function explainTemplateResolution(rules, node, data) {
106
+ const winner = resolveTemplate(rules, node, data);
107
+ // The targeted walk stops at the first matching targeted rule. If the winner
108
+ // is targeted, only rules up to it were evaluated; otherwise every targeted
109
+ // rule was tried and skipped.
110
+ const winnerIsTargeted = winner?.match !== undefined;
111
+ const winnerIndex = winner ? rules.indexOf(winner) : -1;
112
+ const steps = rules.map((rule, index) => {
113
+ const label = ruleLabel(rule);
114
+ let status;
115
+ if (rule === winner) {
116
+ status = "matched";
117
+ }
118
+ else if (rule.match !== undefined) {
119
+ const evaluated = !winnerIsTargeted || index < winnerIndex;
120
+ status = evaluated ? "skipped" : "never-evaluated";
121
+ }
122
+ else {
123
+ status = "never-evaluated";
124
+ }
125
+ const match = rule.match;
126
+ if (match?.predicate !== undefined && status !== "never-evaluated") {
127
+ // A predicate only runs after identity matches and when data is present.
128
+ if (data !== undefined && matchesIdentity(match, node)) {
129
+ return {
130
+ label,
131
+ status,
132
+ predicate: { fired: true, result: match.predicate(data) },
133
+ };
134
+ }
135
+ return { label, status, predicate: { fired: false, result: false } };
136
+ }
137
+ return { label, status };
138
+ });
139
+ return { steps, winner: winner ? ruleLabel(winner) : null };
87
140
  }
88
141
  //# sourceMappingURL=template-hierarchy.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"template-hierarchy.js","sourceRoot":"","sources":["../../../src/route/render/template-hierarchy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"template-hierarchy.js","sourceRoot":"","sources":["../../../src/route/render/template-hierarchy.ts"],"names":[],"mappings":"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"}
@@ -3,15 +3,15 @@ import type { RegisteredTemplateDep } from "../template-deps.js";
3
3
  import type { DocumentManifest, ThemeDescriptor } from "../theme.js";
4
4
  import type { RouteMatch } from "./match.js";
5
5
  import type { AssetManifest } from "./render/asset-manifest.js";
6
- import type { ArchiveData, FrontPageData, SearchData, SingleData, TaxonomyData } from "./render/resolved-entry.js";
6
+ import type { ArchiveData, EntryData, FrontPageData, SearchData, TaxonomyData } from "./render/resolved-entry.js";
7
7
  declare module "../hooks/types.js" {
8
8
  interface FilterRegistry {
9
- "resolve:single:data": (data: SingleData) => SingleData | Promise<SingleData>;
9
+ "resolve:single:data": (data: EntryData) => EntryData | Promise<EntryData>;
10
10
  "resolve:archive:data": (data: ArchiveData) => ArchiveData | Promise<ArchiveData>;
11
11
  "resolve:term:data": (data: TaxonomyData) => TaxonomyData | Promise<TaxonomyData>;
12
12
  "resolve:front-page:data": (data: FrontPageData) => FrontPageData | Promise<FrontPageData>;
13
13
  "resolve:search:data": (data: SearchData) => SearchData | Promise<SearchData>;
14
14
  }
15
15
  }
16
- export declare function resolvePublicRoute(ctx: AppContext, match: RouteMatch, theme: ThemeDescriptor, document: DocumentManifest, templateDocuments: ReadonlyMap<string, DocumentManifest>, templateDeps: ReadonlyMap<string, RegisteredTemplateDep>, assetManifest: AssetManifest): Promise<Response>;
16
+ export declare function resolvePublicRoute(ctx: AppContext, match: RouteMatch, theme: ThemeDescriptor, document: DocumentManifest, templateDeps: ReadonlyMap<string, RegisteredTemplateDep>, assetManifest: AssetManifest): Promise<Response>;
17
17
  //# sourceMappingURL=resolve.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/route/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,UAAU,EACV,YAAY,EACb,MAAM,4BAA4B,CAAC;AAoBpC,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB,qBAAqB,EAAE,CACrB,IAAI,EAAE,UAAU,KACb,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,sBAAsB,EAAE,CACtB,IAAI,EAAE,WAAW,KACd,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACxC,mBAAmB,EAAE,CACnB,IAAI,EAAE,YAAY,KACf,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,yBAAyB,EAAE,CACzB,IAAI,EAAE,aAAa,KAChB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAC5C,qBAAqB,EAAE,CACrB,IAAI,EAAE,UAAU,KACb,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;KACvC;CACF;AAID,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACxD,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAwDnB"}
1
+ {"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/route/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACb,MAAM,4BAA4B,CAAC;AAoBpC,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB,qBAAqB,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3E,sBAAsB,EAAE,CACtB,IAAI,EAAE,WAAW,KACd,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACxC,mBAAmB,EAAE,CACnB,IAAI,EAAE,YAAY,KACf,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,yBAAyB,EAAE,CACzB,IAAI,EAAE,aAAa,KAChB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAC5C,qBAAqB,EAAE,CACrB,IAAI,EAAE,UAAU,KACb,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;KACvC;CACF;AAaD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACxD,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAmDnB"}