@sonordev/site-kit 5.3.1 → 5.4.0

package/dist/analytics/send-gate.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @sonordev/site-kit/analytics — the ONE analytics send decision
+ *
+ * SINGLE SOURCE OF TRUTH for "may this document report analytics, and where
+ * to". Every phone-home in the analytics module — page views, journey /
+ * session rows, scroll depth, heatmap clicks, web vitals, custom events,
+ * conversions, and the sitemap-validation read — resolves through
+ * {@link resolveAnalyticsTarget} and sends through {@link analyticsSend} /
+ * {@link analyticsBeacon}. Do NOT call sonorFetch/sonorBeacon directly from
+ * this module, and do not re-fork the credential resolution below; the
+ * eight hand-rolled copies this replaced are exactly how a rule gets fixed
+ * in one place and left broken in seven (see CLAUDE.md, "Code Hygiene").
+ * `send-gate.test.ts` fails the build if a new direct call appears.
+ *
+ * It answers two questions, in this order:
+ *
+ * 1. IS THIS DOCUMENT SOMEONE ELSE'S EMBED? A site loaded in a cross-origin
+ *    iframe must not report traffic against its own Sonor project. The
+ *    visitor is not on that site; they are on whatever page framed it, and
+ *    every metric the frame produces is phantom traffic in the analytics its
+ *    owner reads (and, for an agency, reports to the client).
+ *
+ * 2. IS THERE A CREDENTIAL? Unchanged behavior — no key, no send.
+ *
+ * ─── Why this landed on 2026-09-08, and what was measured ──────────────────
+ *
+ * Upforge case studies embed each client's whole production site in three
+ * eager iframes per study (agency-site-kit `DeviceTrifolio`), and
+ * `securityHeaders`' DEFAULT_FRAME_ANCESTORS has allowed https://upforge.io
+ * to frame every managed site since it was introduced. DeviceTrifolio's own
+ * doc comment reasons that nobody is affected because its cross-origin load
+ * detection can never succeed, so the screenshot overlay never fades. That is
+ * true of the PIXELS and false of the JAVASCRIPT: the overlay is an opacity
+ * layer over a live frame, so the embedded site loads, hydrates and runs its
+ * analytics whether or not it is ever revealed.
+ *
+ * Measured in the Sonor analytics table before this change (2026-09-08), the
+ * signature is unmistakable — from `analytics_page_views`, three views of `/`
+ * sharing ONE session_id and ONE visitor_id, milliseconds apart, with
+ * referrer `https://upforge.io/`:
+ *
+ *   abbeyglenapts.com   20:02:13.852 / .900 / .921   (48ms, 21ms apart)
+ *   goldenmilenky.com   04:12:23.840 / .868 / 24.624
+ *   queencityriverboats 22:12:33.609 / .690 / .784
+ *
+ * Three loads of one page inside 70 milliseconds is not a person; it is the
+ * desktop + tablet + mobile frames of one trifolio, sharing storage because
+ * they share the embedded site's origin. 23 client sites carried this traffic
+ * on the day of the fix, the oldest from 2026-06-11. The widening of
+ * frame-ancestors to upforgelabs.com (upforge-nextjs 0c12be5) does not start
+ * this problem — it multiplies one that was already live.
+ *
+ * ─── Same-origin frames are ALLOWED, deliberately ──────────────────────────
+ *
+ * The block is on CROSS-origin embedding, not on being framed at all. A site
+ * embedding itself (a preview pane, a print view, an on-domain booking frame)
+ * has a real visitor really on that site and no other tenant to pollute, so
+ * it keeps reporting. How that is detected, and why `window.top` rather than
+ * `window.parent`, lives with the primitive in `shared/frame.ts` — this file
+ * owns the analytics POLICY, that file owns the frame FACT.
+ */
+/** Resolved destination for an analytics send. */
+export interface AnalyticsTarget {
+    apiUrl: string;
+    apiKey: string;
+}
+export interface AnalyticsGateOptions {
+    /** `apiUrl` prop, when the caller was given one. Falls back to the window global. */
+    apiUrl?: string;
+    /** `apiKey` prop, when the caller was given one. Falls back to the window global. */
+    apiKey?: string;
+    /**
+     * Opt back in to reporting from inside a cross-origin frame. For a site
+     * deliberately distributed as an embed (a widget, a partner-hosted
+     * booking or menu page) the frame IS the product, and its traffic is real.
+     * Explicit per-site config only — see AnalyticsConfig.allowInFrame. There
+     * is deliberately no window global or env var for this: a silent switch
+     * that turns cross-tenant tracking back on is the failure mode, not the
+     * feature.
+     */
+    allowInFrame?: boolean;
+    /** Emit the one-time diagnostic when a send is suppressed. */
+    debug?: boolean;
+}
+export { isCrossOriginFrame, isFramed, isTopFrameSameOrigin } from '../shared/frame';
+/** Test seam — resets the once-per-document log latch. */
+export declare function __resetSendGate(): void;
+/**
+ * Resolve where an analytics call should go, or `null` if it must not happen.
+ *
+ * Returning `null` is the ONLY "do not send" signal in this module. Callers
+ * that set up listeners or scrape the DOM should resolve first and bail on
+ * `null`, so a cross-origin frame never even attaches a scroll or click
+ * listener — the guard saves the work, not just the request.
+ */
+export declare function resolveAnalyticsTarget(options?: AnalyticsGateOptions): AnalyticsTarget | null;
+/**
+ * POST an analytics payload. Resolves the gate itself and no-ops when it
+ * says no — so a caller that forgets its own early bail still cannot send
+ * from a cross-origin frame. That belt-and-braces is the point: this is the
+ * choke point, and it does not rely on every call site remembering.
+ *
+ * `retries: 0` by default — every analytics endpoint here is non-idempotent
+ * from the client's side (a retried page view after a lost response
+ * double-counts). Never resolves to a rejected promise; tracking must not
+ * break a page.
+ */
+export declare function analyticsSend(path: string, body: unknown, options?: AnalyticsGateOptions & {
+    retries?: number;
+    method?: string;
+    /** Let the request outlive the page (scroll depth flushed on unmount). */
+    keepalive?: boolean;
+}): Promise<Response | null>;
+/**
+ * Unload-time twin of {@link analyticsSend}, through the keepalive beacon so
+ * the credential stays in a header. Gated identically.
+ */
+export declare function analyticsBeacon(path: string, body: unknown, options?: AnalyticsGateOptions): void;
+//# sourceMappingURL=send-gate.d.ts.map

package/dist/analytics/send-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-gate.d.ts","sourceRoot":"","sources":["../../src/analytics/send-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAKH,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAGD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAuBpF,0DAA0D;AAC1D,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,oBAAyB,GACjC,eAAe,GAAG,IAAI,CAmBxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,oBAAoB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAA;CACf,GACL,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAkB1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAIN"}

package/dist/analytics/send-gate.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The cross-origin-frame guard.
+ *
+ * A site loaded inside someone else's page must not report traffic against
+ * its own Sonor project. This is not hypothetical: on 2026-09-08,
+ * `analytics_page_views` held bursts of three views of `/` sharing one
+ * session_id and one visitor_id 21-80ms apart with referrer
+ * `https://upforge.io/` — the desktop/tablet/mobile frames of one
+ * agency-site-kit DeviceTrifolio, across 23 client sites. See send-gate.ts.
+ *
+ * These tests pin the four cases the guard has to get right, and then pin the
+ * structure: ONE place decides, and no module re-forks it.
+ *
+ * Every case asserts against the real transport with `fetch` stubbed, rather
+ * than against the gate's return value alone — "returns null" is not the
+ * promise being made to a client whose analytics this pollutes; "no request
+ * leaves the browser" is.
+ */
+export {};
+//# sourceMappingURL=send-gate.test.d.ts.map

package/dist/analytics/send-gate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-gate.test.d.ts","sourceRoot":"","sources":["../../src/analytics/send-gate.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/blog/AuthorPage.d.ts

@@ -5,5 +5,5 @@
  */
 import React from 'react';
 import type { AuthorPageProps } from './types';
-export declare function AuthorPage({ author, posts, basePath }: AuthorPageProps): React.JSX.Element;
+export declare function AuthorPage({ author, posts, basePath, routing }: AuthorPageProps): React.JSX.Element;
 //# sourceMappingURL=AuthorPage.d.ts.map

package/dist/blog/AuthorPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthorPage.d.ts","sourceRoot":"","sources":["../../src/blog/AuthorPage.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,SAAS,CAAA;AAgKpE,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAkB,EAAE,EAAE,eAAe,qBA8ChF"}
+{"version":3,"file":"AuthorPage.d.ts","sourceRoot":"","sources":["../../src/blog/AuthorPage.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,SAAS,CAAA;AAmKpE,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,eAAe,qBA+C/E"}

package/dist/blog/BlogLayout.d.ts

@@ -6,6 +6,7 @@
  */
 import React from 'react';
 import { BlogSidebarProps } from './BlogSidebar';
+import type { BlogRoutingOptions } from './routes';
 export interface BlogLayoutProps {
     /** Portal API URL */
     apiUrl?: string;
@@ -28,6 +29,7 @@ export interface BlogLayoutProps {
     maxWidth?: number;
     /** Base URL for blog links */
     basePath?: string;
+    routing?: BlogRoutingOptions;
     /** Custom class name */
     className?: string;
     /** Current category (for sidebar highlighting) */
@@ -35,7 +37,7 @@ export interface BlogLayoutProps {
     /** Main content */
     children: React.ReactNode;
 }
-export declare function BlogLayout({ apiUrl, apiKey, layout, showSidebar, sidebarProps, hero, maxWidth, basePath, className, currentCategory, children, }: BlogLayoutProps): Promise<React.JSX.Element>;
+export declare function BlogLayout({ apiUrl, apiKey, layout, showSidebar, sidebarProps, hero, maxWidth, basePath, routing, className, currentCategory, children, }: BlogLayoutProps): Promise<React.JSX.Element>;
 /**
  * Convenience wrapper for a complete blog index page
  */

package/dist/blog/BlogLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlogLayout.d.ts","sourceRoot":"","sources":["../../src/blog/BlogLayout.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAM7D,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,YAAY,CAAA;IACxD,mBAAmB;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACxC,0BAA0B;IAC1B,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,eAAe,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAsB,UAAU,CAAC,EAC/B,MAA4D,EAC5D,MAAwC,EACxC,MAAwB,EACxB,WAAkB,EAClB,YAAiB,EACjB,IAAI,EACJ,QAAe,EACf,QAAkB,EAClB,SAAS,EACT,eAAe,EACf,QAAQ,GACT,EAAE,eAAe,8BA6FjB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IACtE,+BAA+B;IAC/B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAA;CAC/B;AAED,wBAAsB,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,EAAE,aAAa,8BAE9E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IAC1E,+BAA+B;IAC/B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAA;CAC/B;AAED,wBAAsB,YAAY,CAAC,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,EAAE,iBAAiB,8BAMtF;AAMD,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qBAAqB;IACrB,aAAa,EAAE,KAAK,CAAC,SAAS,CAAA;CAC/B;AAED,wBAAsB,YAAY,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,GAAG,WAAW,EACf,EAAE,iBAAiB,8BAYnB"}
+{"version":3,"file":"BlogLayout.d.ts","sourceRoot":"","sources":["../../src/blog/BlogLayout.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAMlD,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,YAAY,CAAA;IACxD,mBAAmB;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACxC,0BAA0B;IAC1B,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,eAAe,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mBAAmB;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAsB,UAAU,CAAC,EAC/B,MAA4D,EAC5D,MAAwC,EACxC,MAAwB,EACxB,WAAkB,EAClB,YAAiB,EACjB,IAAI,EACJ,QAAe,EACf,QAAQ,EACR,OAAO,EACP,SAAS,EACT,eAAe,EACf,QAAQ,GACT,EAAE,eAAe,8BA+FjB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IACtE,+BAA+B;IAC/B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAA;CAC/B;AAED,wBAAsB,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,EAAE,aAAa,8BAE9E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IAC1E,+BAA+B;IAC/B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAA;CAC/B;AAED,wBAAsB,YAAY,CAAC,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,EAAE,iBAAiB,8BAMtF;AAMD,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qBAAqB;IACrB,aAAa,EAAE,KAAK,CAAC,SAAS,CAAA;CAC/B;AAED,wBAAsB,YAAY,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,IAAI,EACJ,GAAG,WAAW,EACf,EAAE,iBAAiB,8BAYnB"}

package/dist/blog/BlogList.d.ts

@@ -11,6 +11,7 @@
  */
 import React from 'react';
 import type { BlogListResult, BlogPost, BlogCategory } from './types';
+import { type BlogRoutingOptions } from './routes';
 export interface BlogListStyles {
     container?: string;
     categoryNav?: string;
@@ -59,6 +60,7 @@ export interface BlogListServerProps {
     showPagination?: boolean;
     className?: string;
     basePath?: string;
+    routing?: BlogRoutingOptions;
     styles?: BlogListStyles;
     unstyled?: boolean;
     renderPost?: (post: BlogPost) => React.ReactNode;
@@ -68,5 +70,5 @@ export interface BlogListServerProps {
         categories: BlogCategory[];
     }) => React.ReactNode;
 }
-export declare function BlogList({ apiUrl, apiKey, category, tag, author, featured, search, cluster, page, perPage, orderBy, order, showCategoryFilter, showPagination, className, basePath, styles, unstyled, renderPost, children, }: BlogListServerProps): Promise<string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined>;
+export declare function BlogList({ apiUrl, apiKey, category, tag, author, featured, search, cluster, page, perPage, orderBy, order, showCategoryFilter, showPagination, className, basePath, routing, styles, unstyled, renderPost, children, }: BlogListServerProps): Promise<string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined>;
 //# sourceMappingURL=BlogList.d.ts.map

package/dist/blog/BlogList.d.ts.map

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

package/dist/blog/BlogPost.d.ts

@@ -12,6 +12,7 @@
  */
 import React from 'react';
 import type { BlogPost as BlogPostType, TocItem } from './types';
+import { type BlogRoutingOptions } from './routes';
 export interface BlogPostStyles {
     article?: string;
     header?: string;
@@ -53,6 +54,7 @@ export interface BlogPostServerProps {
     relatedCount?: number;
     showAuthor?: boolean;
     basePath?: string;
+    routing?: BlogRoutingOptions;
     className?: string;
     styles?: BlogPostStyles;
     unstyled?: boolean;
@@ -63,5 +65,5 @@ export interface BlogPostServerProps {
         relatedPosts: BlogPostType[];
     }) => React.ReactNode;
 }
-export declare function BlogPost({ apiUrl, apiKey, slug, showToc, showRelated, relatedCount, showAuthor, basePath, className, styles, unstyled, siteUrl, children, }: BlogPostServerProps): Promise<React.JSX.Element | null>;
+export declare function BlogPost({ apiUrl, apiKey, slug, showToc, showRelated, relatedCount, showAuthor, basePath, routing, className, styles, unstyled, siteUrl, children, }: BlogPostServerProps): Promise<React.JSX.Element | null>;
 //# sourceMappingURL=BlogPost.d.ts.map

package/dist/blog/BlogPost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlogPost.d.ts","sourceRoot":"","sources":["../../src/blog/BlogPost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,OAAO,EAA0D,MAAM,SAAS,CAAA;AA2ExH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAgED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,YAAY,CAAA;QAClB,eAAe,EAAE,OAAO,EAAE,CAAA;QAC1B,YAAY,EAAE,YAAY,EAAE,CAAA;KAC7B,KAAK,KAAK,CAAC,SAAS,CAAA;CACtB;AAgBD,wBAAsB,QAAQ,CAAC,EAC7B,MAA4D,EAC5D,MAAwC,EACxC,IAAI,EACJ,OAAc,EACd,WAAkB,EAClB,YAAgB,EAChB,UAAiB,EACjB,QAAkB,EAClB,SAAS,EACT,MAAW,EACX,QAAgB,EAChB,OAAO,EACP,QAAQ,GACT,EAAE,mBAAmB,qCAoNrB"}
+{"version":3,"file":"BlogPost.d.ts","sourceRoot":"","sources":["../../src/blog/BlogPost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,OAAO,EAA0D,MAAM,SAAS,CAAA;AAOxH,OAAO,EAAsC,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAqEtF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAgED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,YAAY,CAAA;QAClB,eAAe,EAAE,OAAO,EAAE,CAAA;QAC1B,YAAY,EAAE,YAAY,EAAE,CAAA;KAC7B,KAAK,KAAK,CAAC,SAAS,CAAA;CACtB;AAgBD,wBAAsB,QAAQ,CAAC,EAC7B,MAA4D,EAC5D,MAAwC,EACxC,IAAI,EACJ,OAAc,EACd,WAAkB,EAClB,YAAgB,EAChB,UAAiB,EACjB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAW,EACX,QAAgB,EAChB,OAAO,EACP,QAAQ,GACT,EAAE,mBAAmB,qCAiOrB"}

package/dist/blog/BlogSidebar.d.ts

@@ -5,6 +5,7 @@
  * tags, newsletter signup, and custom widgets.
  */
 import React from 'react';
+import { type BlogRoutingOptions } from './routes';
 export interface BlogSidebarProps {
     /** Portal API URL */
     apiUrl?: string;
@@ -22,6 +23,7 @@ export interface BlogSidebarProps {
     showSearch?: boolean;
     /** Base URL for blog links */
     basePath?: string;
+    routing?: BlogRoutingOptions;
     /** Custom class name */
     className?: string;
     /** Current category filter (for highlighting) */
@@ -29,5 +31,5 @@ export interface BlogSidebarProps {
     /** Additional widgets to render */
     children?: React.ReactNode;
 }
-export declare function BlogSidebar({ apiUrl, apiKey, showCategories, showRecentPosts, recentPostsCount, showTags, showSearch, basePath, className, currentCategory, children, }: BlogSidebarProps): Promise<React.JSX.Element | null>;
+export declare function BlogSidebar({ apiUrl, apiKey, showCategories, showRecentPosts, recentPostsCount, showTags, showSearch, basePath, routing, className, currentCategory, children, }: BlogSidebarProps): Promise<React.JSX.Element | null>;
 //# sourceMappingURL=BlogSidebar.d.ts.map

package/dist/blog/BlogSidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlogSidebar.d.ts","sourceRoot":"","sources":["../../src/blog/BlogSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAmEzB,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yBAAyB;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED,wBAAsB,WAAW,CAAC,EAChC,MAA4D,EAC5D,MAAwC,EACxC,cAAqB,EACrB,eAAsB,EACtB,gBAAoB,EACpB,QAAe,EACf,UAAiB,EACjB,QAAkB,EAClB,SAAS,EACT,eAAe,EACf,QAAQ,GACT,EAAE,gBAAgB,qCAyClB"}
+{"version":3,"file":"BlogSidebar.d.ts","sourceRoot":"","sources":["../../src/blog/BlogSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAiEpE,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yBAAyB;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAED,wBAAsB,WAAW,CAAC,EAChC,MAA4D,EAC5D,MAAwC,EACxC,cAAqB,EACrB,eAAsB,EACtB,gBAAoB,EACpB,QAAe,EACf,UAAiB,EACjB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,eAAe,EACf,QAAQ,GACT,EAAE,gBAAgB,qCA2ClB"}

package/dist/blog/ClusterLandingPage.d.ts

@@ -11,12 +11,14 @@
  * Ships with `.sk-cluster-landing-*` scoped styles.
  */
 import React from 'react';
+import { type BlogRoutingOptions } from './routes';
 import type { TopicCluster } from './types';
 export interface ClusterLandingPageProps {
     /** Cluster slug to fetch */
     slug: string;
     /** Base path for blog URLs (default: /blog) */
     basePath?: string;
+    routing?: BlogRoutingOptions;
     /**
      * Include each article's own category segment in its URL:
      * {basePath}/{category}/{slug}. Enable on sites whose blog routes are
@@ -33,5 +35,5 @@ export interface ClusterLandingPageProps {
         cluster: TopicCluster;
     }) => React.ReactNode;
 }
-export declare function ClusterLandingPage({ slug, basePath, categoryInPath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined>;
+export declare function ClusterLandingPage({ slug, basePath, routing, categoryInPath, unstyled, className, children, }: ClusterLandingPageProps): Promise<string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined>;
 //# sourceMappingURL=ClusterLandingPage.d.ts.map

package/dist/blog/ClusterLandingPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterLandingPage.d.ts","sourceRoot":"","sources":["../../src/blog/ClusterLandingPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,SAAS,CAAA;AAiHrD,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAA;CACjE;AAUD,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,QAAkB,EAClB,cAAsB,EACtB,QAAgB,EAChB,SAAS,EACT,QAAQ,GACT,EAAE,uBAAuB,kHAyHzB"}
+{"version":3,"file":"ClusterLandingPage.d.ts","sourceRoot":"","sources":["../../src/blog/ClusterLandingPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,SAAS,CAAA;AAiHrD,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAA;CACjE;AAED,wBAAsB,kBAAkB,CAAC,EACvC,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,cAAsB,EACtB,QAAgB,EAChB,SAAS,EACT,QAAQ,GACT,EAAE,uBAAuB,kHAsHzB"}

package/dist/blog/ClusterNavigation.d.ts

@@ -10,11 +10,13 @@
  */
 import React from 'react';
 import type { ClusterNavigation as ClusterNavigationType } from './types';
+import { type BlogRoutingOptions } from './routes';
 export interface ClusterNavigationProps {
     /** Cluster navigation data */
     navigation: ClusterNavigationType;
     /** Base path for blog URLs (default: /blog) */
     basePath?: string;
+    routing?: BlogRoutingOptions;
     /**
      * Fallback category slug for URL building (optional). Each linked article's
      * OWN category takes precedence when present — applying one category to
@@ -29,5 +31,5 @@ export interface ClusterNavigationProps {
     /** Custom class name */
     className?: string;
 }
-export declare function ClusterNavigation({ navigation, basePath, category, trailingSlash, unstyled, className, }: ClusterNavigationProps): React.JSX.Element | null;
+export declare function ClusterNavigation({ navigation, basePath, routing, category, trailingSlash, unstyled, className, }: ClusterNavigationProps): React.JSX.Element | null;
 //# sourceMappingURL=ClusterNavigation.d.ts.map

package/dist/blog/ClusterNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusterNavigation.d.ts","sourceRoot":"","sources":["../../src/blog/ClusterNavigation.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAA;AA+FzE,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,UAAU,EAAE,qBAAqB,CAAA;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,QAAkB,EAClB,QAAQ,EACR,aAAqB,EACrB,QAAgB,EAChB,SAAS,GACV,EAAE,sBAAsB,4BAsDxB"}
+{"version":3,"file":"ClusterNavigation.d.ts","sourceRoot":"","sources":["../../src/blog/ClusterNavigation.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AA+FpE,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,UAAU,EAAE,qBAAqB,CAAA;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,aAAqB,EACrB,QAAgB,EAChB,SAAS,GACV,EAAE,sBAAsB,4BAoDxB"}

package/dist/blog/RelatedPosts.d.ts

@@ -5,14 +5,17 @@
  */
 import React from 'react';
 import type { BlogPost } from './types';
+import { type BlogRoutingOptions } from './routes';
 interface RelatedPostsServerProps {
     apiUrl?: string;
     apiKey?: string;
     currentPostId: string;
     limit?: number;
     className?: string;
+    basePath?: string;
+    routing?: BlogRoutingOptions;
     renderItem?: (post: BlogPost) => React.ReactNode;
 }
-export declare function RelatedPosts({ apiUrl, apiKey, currentPostId, limit, className, renderItem, }: RelatedPostsServerProps): Promise<React.JSX.Element | null>;
+export declare function RelatedPosts({ apiUrl, apiKey, currentPostId, limit, className, basePath, routing, renderItem, }: RelatedPostsServerProps): Promise<React.JSX.Element | null>;
 export {};
 //# sourceMappingURL=RelatedPosts.d.ts.map

package/dist/blog/RelatedPosts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelatedPosts.d.ts","sourceRoot":"","sources":["../../src/blog/RelatedPosts.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAqB,QAAQ,EAAE,MAAM,SAAS,CAAA;AA2C1D,UAAU,uBAAuB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,KAAK,CAAC,SAAS,CAAA;CACjD;AAED,wBAAsB,YAAY,CAAC,EACjC,MAA4D,EAC5D,MAAwC,EACxC,aAAa,EACb,KAAS,EACT,SAAS,EACT,UAAU,GACX,EAAE,uBAAuB,qCA8CzB"}
+{"version":3,"file":"RelatedPosts.d.ts","sourceRoot":"","sources":["../../src/blog/RelatedPosts.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAqB,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE1D,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AA2CpE,UAAU,uBAAuB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,KAAK,CAAC,SAAS,CAAA;CACjD;AAED,wBAAsB,YAAY,CAAC,EACjC,MAA4D,EAC5D,MAAwC,EACxC,aAAa,EACb,KAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,UAAU,GACX,EAAE,uBAAuB,qCAkDzB"}

package/dist/blog/artwork-components.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artwork-components.test.d.ts.map

package/dist/blog/artwork-components.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artwork-components.test.d.ts","sourceRoot":"","sources":["../../src/blog/artwork-components.test.tsx"],"names":[],"mappings":""}

package/dist/blog/artwork.d.ts

@@ -0,0 +1,14 @@
+import type { CSSProperties } from 'react';
+import type { BlogPost } from './types';
+export interface BlogArtwork {
+    src: string | undefined;
+    alt: string;
+    composed: boolean;
+}
+type ArtworkSource = Pick<BlogPost, 'title' | 'featured_image' | 'featured_image_alt' | 'editorial_image' | 'editorial_image_alt'>;
+/** Single source of truth for article artwork versus complete promotional cards. */
+export declare function resolveBlogArtwork(post: ArtworkSource, placement?: 'article' | 'card'): BlogArtwork;
+/** Preserve generated text and graphics across every stock card surface. */
+export declare function blogArtworkImageStyle(artwork: BlogArtwork): CSSProperties | undefined;
+export {};
+//# sourceMappingURL=artwork.d.ts.map

package/dist/blog/artwork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artwork.d.ts","sourceRoot":"","sources":["../../src/blog/artwork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,qBAAqB,CAAC,CAAA;AAElI,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,GAAE,SAAS,GAAG,MAAe,GAAG,WAAW,CAc3G;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAIrF"}

package/dist/blog/artwork.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artwork.test.d.ts.map

package/dist/blog/artwork.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artwork.test.d.ts","sourceRoot":"","sources":["../../src/blog/artwork.test.ts"],"names":[],"mappings":""}

package/dist/blog/blog-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog-styles.d.ts","sourceRoot":"","sources":["../../src/blog/blog-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,eAAO,MAAM,WAAW,QAqZhB,CAAA;AAMR,eAAO,MAAM,WAAW,QAyKhB,CAAA"}
+{"version":3,"file":"blog-styles.d.ts","sourceRoot":"","sources":["../../src/blog/blog-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,eAAO,MAAM,WAAW,QAuZhB,CAAA;AAMR,eAAO,MAAM,WAAW,QAyKhB,CAAA"}

package/dist/blog/blog-tables.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Server-rendered table scrolling. Keep the author's table markup intact so
+ * captions, header associations, links and table semantics survive unchanged.
+ */
+/**
+ * Single source of truth for default blog table wrappers. Safe to call twice;
+ * already wrapped tables and HTML examples are left alone. This is a layout
+ * transform, not an HTML sanitizer: content still follows the host's trust policy.
+ */
+export declare function wrapBlogTables(html: string): string;
+/** Native overflow only when content needs it; small tables retain their layout. */
+export declare const blogTableCss: string;
+//# sourceMappingURL=blog-tables.d.ts.map

package/dist/blog/blog-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-tables.d.ts","sourceRoot":"","sources":["../../src/blog/blog-tables.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2DH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkDnD;AAED,oFAAoF;AACpF,eAAO,MAAM,YAAY,QAuCjB,CAAA"}

package/dist/blog/blog-tables.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=blog-tables.test.d.ts.map

package/dist/blog/blog-tables.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-tables.test.d.ts","sourceRoot":"","sources":["../../src/blog/blog-tables.test.ts"],"names":[],"mappings":""}

package/dist/blog/index.d.ts

@@ -77,5 +77,8 @@ export type { ClusterNavigationProps } from './ClusterNavigation';
  */
 export type { ClusterLandingPageProps } from './ClusterLandingPage';
 export * from './types';
+export { blogCategorySlug, createBlogRoutes, resolveBlogPostUrl, resolveBlogUrl } from './routes';
+export type { BlogRoutePost, BlogRoutingOptions } from './routes';
+export { resolveBlogArtwork } from './artwork';
 export { addExternalLinkTargets, normalizeSiteHost, resolveBlogSiteUrl, } from './processBlogHtml';
 //# sourceMappingURL=index.d.ts.map

package/dist/blog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC/E,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAExG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAGnE,cAAc,SAAS,CAAA;AAGvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC/E,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAExG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAGnE,cAAc,SAAS,CAAA;AAEvB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACjG,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAG9C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA"}