@shop-on/theme-routes 0.0.0-stage → 0.2.0

package/dist/LICENSE.md

@@ -0,0 +1,39 @@
+# Cody Theme Development License
+
+Copyright (c) 2026 Cody LLC. All rights reserved except as granted below.
+
+"The Software" is this package, its source, and its documentation. "The
+Platform" is Cody, the commerce platform operated by Cody LLC.
+
+## 1. Grant
+
+You may use, copy and modify the Software, and distribute modified copies, solely
+to develop, test, and distribute themes, apps and other extensions that run on
+the Platform.
+
+## 2. Restrictions
+
+You may not:
+
+1. use the Software, or anything derived from it, with any commerce platform,
+   storefront or hosting service other than the Platform;
+2. use the Software to build a product that competes with the Platform;
+3. sublicense the Software, or distribute it other than as part of a theme,
+   app or extension for the Platform;
+4. remove or alter this license or any copyright notice in the Software.
+
+## 3. Your work
+
+Themes, apps and extensions you build with the Software are yours. The parts of
+the Software they include stay under this license.
+
+## 4. Termination
+
+This license ends automatically if you break any of its terms. You must then
+stop using the Software and delete your copies of it.
+
+## 5. No warranty
+
+The Software is provided "as is", without warranty of any kind. Cody LLC is not
+liable for any claim, damages or other liability arising from the Software or
+its use.

package/dist/adapter.d.ts

@@ -0,0 +1,216 @@
+import { ParsedBlogSearch, ParsedListingSearch, SeoHeadResult } from "./types.js";
+import { ComponentType, ReactNode } from "react";
+import { TemplateJSON } from "@shop-on/theme-runtime/template-types";
+//#region src/adapter.d.ts
+declare module "@tanstack/react-router" {
+  interface StaticDataRouteOption {
+    templateId?: string;
+  }
+}
+/** A theme's `createServerFn` caller. Typed by its input only — every template
+ * fn's return is cast to `TemplateJSON` at the call site, exactly as the
+ * per-theme routes did before this package existed (the serializer forces the
+ * handlers' return type to `any`).
+ *
+ * METHOD syntax throughout this file is deliberate. A theme's fn narrows what
+ * this package can express — `filter?: unknown` here vs a generated
+ * `CollectionFilterInput` there, `subpath?: string` vs a literal union — and
+ * `strictFunctionTypes` makes property-syntax function types contravariant,
+ * which would reject exactly those narrowings. Method declarations stay
+ * bivariant, which is the right call for a seam whose whole job is to accept a
+ * theme's more specific version of the same function. */
+export interface TemplateFn<TData> {
+  (opts: {
+    data: TData;
+  }): Promise<unknown>;
+}
+/** The theme's own `import.meta.glob` registry — the immovable seam, since the
+ * globs resolve relative to the file that declares them. */
+export interface RendererSeam {
+  TemplateRenderer: (props: {
+    template: TemplateJSON;
+  }) => ReactNode;
+  preloadTemplate: (template: TemplateJSON) => Promise<void>;
+}
+export interface I18nSeam {
+  /** Active content locale, `undefined` on the primary one. NEVER `params.locale`
+   * — the router rewrite de-localizes URLs before matching, so that param is
+   * never populated. */
+  getContentLocale: () => string | undefined;
+}
+export interface SeoSeam {
+  templateSeoHead: (loaderData: unknown, path: string, opts?: {
+    ogType?: "website" | "product" | "article";
+    preview?: boolean;
+    robots?: string;
+  }) => SeoHeadResult;
+  isPreviewSearch: (search: unknown) => boolean;
+  paginatedPath: (pathname: string, page: number | undefined) => string;
+}
+export interface TemplateByIdArgs {
+  templateId: string;
+  sid?: string;
+  locale?: string;
+}
+export interface HomeTemplateArgs {
+  sid?: string;
+  locale?: string;
+}
+export interface ProductTemplateArgs {
+  handle: string;
+  collectionHandle?: string;
+  sid?: string;
+  variantId?: string;
+  previewTemplate?: string;
+  locale?: string;
+}
+export interface CollectionPageTemplateArgs {
+  handle: string;
+  sid?: string;
+  previewTemplate?: string;
+  filter?: unknown;
+  sort?: string;
+  page?: number;
+  locale?: string;
+}
+export interface CollectionsTemplateArgs {
+  sid?: string;
+  after?: string;
+  page?: number;
+  locale?: string;
+}
+export interface SearchPageTemplateArgs {
+  q?: string;
+  /** Which result kind the page shows, for a theme whose search page has
+   * collection / content tabs. Absent = products. */
+  type?: string;
+  sid?: string;
+  filter?: unknown;
+  sort?: string;
+  page?: number;
+  locale?: string;
+}
+export interface BlogPageTemplateArgs {
+  handle: string;
+  sid?: string;
+  tag?: string;
+  page?: number;
+  locale?: string;
+}
+export interface ArticleTemplateArgs {
+  blogHandle: string;
+  handle: string;
+  sid?: string;
+  locale?: string;
+}
+export interface PageTemplateArgs {
+  handle: string;
+  sid?: string;
+  previewTemplate?: string;
+  page?: number;
+  locale?: string;
+}
+export interface PolicyTemplateArgs {
+  handle: string;
+  sid?: string;
+  locale?: string;
+}
+export interface PasswordTemplateArgs {
+  sid?: string;
+  locale?: string;
+}
+export interface SectionPreviewArgs {
+  type?: string;
+  preset?: number;
+  block?: string;
+}
+export interface TemplateFns {
+  getTemplateFn(opts: {
+    data: TemplateByIdArgs;
+  }): Promise<unknown>;
+  getHomeTemplateFn(opts: {
+    data: HomeTemplateArgs;
+  }): Promise<unknown>;
+  getProductTemplateFn(opts: {
+    data: ProductTemplateArgs;
+  }): Promise<unknown>;
+  getCollectionPageTemplateFn(opts: {
+    data: CollectionPageTemplateArgs;
+  }): Promise<unknown>;
+  getCollectionsTemplateFn(opts: {
+    data: CollectionsTemplateArgs;
+  }): Promise<unknown>;
+  getSearchPageTemplateFn(opts: {
+    data: SearchPageTemplateArgs;
+  }): Promise<unknown>;
+  getBlogPageTemplateFn(opts: {
+    data: BlogPageTemplateArgs;
+  }): Promise<unknown>;
+  getArticleTemplateFn(opts: {
+    data: ArticleTemplateArgs;
+  }): Promise<unknown>;
+  getPageTemplateFn(opts: {
+    data: PageTemplateArgs;
+  }): Promise<unknown>;
+  getPolicyTemplateFn(opts: {
+    data: PolicyTemplateArgs;
+  }): Promise<unknown>;
+  getPasswordTemplateFn(opts: {
+    data: PasswordTemplateArgs;
+  }): Promise<unknown>;
+  getSectionPreviewTemplateFn(opts: {
+    data: SectionPreviewArgs;
+  }): Promise<unknown>;
+}
+/** Collection / search listing grammar. */
+export interface CollectionSearchSeam {
+  parseCollectionSearch(search: unknown): ParsedListingSearch;
+  searchToFilterInput(state: ParsedListingSearch): unknown;
+  /** Self-canonical for a narrowed (filtered / sorted) listing view, rebuilt
+   * from the parsed state so one selection has one canonical. */
+  narrowedPath(pathname: string, parsed: ParsedListingSearch): string;
+  DEFAULT_COLLECTION_SORT: string;
+}
+export interface ProductSearchSeam {
+  parseProductSearch(search: unknown): ParsedListingSearch & {
+    q?: string;
+    type?: string;
+  };
+  searchToProductFilterInput(state: ParsedListingSearch & {
+    q?: string;
+  }): unknown;
+}
+export interface BlogSearchSeam {
+  parseBlogSearch(search: unknown): ParsedBlogSearch;
+}
+export interface SearchParsers extends CollectionSearchSeam, ProductSearchSeam, BlogSearchSeam {}
+export interface AccountSeam {
+  /** Resolves the central account app's absolute URL for a theme-side bounce. */
+  getAccountRedirectUrlFn(opts: {
+    data: {
+      subpath?: string;
+      returnToPath?: string;
+    };
+  }): Promise<{
+    url: string;
+  }>;
+}
+export interface PreviewSeam {
+  /** Rendered when there is nothing to preview, or when the section throws. */
+  Unavailable: ComponentType;
+  /** Optional per-theme provider wrapped around the previewed section — care
+   * uses it for `SectionPreviewContext`; kito has no such concept. */
+  Wrapper?: ComponentType<{
+    children: ReactNode;
+  }>;
+}
+/** What a theme's `src/route-adapter.tsx` exports. Every factory takes a
+ * narrower structural slice of this, so one object satisfies them all. */
+export interface ThemeRouteAdapter extends RendererSeam, I18nSeam {
+  seo: SeoSeam;
+  fns: TemplateFns;
+  parsers: SearchParsers;
+  account: AccountSeam;
+  preview: PreviewSeam;
+}
+//#endregion

package/dist/components/article-page.d.ts

@@ -0,0 +1,6 @@
+import { RendererSeam } from "../adapter.js";
+//#region src/components/article-page.d.ts
+/** Article detail body. Kept out of `routes/blog.ts` so the JSON-LD modules ride
+ * the split chunk (see `template-page.tsx`). */
+export declare function articleRouteComponent(adapter: RendererSeam): () => React.ReactNode;
+//#endregion

package/dist/components/article-page.js

@@ -0,0 +1,20 @@
+import { useTemplate } from "../use-template.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { ArticleJsonLd } from "@shop-on/theme-react/article-json-ld";
+import { BreadcrumbJsonLd } from "@shop-on/theme-react/breadcrumb-json-ld";
+//#region src/components/article-page.tsx
+/** Article detail body. Kept out of `routes/blog.ts` so the JSON-LD modules ride
+* the split chunk (see `template-page.tsx`). */
+function articleRouteComponent(adapter) {
+	const { TemplateRenderer } = adapter;
+	return function ArticlePage() {
+		const template = useTemplate();
+		return /* @__PURE__ */ jsxs(Fragment, { children: [
+			/* @__PURE__ */ jsx(TemplateRenderer, { template }),
+			template.articleSchema ? /* @__PURE__ */ jsx(ArticleJsonLd, { data: template.articleSchema }) : null,
+			template.breadcrumbSchema ? /* @__PURE__ */ jsx(BreadcrumbJsonLd, { data: template.breadcrumbSchema }) : null
+		] });
+	};
+}
+//#endregion
+export { articleRouteComponent };

package/dist/components/home-page.d.ts

@@ -0,0 +1,6 @@
+import { RendererSeam } from "../adapter.js";
+//#region src/components/home-page.d.ts
+/** Homepage body. Kept out of `routes/home.ts` so `WebsiteJsonLd` rides the
+ * split chunk instead of the entry chunk (see `template-page.tsx`). */
+export declare function homeRouteComponent(adapter: RendererSeam): () => React.ReactNode;
+//#endregion

package/dist/components/home-page.js

@@ -0,0 +1,15 @@
+import { useTemplate } from "../use-template.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { WebsiteJsonLd } from "@shop-on/theme-react/website-json-ld";
+//#region src/components/home-page.tsx
+/** Homepage body. Kept out of `routes/home.ts` so `WebsiteJsonLd` rides the
+* split chunk instead of the entry chunk (see `template-page.tsx`). */
+function homeRouteComponent(adapter) {
+	const { TemplateRenderer } = adapter;
+	return function HomePage() {
+		const template = useTemplate();
+		return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(TemplateRenderer, { template }), template.websiteSchema ? /* @__PURE__ */ jsx(WebsiteJsonLd, { data: template.websiteSchema }) : null] });
+	};
+}
+//#endregion
+export { homeRouteComponent };

package/dist/components/locale-layout.d.ts

@@ -0,0 +1,5 @@
+//#region src/components/locale-layout.d.ts
+/** The `{-$locale}` layout body — a pass-through. Separate module so the route
+ * file's `component` binding is splittable (see `template-page.tsx`). */
+export declare function localeLayoutComponent(): React.ReactNode;
+//#endregion

package/dist/components/locale-layout.js

@@ -0,0 +1,10 @@
+import { Outlet } from "@tanstack/react-router";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/locale-layout.tsx
+/** The `{-$locale}` layout body — a pass-through. Separate module so the route
+* file's `component` binding is splittable (see `template-page.tsx`). */
+function localeLayoutComponent() {
+	return /* @__PURE__ */ jsx(Outlet, {});
+}
+//#endregion
+export { localeLayoutComponent };

package/dist/components/product-page.d.ts

@@ -0,0 +1,10 @@
+import { RendererSeam } from "../adapter.js";
+//#region src/components/product-page.d.ts
+/** PDP body. `withBreadcrumb` is the only difference between the bare
+ * `/products/$handle` route and the collection-scoped one, whose path supplies
+ * a parent crumb. Kept out of `routes/product.ts` so the two JSON-LD modules
+ * ride the split chunk (see `template-page.tsx`). */
+export declare function productRouteComponent(adapter: RendererSeam, opts?: {
+  withBreadcrumb?: boolean;
+}): () => React.ReactNode;
+//#endregion

package/dist/components/product-page.js

@@ -0,0 +1,23 @@
+import { useTemplate } from "../use-template.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { BreadcrumbJsonLd } from "@shop-on/theme-react/breadcrumb-json-ld";
+import { ProductJsonLd } from "@shop-on/theme-react/product-json-ld";
+//#region src/components/product-page.tsx
+/** PDP body. `withBreadcrumb` is the only difference between the bare
+* `/products/$handle` route and the collection-scoped one, whose path supplies
+* a parent crumb. Kept out of `routes/product.ts` so the two JSON-LD modules
+* ride the split chunk (see `template-page.tsx`). */
+function productRouteComponent(adapter, opts) {
+	const { TemplateRenderer } = adapter;
+	const withBreadcrumb = opts?.withBreadcrumb ?? false;
+	return function ProductPage() {
+		const template = useTemplate();
+		return /* @__PURE__ */ jsxs(Fragment, { children: [
+			/* @__PURE__ */ jsx(TemplateRenderer, { template }),
+			template.productSchema ? /* @__PURE__ */ jsx(ProductJsonLd, { data: template.productSchema }) : null,
+			withBreadcrumb && template.breadcrumbSchema ? /* @__PURE__ */ jsx(BreadcrumbJsonLd, { data: template.breadcrumbSchema }) : null
+		] });
+	};
+}
+//#endregion
+export { productRouteComponent };

package/dist/components/section-preview-page.d.ts

@@ -0,0 +1,15 @@
+import { PreviewSeam, RendererSeam } from "../adapter.js";
+//#region src/components/section-preview-page.d.ts
+export interface SectionPreviewComponentAdapter extends RendererSeam {
+  preview: PreviewSeam;
+}
+/** The picker's single-section preview body. Kept out of
+ * `routes/preview-section.ts` so the height-reporting effect and the theme's
+ * preview wrapper ride the split chunk (see `template-page.tsx`). */
+export declare function sectionPreviewRouteComponent(adapter: SectionPreviewComponentAdapter): () => React.ReactNode;
+/** `errorComponent` for the same route — a section that throws must not blank
+ * the picker, it must say so in place. */
+export declare function sectionPreviewErrorComponent(adapter: {
+  preview: PreviewSeam;
+}): () => React.ReactNode;
+//#endregion

package/dist/components/section-preview-page.js

@@ -0,0 +1,42 @@
+import { useOptionalTemplate } from "../use-template.js";
+import { jsx } from "react/jsx-runtime";
+import { useEffect } from "react";
+//#region src/components/section-preview-page.tsx
+/** The picker's single-section preview body. Kept out of
+* `routes/preview-section.ts` so the height-reporting effect and the theme's
+* preview wrapper ride the split chunk (see `template-page.tsx`). */
+function sectionPreviewRouteComponent(adapter) {
+	const { TemplateRenderer } = adapter;
+	const { Unavailable, Wrapper } = adapter.preview;
+	return function SectionPreviewPage() {
+		const template = useOptionalTemplate();
+		useReportPreviewHeight();
+		if (!template) return /* @__PURE__ */ jsx(Unavailable, {});
+		const rendered = /* @__PURE__ */ jsx(TemplateRenderer, { template });
+		return Wrapper ? /* @__PURE__ */ jsx(Wrapper, { children: rendered }) : rendered;
+	};
+}
+/** `errorComponent` for the same route — a section that throws must not blank
+* the picker, it must say so in place. */
+function sectionPreviewErrorComponent(adapter) {
+	const { Unavailable } = adapter.preview;
+	return function SectionPreviewError() {
+		return /* @__PURE__ */ jsx(Unavailable, {});
+	};
+}
+function useReportPreviewHeight() {
+	useEffect(() => {
+		if (window.parent === window) return;
+		const target = document.querySelector("main") ?? document.body;
+		const report = () => window.parent.postMessage({
+			type: "section-preview:height",
+			height: target.scrollHeight
+		}, "*");
+		report();
+		const ro = new ResizeObserver(report);
+		ro.observe(target);
+		return () => ro.disconnect();
+	}, []);
+}
+//#endregion
+export { sectionPreviewErrorComponent, sectionPreviewRouteComponent };

package/dist/components/template-page.d.ts

@@ -0,0 +1,9 @@
+import { RendererSeam } from "../adapter.js";
+//#region src/components/template-page.d.ts
+/** The plain case: render the loaded template, nothing else. Used by cart,
+ * search, page, policy, collection, collections index and blog listing. */
+export declare function templatePageComponent(adapter: RendererSeam): () => React.ReactNode;
+/** Same, for the routes whose loader may return null (404, password) — renders
+ * nothing rather than a bare shell when the template file is absent. */
+export declare function optionalTemplatePageComponent(adapter: RendererSeam): () => React.ReactNode;
+//#endregion

package/dist/components/template-page.js

@@ -0,0 +1,22 @@
+import { useOptionalTemplate, useTemplate } from "../use-template.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/template-page.tsx
+/** The plain case: render the loaded template, nothing else. Used by cart,
+* search, page, policy, collection, collections index and blog listing. */
+function templatePageComponent(adapter) {
+	const { TemplateRenderer } = adapter;
+	return function TemplatePage() {
+		return /* @__PURE__ */ jsx(TemplateRenderer, { template: useTemplate() });
+	};
+}
+/** Same, for the routes whose loader may return null (404, password) — renders
+* nothing rather than a bare shell when the template file is absent. */
+function optionalTemplatePageComponent(adapter) {
+	const { TemplateRenderer } = adapter;
+	return function OptionalTemplatePage() {
+		const template = useOptionalTemplate();
+		return template ? /* @__PURE__ */ jsx(TemplateRenderer, { template }) : null;
+	};
+}
+//#endregion
+export { optionalTemplatePageComponent, templatePageComponent };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { DepsArg, HeadArg, LoaderArg, NullableHeadArg, NullableTemplateRouteOptions, ParsedBlogSearch, ParsedListingSearch, PreviewDeps, SeoHeadResult, ServerRouteHandler, TemplateRouteOptions } from "./types.js";
+import { AccountSeam, ArticleTemplateArgs, BlogPageTemplateArgs, BlogSearchSeam, CollectionPageTemplateArgs, CollectionSearchSeam, CollectionsTemplateArgs, HomeTemplateArgs, I18nSeam, PageTemplateArgs, PasswordTemplateArgs, PolicyTemplateArgs, PreviewSeam, ProductSearchSeam, ProductTemplateArgs, RendererSeam, SearchPageTemplateArgs, SearchParsers, SectionPreviewArgs, SeoSeam, TemplateByIdArgs, TemplateFn, TemplateFns, ThemeRouteAdapter } from "./adapter.js";
+import { templatePreloadLinks } from "./preload-links.js";
+import { SeoHelpers, SeoHelpersOptions, createSeoHelpers, isPreviewSearch, paginatedPath } from "./seo-head.js";
+import { ThemeRouterOptions, createThemeRouter } from "./router.js";
+import { useOptionalTemplate, useTemplate } from "./use-template.js";
+import { accountBounceOptions, accountIndexRouteOptions } from "./routes/account.js";
+import { articleRouteOptions, blogRouteOptions } from "./routes/blog.js";
+import { cartRouteOptions } from "./routes/cart.js";
+import { collectionRouteOptions, collectionsIndexRouteOptions } from "./routes/collection.js";
+import { homeRouteOptions } from "./routes/home.js";
+import { localeLayoutRouteOptions } from "./routes/locale-layout.js";
+import { notFoundRouteOptions } from "./routes/not-found.js";
+import { pageRouteOptions, policyRouteOptions } from "./routes/page.js";
+import { passwordRouteOptions } from "./routes/password.js";
+import { sectionPreviewRouteOptions } from "./routes/preview-section.js";
+import { collectionProductRouteOptions, productRouteOptions } from "./routes/product.js";
+import { searchRouteOptions } from "./routes/search.js";
+import { articleRouteComponent } from "./components/article-page.js";
+import { homeRouteComponent } from "./components/home-page.js";
+import { localeLayoutComponent } from "./components/locale-layout.js";
+import { productRouteComponent } from "./components/product-page.js";
+import { sectionPreviewErrorComponent, sectionPreviewRouteComponent } from "./components/section-preview-page.js";
+import { optionalTemplatePageComponent, templatePageComponent } from "./components/template-page.js";
+import { analyticsEventsHandler, analyticsVisitsHandler } from "./routes/server/analytics.js";
+import { analyticsScriptHandler } from "./routes/server/analytics-script.js";
+import { customerLogoutHandler } from "./routes/server/customer-logout.js";
+import { robotsHandler, sitemapHandler } from "./routes/server/seo-proxy.js";
+export { type AccountSeam, type ArticleTemplateArgs, type BlogPageTemplateArgs, type BlogSearchSeam, type CollectionPageTemplateArgs, type CollectionSearchSeam, type CollectionsTemplateArgs, type DepsArg, type HeadArg, type HomeTemplateArgs, type I18nSeam, type LoaderArg, type NullableHeadArg, type NullableTemplateRouteOptions, type PageTemplateArgs, type ParsedBlogSearch, type ParsedListingSearch, type PasswordTemplateArgs, type PolicyTemplateArgs, type PreviewDeps, type PreviewSeam, type ProductSearchSeam, type ProductTemplateArgs, type RendererSeam, type SearchPageTemplateArgs, type SearchParsers, type SectionPreviewArgs, type SeoHeadResult, type SeoHelpers, type SeoHelpersOptions, type SeoSeam, type ServerRouteHandler, type TemplateByIdArgs, type TemplateFn, type TemplateFns, type TemplateRouteOptions, type ThemeRouteAdapter, type ThemeRouterOptions, accountBounceOptions, accountIndexRouteOptions, analyticsEventsHandler, analyticsScriptHandler, analyticsVisitsHandler, articleRouteComponent, articleRouteOptions, blogRouteOptions, cartRouteOptions, collectionProductRouteOptions, collectionRouteOptions, collectionsIndexRouteOptions, createSeoHelpers, createThemeRouter, customerLogoutHandler, homeRouteComponent, homeRouteOptions, isPreviewSearch, localeLayoutComponent, localeLayoutRouteOptions, notFoundRouteOptions, optionalTemplatePageComponent, pageRouteOptions, paginatedPath, passwordRouteOptions, policyRouteOptions, productRouteComponent, productRouteOptions, robotsHandler, searchRouteOptions, sectionPreviewErrorComponent, sectionPreviewRouteComponent, sectionPreviewRouteOptions, sitemapHandler, templatePageComponent, templatePreloadLinks, useOptionalTemplate, useTemplate };

package/dist/index.js

@@ -0,0 +1,27 @@
+import { templatePreloadLinks } from "./preload-links.js";
+import { createSeoHelpers, isPreviewSearch, paginatedPath } from "./seo-head.js";
+import { createThemeRouter } from "./router.js";
+import { useOptionalTemplate, useTemplate } from "./use-template.js";
+import { accountBounceOptions, accountIndexRouteOptions } from "./routes/account.js";
+import { articleRouteOptions, blogRouteOptions } from "./routes/blog.js";
+import { cartRouteOptions } from "./routes/cart.js";
+import { collectionRouteOptions, collectionsIndexRouteOptions } from "./routes/collection.js";
+import { homeRouteOptions } from "./routes/home.js";
+import { localeLayoutRouteOptions } from "./routes/locale-layout.js";
+import { notFoundRouteOptions } from "./routes/not-found.js";
+import { pageRouteOptions, policyRouteOptions } from "./routes/page.js";
+import { passwordRouteOptions } from "./routes/password.js";
+import { sectionPreviewRouteOptions } from "./routes/preview-section.js";
+import { collectionProductRouteOptions, productRouteOptions } from "./routes/product.js";
+import { searchRouteOptions } from "./routes/search.js";
+import { articleRouteComponent } from "./components/article-page.js";
+import { homeRouteComponent } from "./components/home-page.js";
+import { localeLayoutComponent } from "./components/locale-layout.js";
+import { productRouteComponent } from "./components/product-page.js";
+import { sectionPreviewErrorComponent, sectionPreviewRouteComponent } from "./components/section-preview-page.js";
+import { optionalTemplatePageComponent, templatePageComponent } from "./components/template-page.js";
+import { analyticsEventsHandler, analyticsVisitsHandler } from "./routes/server/analytics.js";
+import { analyticsScriptHandler } from "./routes/server/analytics-script.js";
+import { customerLogoutHandler } from "./routes/server/customer-logout.js";
+import { robotsHandler, sitemapHandler } from "./routes/server/seo-proxy.js";
+export { accountBounceOptions, accountIndexRouteOptions, analyticsEventsHandler, analyticsScriptHandler, analyticsVisitsHandler, articleRouteComponent, articleRouteOptions, blogRouteOptions, cartRouteOptions, collectionProductRouteOptions, collectionRouteOptions, collectionsIndexRouteOptions, createSeoHelpers, createThemeRouter, customerLogoutHandler, homeRouteComponent, homeRouteOptions, isPreviewSearch, localeLayoutComponent, localeLayoutRouteOptions, notFoundRouteOptions, optionalTemplatePageComponent, pageRouteOptions, paginatedPath, passwordRouteOptions, policyRouteOptions, productRouteComponent, productRouteOptions, robotsHandler, searchRouteOptions, sectionPreviewErrorComponent, sectionPreviewRouteComponent, sectionPreviewRouteOptions, sitemapHandler, templatePageComponent, templatePreloadLinks, useOptionalTemplate, useTemplate };

package/dist/preload-links.d.ts

@@ -0,0 +1,6 @@
+//#region src/preload-links.d.ts
+export declare function templatePreloadLinks(loaderData: unknown): Array<{
+  rel: "modulepreload";
+  href: string;
+}>;
+//#endregion

package/dist/preload-links.js

@@ -0,0 +1,11 @@
+//#region src/preload-links.ts
+function templatePreloadLinks(loaderData) {
+	const hrefs = loaderData?.preloadHrefs;
+	if (!Array.isArray(hrefs)) return [];
+	return hrefs.map((href) => ({
+		rel: "modulepreload",
+		href: String(href)
+	}));
+}
+//#endregion
+export { templatePreloadLinks };

package/dist/router.d.ts

@@ -0,0 +1,27 @@
+import { AnyRoute, createRouter } from "@tanstack/react-router";
+import { TemplateTypes } from "@shop-on/theme-react/template-renderer";
+//#region src/router.d.ts
+export interface ThemeRouterOptions {
+  /** The theme's generated `routeTree.gen.ts` export. */
+  routeTree: AnyRoute;
+  /** URL rewrite pair from the theme's `src/lib/i18n`. */
+  deLocalizeUrl: (url: URL) => URL;
+  localizeUrl: (url: URL) => URL;
+  /** The theme's glob-registry preloader (`src/components/template-renderer`). */
+  preloadTypes: (types: TemplateTypes) => Promise<void>;
+  /** Boxes that scroll the page instead of the window. The router resets only
+   * the window on navigation and CARRIES every other scroller's position to
+   * the next page, so a theme whose layout scrolls an inner element names it. */
+  scrollToTopSelectors?: string[];
+}
+/**
+ * The one router every theme runs on. A theme's `src/router.tsx` is a shim that
+ * hands over its route tree, its localize pair and its template preloader.
+ *
+ * Not-found handling lives HERE, at router level, rather than as a
+ * `notFoundComponent` on the locale layout: one definition covers unmatched
+ * paths AND every `notFound()` a loader throws, and it is what stops TanStack
+ * falling back to its bare `<p>Not Found</p>`.
+ */
+export declare function createThemeRouter({ routeTree, deLocalizeUrl, localizeUrl, preloadTypes, scrollToTopSelectors }: ThemeRouterOptions): ReturnType<typeof createRouter>;
+//#endregion

package/dist/router.js

@@ -0,0 +1,54 @@
+import { Navigate, createRouter } from "@tanstack/react-router";
+import { BProgress } from "@bprogress/core";
+import { collectTemplateTypes } from "@shop-on/theme-react/template-renderer";
+import { jsx } from "react/jsx-runtime";
+//#region src/router.tsx
+function isTemplate(value) {
+	if (!value || typeof value !== "object") return false;
+	const v = value;
+	return typeof v.sections === "object" && v.sections !== null && Array.isArray(v.order);
+}
+/**
+* The one router every theme runs on. A theme's `src/router.tsx` is a shim that
+* hands over its route tree, its localize pair and its template preloader.
+*
+* Not-found handling lives HERE, at router level, rather than as a
+* `notFoundComponent` on the locale layout: one definition covers unmatched
+* paths AND every `notFound()` a loader throws, and it is what stops TanStack
+* falling back to its bare `<p>Not Found</p>`.
+*/
+function createThemeRouter({ routeTree, deLocalizeUrl, localizeUrl, preloadTypes, scrollToTopSelectors }) {
+	let router;
+	router = createRouter({
+		routeTree,
+		scrollRestoration: true,
+		scrollRestorationBehavior: "instant",
+		scrollToTopSelectors,
+		defaultNotFoundComponent: () => /* @__PURE__ */ jsx(Navigate, {
+			to: "/{-$locale}/404",
+			params: { locale: void 0 },
+			search: { preview: void 0 },
+			replace: true
+		}),
+		rewrite: {
+			input: ({ url }) => deLocalizeUrl(url),
+			output: ({ url }) => localizeUrl(url)
+		},
+		dehydrate: () => ({ templateTypes: collectTemplateTypes(router.state.matches.map((m) => m.loaderData).filter(isTemplate)) }),
+		hydrate: async ({ templateTypes }) => {
+			if (templateTypes) await preloadTypes(templateTypes);
+		}
+	});
+	if (typeof document !== "undefined") {
+		BProgress.configure({ showSpinner: false });
+		router.subscribe("onBeforeNavigate", ({ pathChanged }) => {
+			if (pathChanged) BProgress.start();
+		});
+		router.subscribe("onResolved", () => {
+			BProgress.done();
+		});
+	}
+	return router;
+}
+//#endregion
+export { createThemeRouter };