@plumix/core 0.1.0

package/dist/route/compile.d.ts

@@ -0,0 +1,15 @@
+import type { PluginRegistry } from "../plugin/manifest.js";
+import type { RouteRule } from "./intent.js";
+export declare const DEFAULT_REWRITE_RULE_PRIORITY = 10;
+export declare const FRAMEWORK_FRONT_PAGE_PATTERN = "/page/:page(\\d+)";
+export declare const FRAMEWORK_SEARCH_BARE_PATTERN = "/search";
+export declare const FRAMEWORK_SEARCH_QUERY_PATTERN = "/search/:query";
+export declare const FRAMEWORK_SEARCH_PAGINATED_PATTERN = "/search/:query/page/:page(\\d+)";
+/**
+ * Compile the route map from the plugin registry. Auto-generates single +
+ * archive rules for each public post type, appends explicit
+ * `registerRewriteRule` entries, sorts ascending by priority. Identical raw
+ * patterns throw — the error names both offending plugins.
+ */
+export declare function compileRouteMap(registry: PluginRegistry): readonly RouteRule[];
+//# sourceMappingURL=compile.d.ts.map

package/dist/route/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/route/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,aAAa,CAAC;AAI1D,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAShD,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,6BAA6B,YAAY,CAAC;AACvD,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAC/D,eAAO,MAAM,kCAAkC,oCACZ,CAAC;AAMpC;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,GACvB,SAAS,SAAS,EAAE,CAgEtB"}

package/dist/route/compile.js

@@ -0,0 +1,205 @@
+import { RouteCompileError } from "./errors.js";
+const AUTO_ROUTE_PRIORITY = 50;
+export const DEFAULT_REWRITE_RULE_PRIORITY = 10;
+// Framework-owned routes sort ahead of explicit rewrites so a plugin's
+// catch-all can't shadow `/page/N`.
+const FRAMEWORK_ROUTE_PRIORITY = 5;
+// Empty-baseSlug single patterns (`/:slug` or `/:path+`) match everything
+// at the URL root, so they sort after sibling-plugin auto rules to keep
+// resolution order-independent.
+const CATCH_ALL_ROUTE_PRIORITY = 60;
+export const FRAMEWORK_FRONT_PAGE_PATTERN = "/page/:page(\\d+)";
+export const FRAMEWORK_SEARCH_BARE_PATTERN = "/search";
+export const FRAMEWORK_SEARCH_QUERY_PATTERN = "/search/:query";
+export const FRAMEWORK_SEARCH_PAGINATED_PATTERN = "/search/:query/page/:page(\\d+)";
+/**
+ * Compile the route map from the plugin registry. Auto-generates single +
+ * archive rules for each public post type, appends explicit
+ * `registerRewriteRule` entries, sorts ascending by priority. Identical raw
+ * patterns throw — the error names both offending plugins.
+ */
+export function compileRouteMap(registry) {
+    const rules = [
+        {
+            // `(\d+)` lets a hierarchical pages plugin keep `/page/:path+`.
+            pattern: new URLPattern({ pathname: FRAMEWORK_FRONT_PAGE_PATTERN }),
+            rawPattern: FRAMEWORK_FRONT_PAGE_PATTERN,
+            intent: { kind: "front-page" },
+            priority: FRAMEWORK_ROUTE_PRIORITY,
+            registeredBy: null,
+        },
+        // Paginated variant goes first so `/search/foo/page/2` doesn't
+        // accidentally match the bare-query rule with `:query = "foo/page/2"`
+        // when URLPattern relaxes its segment captures.
+        {
+            pattern: new URLPattern({ pathname: FRAMEWORK_SEARCH_PAGINATED_PATTERN }),
+            rawPattern: FRAMEWORK_SEARCH_PAGINATED_PATTERN,
+            intent: { kind: "search" },
+            priority: FRAMEWORK_ROUTE_PRIORITY,
+            registeredBy: null,
+        },
+        {
+            pattern: new URLPattern({ pathname: FRAMEWORK_SEARCH_QUERY_PATTERN }),
+            rawPattern: FRAMEWORK_SEARCH_QUERY_PATTERN,
+            intent: { kind: "search" },
+            priority: FRAMEWORK_ROUTE_PRIORITY,
+            registeredBy: null,
+        },
+        {
+            pattern: new URLPattern({ pathname: FRAMEWORK_SEARCH_BARE_PATTERN }),
+            rawPattern: FRAMEWORK_SEARCH_BARE_PATTERN,
+            intent: { kind: "search" },
+            priority: FRAMEWORK_ROUTE_PRIORITY,
+            registeredBy: null,
+        },
+    ];
+    // Taxonomies emit before entry types so that a slug collision (e.g. a
+    // post type with `rewrite.slug: 'category'` shadowing a `category`
+    // taxonomy) resolves taxonomy-first under the stable-sort tie-break.
+    // WP-faithful: `\$wp_rewrite->rules` orders taxonomy archives ahead of
+    // post-type singles.
+    for (const taxonomy of registry.termTaxonomies.values()) {
+        if (taxonomy.isPublic === false)
+            continue;
+        for (const rule of autoRulesForTermTaxonomy(taxonomy))
+            rules.push(rule);
+    }
+    for (const entryType of registry.entryTypes.values()) {
+        if (entryType.isPublic === false)
+            continue;
+        for (const rule of autoRulesForEntryType(entryType))
+            rules.push(rule);
+    }
+    for (const registered of registry.rewriteRules) {
+        rules.push({
+            pattern: new URLPattern({ pathname: registered.pattern }),
+            rawPattern: registered.pattern,
+            intent: registered.intent,
+            priority: registered.priority,
+            registeredBy: registered.registeredBy,
+        });
+    }
+    assertUniquePatterns(rules);
+    rules.sort((a, b) => a.priority - b.priority);
+    return rules;
+}
+function autoRulesForEntryType(entryType) {
+    const baseSlug = entryType.rewrite?.slug ?? entryType.name;
+    const archiveSlug = archiveSlugFor(entryType, baseSlug);
+    const rules = [];
+    if (archiveSlug !== null) {
+        const basePattern = `/${archiveSlug}`;
+        const paginatedPattern = `${basePattern}/page/:page`;
+        const intent = {
+            kind: "archive",
+            entryType: entryType.name,
+        };
+        // Paginated variant goes first so /shop/page/2 doesn't accidentally
+        // match the bare archive's URLPattern (it wouldn't today, but keep
+        // the more-specific rule earlier as a defensive ordering invariant).
+        rules.push({
+            pattern: new URLPattern({ pathname: paginatedPattern }),
+            rawPattern: paginatedPattern,
+            intent,
+            priority: AUTO_ROUTE_PRIORITY,
+            registeredBy: entryType.registeredBy,
+        });
+        rules.push({
+            pattern: new URLPattern({ pathname: basePattern }),
+            rawPattern: basePattern,
+            intent,
+            priority: AUTO_ROUTE_PRIORITY,
+            registeredBy: entryType.registeredBy,
+        });
+    }
+    // Hierarchical entry types match nested URLs like /about/team/leadership
+    // via URLPattern's `:path+` catch-all. Plugins can opt out per-type
+    // (rewrite.isHierarchical: false), which keeps the flat `:slug` pattern
+    // even when the data is hierarchical — same opt-out semantics
+    // `buildEntryPermalink` honors via `shouldNestUnderEntryParent`.
+    const capture = exposesHierarchicalUrls(entryType) ? ":path+" : ":slug";
+    const singlePattern = baseSlug === "" ? `/${capture}` : `/${baseSlug}/${capture}`;
+    rules.push({
+        pattern: new URLPattern({ pathname: singlePattern }),
+        rawPattern: singlePattern,
+        intent: { kind: "single", entryType: entryType.name },
+        priority: baseSlug === "" ? CATCH_ALL_ROUTE_PRIORITY : AUTO_ROUTE_PRIORITY,
+        registeredBy: entryType.registeredBy,
+    });
+    return rules;
+}
+/**
+ * True when a registered entry type or taxonomy exposes nested URLs via
+ * `:path+`. `isHierarchical: true` is the data flag (the tree exists);
+ * `rewrite.isHierarchical: false` opts URLs back to the flat single-
+ * segment pattern even when the data is hierarchical — same opt-out the
+ * outbound permalink helpers honor.
+ */
+function exposesHierarchicalUrls(spec) {
+    if (spec.isHierarchical !== true)
+        return false;
+    return spec.rewrite?.isHierarchical !== false;
+}
+function autoRulesForTermTaxonomy(taxonomy) {
+    const baseSlug = taxonomy.rewrite?.slug ?? taxonomy.name;
+    // Mirror the entry-type branch: hierarchical taxonomies expose nested
+    // term URLs via `:path+` (e.g. /region/europe/france); the
+    // rewrite.isHierarchical:false override keeps the flat `:term` shape
+    // even when the term tree itself is hierarchical.
+    const capture = exposesHierarchicalUrls(taxonomy) ? ":path+" : ":term";
+    const basePattern = `/${baseSlug}/${capture}`;
+    const paginatedPattern = `${basePattern}/page/:page`;
+    const intent = { kind: "taxonomy", taxonomy: taxonomy.name };
+    return [
+        {
+            pattern: new URLPattern({ pathname: paginatedPattern }),
+            rawPattern: paginatedPattern,
+            intent,
+            priority: AUTO_ROUTE_PRIORITY,
+            registeredBy: taxonomy.registeredBy,
+        },
+        {
+            pattern: new URLPattern({ pathname: basePattern }),
+            rawPattern: basePattern,
+            intent,
+            priority: AUTO_ROUTE_PRIORITY,
+            registeredBy: taxonomy.registeredBy,
+        },
+    ];
+}
+// Archive slugs need to be a single path segment — slashes would let a
+// plugin silently shadow other routes. Empty is reserved (would match
+// `front-page`).
+const ARCHIVE_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
+function archiveSlugFor(entryType, baseSlug) {
+    const { hasArchive } = entryType;
+    if (!hasArchive)
+        return null;
+    if (typeof hasArchive === "string") {
+        if (!ARCHIVE_SLUG_RE.test(hasArchive)) {
+            throw RouteCompileError.invalidArchiveSlug({
+                entryType: entryType.name,
+                hasArchive,
+            });
+        }
+        return hasArchive;
+    }
+    if (baseSlug === "")
+        return null;
+    return baseSlug;
+}
+function assertUniquePatterns(rules) {
+    const first = new Map();
+    for (const rule of rules) {
+        const existing = first.get(rule.rawPattern);
+        if (existing !== undefined) {
+            throw RouteCompileError.duplicateRewriteRule({
+                rawPattern: rule.rawPattern,
+                firstOwner: existing,
+                secondOwner: rule.registeredBy,
+            });
+        }
+        first.set(rule.rawPattern, rule.registeredBy);
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/route/compile.js.map

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

package/dist/route/current.d.ts

@@ -0,0 +1,56 @@
+import type { AppContext } from "../context/app.js";
+/**
+ * The "current request entity" — populated by the public-route resolver
+ * after URL → entity matching. Consumers (breadcrumbs, canonical tags,
+ * the menu plugin's `isCurrent` detection) read it via `AppContext` to
+ * answer "is this the page we're currently rendering."
+ *
+ * Archive routes set the `archive` variant carrying the entry type
+ * being listed. Single routes set the `entry` variant with the resolved
+ * row id. Term-archive routes will set `term` once the route module
+ * supports them — the variant is declared now so consumers can branch
+ * on it without a future migration.
+ */
+export type ResolvedEntity = {
+    readonly kind: "entry";
+    readonly id: number;
+} | {
+    readonly kind: "term";
+    readonly id: number;
+} | {
+    readonly kind: "archive";
+    readonly entryType: string;
+};
+/**
+ * Discriminated source the menu plugin (and similar consumers) pass when
+ * asking "is this thing the current page". Mirrors the menu item's
+ * `source` shape but adds a `url` carrier for custom-URL items, which
+ * have no upstream id.
+ */
+export type CurrentSource = {
+    readonly kind: "entry";
+    readonly id: number;
+} | {
+    readonly kind: "term";
+    readonly id: number;
+} | {
+    readonly kind: "custom";
+    readonly url: string;
+};
+/**
+ * Returns `true` when `source` identifies the current request entity.
+ *
+ * - `entry` / `term`: id-based match against `ctx.resolvedEntity`.
+ *   Survives URL changes (query strings, trailing slashes) because
+ *   the comparison is by id, not by path string. Returns `false` when
+ *   `resolvedEntity` is null (non-public route, 404, login page).
+ *   Match keys on `(kind, id)` only — relies on `entries.id` /
+ *   `terms.id` global uniqueness within their table.
+ * - `custom`: pathname-based match against `ctx.request.url`, with
+ *   trailing-slash normalization on both sides. Cross-origin sources
+ *   never match (an external link is by definition not the current
+ *   page). Custom URLs have no id to match against; `resolvedEntity`
+ *   is ignored on this path.
+ */
+export declare function isCurrentSource(ctx: AppContext, source: CurrentSource): boolean;
+//# sourceMappingURL=current.d.ts.map

package/dist/route/current.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current.d.ts","sourceRoot":"","sources":["../../src/route/current.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,aAAa,GACpB,OAAO,CAOT"}

package/dist/route/current.js

@@ -0,0 +1,50 @@
+/**
+ * Returns `true` when `source` identifies the current request entity.
+ *
+ * - `entry` / `term`: id-based match against `ctx.resolvedEntity`.
+ *   Survives URL changes (query strings, trailing slashes) because
+ *   the comparison is by id, not by path string. Returns `false` when
+ *   `resolvedEntity` is null (non-public route, 404, login page).
+ *   Match keys on `(kind, id)` only — relies on `entries.id` /
+ *   `terms.id` global uniqueness within their table.
+ * - `custom`: pathname-based match against `ctx.request.url`, with
+ *   trailing-slash normalization on both sides. Cross-origin sources
+ *   never match (an external link is by definition not the current
+ *   page). Custom URLs have no id to match against; `resolvedEntity`
+ *   is ignored on this path.
+ */
+export function isCurrentSource(ctx, source) {
+    if (source.kind === "custom") {
+        return matchesPathname(ctx.request.url, source.url);
+    }
+    const resolved = ctx.resolvedEntity;
+    if (!resolved)
+        return false;
+    return resolved.kind === source.kind && resolved.id === source.id;
+}
+function matchesPathname(requestUrl, sourceUrl) {
+    let here;
+    let target;
+    try {
+        here = new URL(requestUrl).pathname;
+        target = new URL(sourceUrl, requestUrl);
+    }
+    catch {
+        return false;
+    }
+    // Cross-origin sources are never the "current page" — an external link
+    // is by definition somewhere else, even if its pathname coincides with
+    // ours. Compared against the request's host (resolved against the
+    // request URL so a relative `/about` sees the same host as `here`).
+    const requestHost = new URL(requestUrl).host;
+    if (target.host !== requestHost)
+        return false;
+    return (normalizeTrailingSlash(here) === normalizeTrailingSlash(target.pathname));
+}
+function normalizeTrailingSlash(pathname) {
+    if (pathname.length > 1 && pathname.endsWith("/")) {
+        return pathname.slice(0, -1);
+    }
+    return pathname;
+}
+//# sourceMappingURL=current.js.map

package/dist/route/current.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current.js","sourceRoot":"","sources":["../../src/route/current.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAe,EACf,MAAqB;IAErB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC;IACpC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB,EAAE,SAAiB;IAC5D,IAAI,IAAY,CAAC;IACjB,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC;QACpC,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,kEAAkE;IAClE,oEAAoE;IACpE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAE9C,OAAO,CACL,sBAAsB,CAAC,IAAI,CAAC,KAAK,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/route/edit-mode.d.ts

@@ -0,0 +1,20 @@
+/** Render mode, shared vocabulary with the runtime's `useIsEditing`/`useIsPreview`. */
+type EditRenderMode = "live" | "preview" | "edit";
+export interface EditModeDecision {
+    readonly mode: EditRenderMode;
+    /** Ship + boot the editor runtime into the SSR output. */
+    readonly injectRuntime: boolean;
+    readonly bypassCache: boolean;
+}
+/** The decision for an ordinary visitor render — the common case. */
+export declare const LIVE_EDIT_MODE: EditModeDecision;
+export declare function resolveEditMode(input: {
+    /** `?plumix.edit` present on the request URL. */
+    readonly editParam: boolean;
+    /** Viewer can edit this entry (false when there is no session). */
+    readonly canEdit: boolean;
+    /** A valid `?preview=<token>` grants draft visibility for this entry. */
+    readonly previewGrant: boolean;
+}): EditModeDecision;
+export {};
+//# sourceMappingURL=edit-mode.d.ts.map

package/dist/route/edit-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-mode.d.ts","sourceRoot":"","sources":["../../src/route/edit-mode.ts"],"names":[],"mappings":"AAIA,uFAAuF;AACvF,KAAK,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAKhC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,gBAI5B,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,GAAG,gBAAgB,CAWnB"}

package/dist/route/edit-mode.js

@@ -0,0 +1,22 @@
+// The visual-editor edit gate: the security truth table deciding whether a
+// request renders live/preview/edit and whether to ship the editor runtime.
+// Kept separate from the `ctx` wiring in resolve.ts so it stays auditable.
+/** The decision for an ordinary visitor render — the common case. */
+export const LIVE_EDIT_MODE = {
+    mode: "live",
+    injectRuntime: false,
+    bypassCache: false,
+};
+export function resolveEditMode(input) {
+    // The runtime boots only for an authorized editor who asked for it. A
+    // leaked `?plumix.edit` without the capability falls through to the
+    // normal preview/live path below — never edit.
+    if (input.editParam && input.canEdit) {
+        return { mode: "edit", injectRuntime: true, bypassCache: true };
+    }
+    if (input.previewGrant) {
+        return { mode: "preview", injectRuntime: false, bypassCache: true };
+    }
+    return { mode: "live", injectRuntime: false, bypassCache: false };
+}
+//# sourceMappingURL=edit-mode.js.map

package/dist/route/edit-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-mode.js","sourceRoot":"","sources":["../../src/route/edit-mode.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAgB3E,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,KAO/B;IACC,sEAAsE;IACtE,oEAAoE;IACpE,+CAA+C;IAC/C,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACpE,CAAC"}

package/dist/route/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class RouteCompileError extends Error {
+    readonly code: "invalid_archive_slug" | "duplicate_rewrite_rule";
+    readonly entryType: string | undefined;
+    readonly hasArchive: string | undefined;
+    readonly rawPattern: string | undefined;
+    readonly firstOwner: string | null | undefined;
+    readonly secondOwner: string | null | undefined;
+    private constructor();
+    static invalidArchiveSlug(ctx: {
+        entryType: string;
+        hasArchive: string;
+    }): RouteCompileError;
+    static duplicateRewriteRule(ctx: {
+        rawPattern: string;
+        firstOwner: string | null;
+        secondOwner: string | null;
+    }): RouteCompileError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/route/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/route/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IAK1C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEhD,OAAO;IAoBP,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB;IASrB,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,GAAG,iBAAiB;CAQtB"}

package/dist/route/errors.js

@@ -0,0 +1,32 @@
+export class RouteCompileError extends Error {
+    static {
+        RouteCompileError.prototype.name = "RouteCompileError";
+    }
+    code;
+    entryType;
+    hasArchive;
+    rawPattern;
+    firstOwner;
+    secondOwner;
+    constructor(code, message, fields) {
+        super(message);
+        this.code = code;
+        this.entryType = fields.entryType;
+        this.hasArchive = fields.hasArchive;
+        this.rawPattern = fields.rawPattern;
+        this.firstOwner = fields.firstOwner;
+        this.secondOwner = fields.secondOwner;
+    }
+    static invalidArchiveSlug(ctx) {
+        return new RouteCompileError("invalid_archive_slug", `Entry type "${ctx.entryType}" has invalid hasArchive "${ctx.hasArchive}" — ` +
+            `expected a single lowercase kebab-case path segment.`, ctx);
+    }
+    static duplicateRewriteRule(ctx) {
+        return new RouteCompileError("duplicate_rewrite_rule", `Rewrite rule "${ctx.rawPattern}" is registered twice ` +
+            `(by ${formatOwner(ctx.firstOwner)} and ${formatOwner(ctx.secondOwner)}).`, ctx);
+    }
+}
+function formatOwner(plugin) {
+    return plugin === null ? "core" : `plugin "${plugin}"`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/route/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/route/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C;QACE,iBAAiB,CAAC,SAAS,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACzD,CAAC;IAEQ,IAAI,CAAoD;IACxD,SAAS,CAAqB;IAC9B,UAAU,CAAqB;IAC/B,UAAU,CAAqB;IAC/B,UAAU,CAA4B;IACtC,WAAW,CAA4B;IAEhD,YACE,IAAuD,EACvD,OAAe,EACf,MAMC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,GAGzB;QACC,OAAO,IAAI,iBAAiB,CAC1B,sBAAsB,EACtB,eAAe,GAAG,CAAC,SAAS,6BAA6B,GAAG,CAAC,UAAU,MAAM;YAC3E,sDAAsD,EACxD,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,GAI3B;QACC,OAAO,IAAI,iBAAiB,CAC1B,wBAAwB,EACxB,iBAAiB,GAAG,CAAC,UAAU,wBAAwB;YACrD,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAC5E,GAAG,CACJ,CAAC;IACJ,CAAC;CACF;AAED,SAAS,WAAW,CAAC,MAAqB;IACxC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC;AACzD,CAAC"}

package/dist/route/intent.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Discriminated union describing what a matched URL represents. Resolved
+ * into a Response by the public-route resolver. URL params (slug, term,
+ * page) live on `RouteMatch.params`, not on the intent itself — the
+ * intent describes the *route shape*, the match carries the request.
+ *
+ * `search` / `front-page` / `handler` / `redirect` land when a plugin
+ * actually needs them.
+ */
+export type RouteIntent = {
+    readonly kind: "single";
+    readonly entryType: string;
+} | {
+    readonly kind: "archive";
+    readonly entryType: string;
+} | {
+    readonly kind: "taxonomy";
+    readonly taxonomy: string;
+} | {
+    readonly kind: "front-page";
+} | {
+    readonly kind: "search";
+};
+/**
+ * Compiled rule. `priority` preserves arch-doc ordering semantics — lower
+ * number wins. Explicit `registerRewriteRule` defaults to 10; auto-generated
+ * rules from `hasArchive` / `rewrite.slug` land at 50.
+ */
+export interface RouteRule {
+    readonly pattern: URLPattern;
+    readonly rawPattern: string;
+    readonly intent: RouteIntent;
+    readonly priority: number;
+}
+//# sourceMappingURL=intent.d.ts.map

package/dist/route/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/route/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/route/intent.js

@@ -0,0 +1 @@
+//# sourceMappingURL=intent.js.map

package/dist/route/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/route/intent.ts"],"names":[],"mappings":""}

package/dist/route/match.d.ts

@@ -0,0 +1,7 @@
+import type { RouteIntent, RouteRule } from "./intent.js";
+export interface RouteMatch {
+    readonly intent: RouteIntent;
+    readonly params: Record<string, string>;
+}
+export declare function matchRoute(url: URL, rules: readonly RouteRule[]): RouteMatch | null;
+//# sourceMappingURL=match.d.ts.map

package/dist/route/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/route/match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B,UAAU,GAAG,IAAI,CAOnB"}

package/dist/route/match.js

@@ -0,0 +1,18 @@
+export function matchRoute(url, rules) {
+    for (const rule of rules) {
+        const result = rule.pattern.exec({ pathname: url.pathname });
+        if (result === null)
+            continue;
+        return { intent: rule.intent, params: extractParams(result.pathname) };
+    }
+    return null;
+}
+function extractParams(pathname) {
+    const out = {};
+    for (const [key, value] of Object.entries(pathname.groups)) {
+        if (typeof value === "string")
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=match.js.map

package/dist/route/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/route/match.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CACxB,GAAQ,EACR,KAA2B;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CACpB,QAAmC;IAEnC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/route/paginate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pagination math shared by the archive and taxonomy resolvers. Pure
+ * function so the two resolvers can't drift on boundary conditions —
+ * any rule about "what counts as out of range" lives here, in one place,
+ * with a single set of tests.
+ *
+ * `total === 0` is intentionally **not** out of range when `page === 1`
+ * — an empty archive renders the 200 empty-state page, mirroring how
+ * #224's taxonomy resolver treats a term that exists but has no entries
+ * tagged with it.
+ */
+interface PaginateInput {
+    readonly page: number;
+    readonly perPage: number;
+    readonly total: number;
+}
+interface PaginateResult {
+    readonly offset: number;
+    readonly limit: number;
+    readonly totalPages: number;
+    readonly outOfRange: boolean;
+}
+export declare function paginate(input: PaginateInput): PaginateResult;
+export {};
+//# sourceMappingURL=paginate.d.ts.map

package/dist/route/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../src/route/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAW7D"}

package/dist/route/paginate.js

@@ -0,0 +1,24 @@
+/**
+ * Pagination math shared by the archive and taxonomy resolvers. Pure
+ * function so the two resolvers can't drift on boundary conditions —
+ * any rule about "what counts as out of range" lives here, in one place,
+ * with a single set of tests.
+ *
+ * `total === 0` is intentionally **not** out of range when `page === 1`
+ * — an empty archive renders the 200 empty-state page, mirroring how
+ * #224's taxonomy resolver treats a term that exists but has no entries
+ * tagged with it.
+ */
+export function paginate(input) {
+    const { page, perPage, total } = input;
+    const totalPages = Math.max(1, Math.ceil(total / perPage));
+    const validPage = Number.isInteger(page) && page >= 1;
+    const inRange = validPage && (total === 0 ? page === 1 : page <= totalPages);
+    return {
+        offset: Math.max(0, (page - 1) * perPage),
+        limit: perPage,
+        totalPages,
+        outOfRange: !inRange,
+    };
+}
+//# sourceMappingURL=paginate.js.map

package/dist/route/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../src/route/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;IAC7E,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;QACzC,KAAK,EAAE,OAAO;QACd,UAAU;QACV,UAAU,EAAE,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC"}

package/dist/route/path-chain.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Inbound counterpart to `permalink.ts` — given the segments captured
+ * by a `:path+` URLPattern match, find the leaf entity (entry or term)
+ * whose parent chain exactly matches the URL.
+ *
+ * The leaf is looked up by `(table, slug)` (single indexed lookup); for
+ * multi-segment URLs the leaf's ancestor chain is then loaded via the
+ * same recursive CTE `buildEntryPermalink` / `buildTermArchiveUrl` use
+ * to produce nested URLs in the outbound direction. The two sides
+ * round-trip on the same data.
+ *
+ * Returns `null` on any chain mismatch (extra segments, missing
+ * intermediate, wrong ancestor slug). The route matcher falls through
+ * to the next rule rather than 404'ing — WordPress's first-match-wins
+ * semantics.
+ */
+import type { AppContext } from "../context/app.js";
+import type { Entry } from "../db/schema/entries.js";
+import type { Term } from "../db/schema/terms.js";
+export declare function findEntryByPath(ctx: AppContext, entryType: string, segments: readonly string[]): Promise<Entry | null>;
+export declare function findTermByPath(ctx: AppContext, taxonomy: string, segments: readonly string[]): Promise<Term | null>;
+//# sourceMappingURL=path-chain.d.ts.map

package/dist/route/path-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-chain.d.ts","sourceRoot":"","sources":["../../src/route/path-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAOlD,wBAAsB,eAAe,CACnC,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA4BvB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAkBtB"}