orionplace-svelte 0.7.2 → 0.7.4

package/README.md

@@ -519,6 +519,9 @@ data and actions; `orionplace/COMPONENTS.md` lists their customer paths.
 Page titles, descriptions and link-preview metadata follow the current page
 and selected language, including client navigation. Public events and banner
 images come from Application Load.
+Pages with a canonical address also link the same page in the other storefront languages (`hreflang`) and set `og:type` and `og:locale`; a journal article adds its publication date (`article:published_time`) and schema.org `BlogPosting` data. The store icon (`logos.ico`) is the page's `<link rel="icon">`. An unknown `?locale` opens the default language.
+
+List pages (journal, categories, stores) link their previous and next pages as real links (`?page=2`). Each later page has its own canonical address and a title with its page number; a journal page past the last one answers 404.
 
 ## Application Load starter
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orionplace-svelte",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "SvelteKit 2 storefront for your Orionplace marketplace: setup CLI, server API gateway, typed store and ready-made catalog, cart, checkout and account components in English and Russian, plus an Android app build.",
   "type": "module",
   "license": "MIT",

package/templates/src/lib/components/orionplace/blog/StorefrontJournal.svelte

@@ -669,6 +669,7 @@
         <StorefrontPagination
           pagination={pagination.value}
           pending={Boolean(task.state.pending)}
+          linked
           onChange={changePage}
         />
       </div>

package/templates/src/lib/components/orionplace/search/ProductSearchResults.svelte

@@ -6,6 +6,8 @@
   import { useOrionplaceSelectionsStore } from '@/lib/stores/orionplaceSelections.svelte';
   import { browseLabels } from '@/lib/utils/orionplace/browseLabels';
   import { hasSearchFilters } from '@/lib/utils/orionplace/searchFilters';
+  import { storefrontPageHref } from '@/lib/utils/orionplace/pageSeo';
+  import { currentSearch, useRoute } from '@/lib/orionplace/navigation.svelte';
   import SearchFilters from '@/lib/components/orionplace/search/SearchFilters.svelte';
   import ProductGroup from '@/lib/components/orionplace/products/ProductGroup.svelte';
   import type { ProductFacetSelection } from '@/lib/interfaces/orionplace/products/IProductSearchFacets';
@@ -195,6 +197,36 @@
     },
   );
   const labels               = computed(() => browseLabels(selectionStore.localeCode));
+  // Every list of this component keeps its page in the address (`?page=`),
+  // so previous and next are links search engines follow; a click changes
+  // the page in place.
+  const route                = useRoute();
+  const search               = computed(() => currentSearch());
+  const previousHref         = computed(() =>
+    !inputs.pending && inputs.page > 1
+      ? storefrontPageHref(route.path, search.value, inputs.page - 1)
+      : undefined,
+  );
+  const nextHref             = computed(() =>
+    !inputs.pending && !inputs.failed && inputs.hasNext
+      ? storefrontPageHref(route.path, search.value, inputs.page + 1)
+      : undefined,
+  );
+
+  // A link opened in a new tab or window keeps its default.
+  function followPage(event: MouseEvent, value: number) {
+    if (
+      event.button !== 0 ||
+      event.metaKey ||
+      event.ctrlKey ||
+      event.shiftKey ||
+      event.altKey
+    ) {
+      return;
+    }
+    event.preventDefault();
+    emit('changePage', value);
+  }
   const filtersOpen          = ref(false);
   const hasFilters           = computed(() =>
     hasSearchFilters(
@@ -571,17 +603,26 @@
               `,
             ]}
           >
-            <button
-              type="button"
-              disabled={inputs.pending || inputs.page === 1}
-              onclick={() => {
-                emit('changePage', inputs.page - 1);
+            <svelte:element
+              this={previousHref.value ? 'a' : 'button'}
+              type={previousHref.value ? undefined : 'button'}
+              href={previousHref.value}
+              rel={previousHref.value ? 'prev' : undefined}
+              disabled={previousHref.value
+                ? undefined
+                : inputs.pending || inputs.page === 1}
+              onclick={(event: MouseEvent) => {
+                if (previousHref.value) {
+                  followPage(event, inputs.page - 1);
+                } else {
+                  emit('changePage', inputs.page - 1);
+                }
               }}
               class={[
                 `
                   inline-flex h-11 items-center justify-center px-5 [font-family:inherit]
                   text-xs font-medium uppercase tracking-[0.08em] text-orionplace-text
-                  border border-solid border-orionplace-border bg-transparent
+                  no-underline border border-solid border-orionplace-border bg-transparent
                   cursor-pointer outline-none hover:border-orionplace-text
                   focus-visible:border-orionplace-text disabled:cursor-not-allowed
                   disabled:opacity-40
@@ -589,7 +630,7 @@
               ]}
             >
               ← {labels.value.previous}
-            </button>
+            </svelte:element>
             <span
               class={[
                 'text-xs uppercase tracking-[0.08em] tabular-nums text-orionplace-muted',
@@ -601,17 +642,26 @@
                 {labels.value.of} {inputs.pages}
               {/if}
             </span>
-            <button
-              type="button"
-              disabled={inputs.pending || inputs.failed || !inputs.hasNext}
-              onclick={() => {
-                emit('changePage', inputs.page + 1);
+            <svelte:element
+              this={nextHref.value ? 'a' : 'button'}
+              type={nextHref.value ? undefined : 'button'}
+              href={nextHref.value}
+              rel={nextHref.value ? 'next' : undefined}
+              disabled={nextHref.value
+                ? undefined
+                : inputs.pending || inputs.failed || !inputs.hasNext}
+              onclick={(event: MouseEvent) => {
+                if (nextHref.value) {
+                  followPage(event, inputs.page + 1);
+                } else {
+                  emit('changePage', inputs.page + 1);
+                }
               }}
               class={[
                 `
                   inline-flex h-11 items-center justify-center px-5 [font-family:inherit]
                   text-xs font-medium uppercase tracking-[0.08em] text-orionplace-text
-                  border border-solid border-orionplace-border bg-transparent
+                  no-underline border border-solid border-orionplace-border bg-transparent
                   cursor-pointer outline-none hover:border-orionplace-text
                   focus-visible:border-orionplace-text disabled:cursor-not-allowed
                   disabled:opacity-40
@@ -619,7 +669,7 @@
               ]}
             >
               {labels.value.next} →
-            </button>
+            </svelte:element>
           </nav>
         {/if}
       </div>

package/templates/src/lib/components/orionplace/shared/StorefrontPagination.README.md

@@ -8,6 +8,10 @@ the list start while accounting for a fixed header and reduced-motion preference
 focus moves to the list's first heading. Both controls are disabled while the request
 runs.
 
+With `linked`, for lists that keep their page number in the address (`?page=2`),
+previous and next are links to those addresses, so search engines reach every page of
+the list; a click still changes the page in place.
+
 Source: `src/lib/components/orionplace/shared/StorefrontPagination.svelte`.
 
 ## Inputs
@@ -18,6 +22,7 @@ Source: `src/lib/components/orionplace/shared/StorefrontPagination.svelte`.
 | `pending` | `boolean` | Optional |
 | `scrollTarget` | `HTMLElement \| string \| null` | Optional |
 | `compact` | `boolean` | Optional |
+| `linked` | `boolean` | Optional |
 
 ## Callbacks
 

package/templates/src/lib/components/orionplace/shared/StorefrontPagination.svelte

@@ -3,6 +3,8 @@
   import { useOrionplaceSelectionsStore } from '@/lib/stores/orionplaceSelections.svelte';
   import { featureLabels } from '@/lib/utils/orionplace/featureLabels';
   import { scrollToPaginatedList } from '@/lib/utils/orionplace/paginationScroll';
+  import { storefrontPageHref } from '@/lib/utils/orionplace/pageSeo';
+  import { currentSearch, useRoute } from '@/lib/orionplace/navigation.svelte';
   import type { IApiPagination } from '@/lib/interfaces/orionplace/accounts/IProfileData';
   import '@/lib/components/orionplace/shared/features.css';
 
@@ -11,6 +13,12 @@
     pending?: boolean;
     scrollTarget?: HTMLElement | string | null;
     compact?: boolean;
+    /**
+     * The list keeps its page number in the address (`?page=`): previous and
+     * next are links to those addresses, so search engines reach every page.
+     * A click still changes the page in place.
+     */
+    linked?: boolean;
     onChange?: (...args: [page: number]) => unknown;
     [attribute: string]: any;
   };
@@ -19,6 +27,7 @@
     pending: input_pending,
     scrollTarget: input_scrollTarget,
     compact: input_compact,
+    linked: input_linked,
     onChange: callback_onChange,
     ...attributes
   }: Props             = $props();
@@ -35,6 +44,9 @@
     get compact() {
       return input_compact;
     },
+    get linked() {
+      return input_linked;
+    },
   };
   const emit           = (event: string, ...args: any[]) => {
     const handlers: Record<string, ((...args: any[]) => unknown) | undefined> =
@@ -48,11 +60,46 @@
   const labels         = computed(() => featureLabels(selectionStore.localeCode));
   const page           = computed(() => inputs.pagination.page ?? 1);
   const nav            = ref<HTMLElement>();
+  const route          = useRoute();
+  const previousPage   = computed(
+    () => inputs.pagination.previous_page_number || page.value - 1,
+  );
+  const nextPage       = computed(() =>
+    typeof inputs.pagination.next_page_number === 'number'
+      ? inputs.pagination.next_page_number
+      : page.value + 1,
+  );
+  const search         = computed(() => currentSearch());
+  const previousHref   = computed(() =>
+    inputs.linked && !inputs.pending && inputs.pagination.has_previous
+      ? storefrontPageHref(route.path, search.value, previousPage.value)
+      : undefined,
+  );
+  const nextHref       = computed(() =>
+    inputs.linked && !inputs.pending && inputs.pagination.has_next
+      ? storefrontPageHref(route.path, search.value, nextPage.value)
+      : undefined,
+  );
 
   function change(value: number) {
     emit('change', value);
     scrollToPaginatedList(nav.value, inputs.scrollTarget);
   }
+
+  // A link opened in a new tab or window keeps its default.
+  function follow(event: MouseEvent, value: number, act: (value: number) => void) {
+    if (
+      event.button !== 0 ||
+      event.metaKey ||
+      event.ctrlKey ||
+      event.shiftKey ||
+      event.altKey
+    ) {
+      return;
+    }
+    event.preventDefault();
+    act(value);
+  }
 </script>
 
 {#if inputs.pagination.has_other_pages || inputs.pagination.has_next || inputs.pagination.has_previous}
@@ -67,13 +114,22 @@
       attributes.class,
     ]}
   >
-    <button
-      type="button"
+    <svelte:element
+      this={previousHref.value ? 'a' : 'button'}
+      type={previousHref.value ? undefined : 'button'}
+      href={previousHref.value}
+      rel={previousHref.value ? 'prev' : undefined}
       aria-label={inputs.compact ? labels.value.previous : undefined}
       title={inputs.compact ? labels.value.previous : undefined}
-      disabled={inputs.pending || !inputs.pagination.has_previous}
-      onclick={() => {
-        change(inputs.pagination.previous_page_number || page.value - 1);
+      disabled={previousHref.value
+        ? undefined
+        : inputs.pending || !inputs.pagination.has_previous}
+      onclick={(event: MouseEvent) => {
+        if (previousHref.value) {
+          follow(event, previousPage.value, change);
+        } else {
+          change(previousPage.value);
+        }
       }}
       class={['op-feature-button']}
     >
@@ -93,7 +149,7 @@
       {:else}
         {labels.value.previous}
       {/if}
-    </button>
+    </svelte:element>
     <span class={['tabular-nums']}>
       {labels.value.page}
       {page.value}
@@ -101,17 +157,22 @@
         / {inputs.pagination.pages}
       {/if}
     </span>
-    <button
-      type="button"
+    <svelte:element
+      this={nextHref.value ? 'a' : 'button'}
+      type={nextHref.value ? undefined : 'button'}
+      href={nextHref.value}
+      rel={nextHref.value ? 'next' : undefined}
       aria-label={inputs.compact ? labels.value.next : undefined}
       title={inputs.compact ? labels.value.next : undefined}
-      disabled={inputs.pending || !inputs.pagination.has_next}
-      onclick={() => {
-        change(
-          typeof inputs.pagination.next_page_number === 'number'
-            ? inputs.pagination.next_page_number
-            : page.value + 1,
-        );
+      disabled={nextHref.value
+        ? undefined
+        : inputs.pending || !inputs.pagination.has_next}
+      onclick={(event: MouseEvent) => {
+        if (nextHref.value) {
+          follow(event, nextPage.value, change);
+        } else {
+          change(nextPage.value);
+        }
       }}
       class={['op-feature-button']}
     >
@@ -131,6 +192,6 @@
       {:else}
         {labels.value.next}
       {/if}
-    </button>
+    </svelte:element>
   </nav>
 {/if}

package/templates/src/lib/components/orionplace/stores/StorefrontStores.svelte

@@ -397,6 +397,7 @@
   <StorefrontPagination
     pagination={pagination.value}
     pending={busy.value}
+    linked={!inputs.storeId}
     onChange={(page: number) => (inputs.storeId ? load(page) : open(page))}
   />
 </section>

package/templates/src/lib/composables/useOrionplacePageSeo.svelte.ts

@@ -2,11 +2,16 @@ import { page as currentPage } from '$app/state';
 import { browser } from '$app/environment';
 import { computed, toValue } from '@/lib/orionplace/reactivity.svelte';
 import type { MaybeRefOrGetter } from '@/lib/orionplace/reactivity.svelte';
-import { useHead, useSeoMeta } from '@/lib/orionplace/navigation.svelte';
+import { currentSearch, useHead, useSeoMeta } from '@/lib/orionplace/navigation.svelte';
+import { useOrionplaceStore } from '@/lib/stores/orionplace.svelte';
 import {
   storefrontAbsoluteUrl,
+  storefrontAlternateLinks,
   storefrontCanonicalUrl,
+  storefrontOpenGraphLocale,
+  storefrontOpenGraphType,
   storefrontPageMetadata,
+  storefrontPagedText,
   storefrontPublicOrigin,
 } from '@/lib/utils/orionplace/pageSeo';
 import type { StorefrontSeoPage } from '@/lib/utils/orionplace/pageSeo';
@@ -21,6 +26,9 @@ export function useOrionplacePageSeo(
     keywords?: MaybeRefOrGetter<string | undefined>;
     robots?: MaybeRefOrGetter<string | undefined>;
     image?: MaybeRefOrGetter<string | undefined>;
+    /** A journal article's dates (ISO 8601) for article:published_time. */
+    published?: MaybeRefOrGetter<string | undefined>;
+    modified?: MaybeRefOrGetter<string | undefined>;
     /**
      * The page's schema.org data (a record page, e.g. the product), built
      * from its canonical address and the visitor's origin. A page without a
@@ -29,6 +37,7 @@ export function useOrionplacePageSeo(
     structuredData?: (canonical: string, origin: string) => unknown;
   } = {},
 ) {
+  const store     = useOrionplaceStore();
   // The address the visitor used: the proxy's host during the server render.
   const origin    = browser
     ? window.location.origin
@@ -44,25 +53,49 @@ export function useOrionplacePageSeo(
     storefrontCanonicalUrl(
       origin,
       currentPage.url.pathname,
-      currentPage.url.search,
+      currentSearch(),
       toValue(locale),
       toValue(values.robots),
     ),
   );
 
+  // A later list page (`?page=2`) names its page number.
+  const paged     = computed(() => ({
+    title:
+      storefrontPagedText(metadata.value.title, canonical.value, toValue(locale)) ??
+      metadata.value.title,
+    description:
+      storefrontPagedText(
+        metadata.value.description,
+        canonical.value,
+        toValue(locale),
+      ) ?? metadata.value.description,
+  }));
+
   // Link previews use the same title and description as the page; the
   // image is the record's first picture when the page has one, as a
   // complete address.
   const seo       = {
-    title: () => metadata.value.title,
-    description: () => metadata.value.description,
+    title: () => paged.value.title,
+    description: () => paged.value.description,
     keywords: () => metadata.value.keywords,
     robots: () => toValue(values.robots),
-    ogTitle: () => metadata.value.title,
-    ogDescription: () => metadata.value.description,
+    ogTitle: () => paged.value.title,
+    ogDescription: () => paged.value.description,
     ogImage: () => storefrontAbsoluteUrl(toValue(values.image), origin),
     ogUrl: () => canonical.value,
+    ogType: () => storefrontOpenGraphType(toValue(page)),
+    ogLocale: () => storefrontOpenGraphLocale(toValue(locale)),
+    articlePublishedTime: () => toValue(values.published),
+    articleModifiedTime: () => toValue(values.modified),
   };
+  // The page in the storefront's other languages, beside the canonical one.
+  const alternates = computed(() =>
+    storefrontAlternateLinks(
+      canonical.value,
+      Object.keys(store.init?.locale ?? {}),
+    ),
+  );
   const structured = computed(() =>
     canonical.value && values.structuredData
       ? structuredDataJson(values.structuredData(canonical.value, origin))
@@ -70,7 +103,16 @@ export function useOrionplacePageSeo(
   );
   useSeoMeta(seo);
   useHead(() => ({
-    link: canonical.value ? [{ rel: 'canonical', href: canonical.value }] : [],
+    link: canonical.value
+      ? [
+          { rel: 'canonical', href: canonical.value },
+          ...alternates.value.map((alternate) => ({
+            rel: 'alternate',
+            hreflang: alternate.hreflang,
+            href: alternate.href,
+          })),
+        ]
+      : [],
     jsonLd: structured.value || undefined,
   }));
 }

package/templates/src/lib/composables/useOrionplaceProductSearch.svelte.ts

@@ -9,7 +9,7 @@ import type { MaybeRefOrGetter } from '@/lib/orionplace/reactivity.svelte';
 import { browser } from '$app/environment';
 import { replaceState } from '$app/navigation';
 import { page as currentPage } from '$app/state';
-import { routeHref } from '@/lib/orionplace/navigation.svelte';
+import { noteShallowAddress, routeHref } from '@/lib/orionplace/navigation.svelte';
 import { useOrionplaceStore } from '@/lib/stores/orionplace.svelte';
 import { useOrionplaceApi } from '@/lib/composables/useOrionplaceApi.svelte';
 import { useOrionplaceProgress } from '@/lib/composables/useOrionplaceProgress.svelte';
@@ -260,6 +260,7 @@ export function useOrionplaceProductSearch(
       }),
       currentPage.state,
     );
+    noteShallowAddress();
   }
 
   function cancel() {

package/templates/src/lib/layouts/StorefrontPageHead.svelte

@@ -1,7 +1,11 @@
 <script lang="ts">
   import type { PageHead } from '@/lib/orionplace/navigation.svelte';
+  import { storefrontIconLinks } from '@/lib/utils/orionplace/pageSeo';
 
-  let { metadata }: { metadata: PageHead } = $props();
+  // `icon`: the store's icon from App Load (logos.ico).
+  let { metadata, icon }: { metadata: PageHead; icon?: string | null } =
+    $props();
+  const iconLinks   = $derived(storefrontIconLinks(icon));
 
   // The JSON is escaped by structuredDataJson, so it cannot close the tag.
   const scriptOpen  = '<script type="application/ld+json">';
@@ -13,7 +17,7 @@
 
   {#each metadata.meta ?? [] as meta}
     {#if meta.content}
-      {#if meta.property || meta.name?.startsWith('og:')}
+      {#if meta.property || /^(?:og|article):/.test(meta.name ?? '')}
         <meta
           property={meta.property ?? meta.name}
           content={meta.content}
@@ -31,12 +35,20 @@
     {@html scriptOpen + metadata.jsonLd + scriptClose}
   {/if}
 
-  {#each metadata.link ?? [] as link (link.rel)}
+  {#each metadata.link ?? [] as link (`${link.rel} ${link.hreflang ?? ''}`)}
     {#if link.href}
       <link
         rel={link.rel}
+        hreflang={link.hreflang}
         href={link.href}
       />
     {/if}
   {/each}
+
+  {#each iconLinks as link (link.key)}
+    <link
+      rel={link.rel}
+      href={link.href}
+    />
+  {/each}
 </svelte:head>

package/templates/src/lib/orionplace/appLoadClient.ts

@@ -1,5 +1,6 @@
 import {
   AppLoadError,
+  appLoadRejectedLocale,
   appLoadResult,
   inspectAppLoad,
 } from '@/lib/orionplace/appLoadResult';
@@ -68,6 +69,10 @@ export async function requestBrowserAppLoad(
     });
   }
   const failure     = inspectAppLoad(body, status);
+  // A language the storefront does not have opens its default language.
+  if (failure && locale && appLoadRejectedLocale(failure)) {
+    return requestBrowserAppLoad(signal);
+  }
   if (failure) {
     throw new AppLoadError('Marketplace initialization failed.', failure);
   }

package/templates/src/lib/orionplace/appLoadResult.ts

@@ -108,3 +108,13 @@ export class AppLoadError extends Error {
     this.data = data;
   }
 }
+
+/**
+ * Whether App Load refused the request's language (`?lang=` of a language the
+ * storefront does not have): the backend answers it with field errors and
+ * HTTP 452. The language is the only client value App Load reads, so the
+ * storefront loads again without it.
+ */
+export function appLoadRejectedLocale(failure: AppLoadFailure): boolean {
+  return failure.kind === 'validation' || failure.httpStatus === 452;
+}

package/templates/src/lib/orionplace/appLoadServer.ts

@@ -1,6 +1,10 @@
 import { env } from '$env/dynamic/private';
 import { forwardMarketplace } from '@orionplace-runtime/marketplace.mjs';
-import { appLoadResult, inspectAppLoad } from '@/lib/orionplace/appLoadResult';
+import {
+  appLoadRejectedLocale,
+  appLoadResult,
+  inspectAppLoad,
+} from '@/lib/orionplace/appLoadResult';
 import type { OrionplaceSnapshot } from '@/lib/orionplace/appLoadData';
 import type { AppLoadRequest } from '@/lib/interfaces/orionplace/transport';
 import type { Cookies, RequestEvent } from '@sveltejs/kit';
@@ -20,9 +24,13 @@ const FORWARDED = [
   'x-tz',
 ];
 
-function buildRequest(event: RequestEvent, signal: AbortSignal): Request {
+function buildRequest(
+  event: RequestEvent,
+  signal: AbortSignal,
+  withLocale = true,
+): Request {
   const url     = new URL('/api/appload', event.url.origin);
-  const locale  = event.url.searchParams.get('locale');
+  const locale  = withLocale ? event.url.searchParams.get('locale') : null;
   if (locale) {
     url.searchParams.set('lang', locale);
   }
@@ -112,13 +120,14 @@ export interface ServerAppLoad extends OrionplaceSnapshot {
 export async function loadOrionplaceAppLoad(
   event: RequestEvent,
   signal?: AbortSignal,
+  withLocale = true,
 ): Promise<ServerAppLoad> {
   const timeout     = AbortSignal.timeout(35_000);
   const combined    = signal ? AbortSignal.any([signal, timeout]) : timeout;
   let response: Response;
   try {
     response = await forwardMarketplace(
-      buildRequest(event, combined),
+      buildRequest(event, combined, withLocale),
       {
         mimicFrontDomain: env.MIMIC_FRONT_DOMAIN ?? '',
       },
@@ -140,6 +149,16 @@ export async function loadOrionplaceAppLoad(
     body = null;
   }
   const failure     = inspectAppLoad(body, response.status);
+  // An address with a language the storefront does not have (`?locale=xx`)
+  // opens in the storefront's default language instead of the 503 page.
+  if (
+    failure &&
+    withLocale &&
+    event.url.searchParams.get('locale') &&
+    appLoadRejectedLocale(failure)
+  ) {
+    return loadOrionplaceAppLoad(event, signal, false);
+  }
   if (failure) {
     return { result: null, failure, cookies };
   }

package/templates/src/lib/orionplace/navigation.svelte.ts

@@ -6,6 +6,25 @@ import { getContext, setContext, untrack } from 'svelte';
 import { computed, ref } from '@/lib/orionplace/reactivity.svelte';
 import type { Ref } from '@/lib/orionplace/reactivity.svelte';
 
+// A shallow replaceState (a product list's page and filters) leaves
+// `page.url` as it was, so the address bar is read again after each one.
+const shallowAddress = $state({ version: 0 });
+
+/** Call after a shallow replaceState that changed the address. */
+export function noteShallowAddress() {
+  shallowAddress.version += 1;
+}
+
+/**
+ * The query string of the address shown (`?locale=en&page=2`), also after a
+ * shallow replaceState; reactive in components and computed values.
+ */
+export function currentSearch(): string {
+  const fromPage = page.url.search;
+  void shallowAddress.version;
+  return browser ? window.location.search : fromPage;
+}
+
 export function routeHref(target: unknown): string {
   if (typeof target === 'string') {
     return target;
@@ -103,8 +122,9 @@ const headKey = Symbol('orionplace-head');
 export interface PageHead {
   title?: string;
   meta?: Record<string, any>[];
-  // <link> tags, one per `rel` (the canonical address).
-  link?: { rel: string; href: string }[];
+  // <link> tags, one per `rel` and `hreflang` (the canonical address and
+  // the page in other languages).
+  link?: { rel: string; href: string; hreflang?: string }[];
   // The page's schema.org data as JSON (structuredDataJson), if it has any.
   jsonLd?: string;
 }
@@ -114,7 +134,7 @@ function collectHead(readers: HeadReader[]): PageHead {
   let title: string | undefined;
   let jsonLd: string | undefined;
   const meta = new Map<string, Record<string, any>>();
-  const link = new Map<string, { rel: string; href: string }>();
+  const link = new Map<string, { rel: string; href: string; hreflang?: string }>();
   for (const read of readers) {
     const head = read();
     title      = head.title ?? title;
@@ -126,7 +146,7 @@ function collectHead(readers: HeadReader[]): PageHead {
       }
     }
     for (const tag of head.link ?? []) {
-      link.set(tag.rel, tag);
+      link.set(`${tag.rel} ${tag.hreflang ?? ''}`, tag);
     }
   }
   return {
@@ -180,6 +200,13 @@ export function useHead(source: PageHead | (() => PageHead)) {
     return () => untrack(() => registry.remove(read));
   });
 }
+// The other Open Graph names the pages set (useSeoMeta keys, as in Nuxt).
+const seoMetaNames: Record<string, string> = {
+  ogType: 'og:type',
+  ogLocale: 'og:locale',
+  articlePublishedTime: 'article:published_time',
+  articleModifiedTime: 'article:modified_time',
+};
 export function useSeoMeta(source: Record<string, any>) {
   useHead(() => ({
     title: typeof source.title === 'function' ? source.title() : source.title,
@@ -195,7 +222,7 @@ export function useSeoMeta(source: Record<string, any>) {
                 ? 'og:image'
                 : name === 'ogUrl'
                   ? 'og:url'
-                  : name,
+                  : (seoMetaNames[name] ?? name),
         content: typeof value === 'function' ? value() : value,
       })),
   }));

package/templates/src/lib/orionplace/pageLoad.ts

@@ -10,8 +10,10 @@ import {
   blogPageSize,
   blogViewType,
   blogPostsRequest,
+  journalPagePastEnd,
   requestBlogPost,
 } from '@/lib/utils/orionplace/blogLayout';
+import type { IBlogJournalPage } from '@/lib/utils/orionplace/blogLayout';
 import type { OrionplaceApi } from '@/lib/utils/orionplace/api';
 import type { OrionplaceSnapshot } from '@/lib/orionplace/appLoadData';
 
@@ -66,6 +68,7 @@ export async function loadStorefrontPageData(
   }
   const api                           = createApi(store);
   const data: Record<string, unknown> = {};
+  let journalPastEnd                  = false;
   const numberId                      = (value: string | null | undefined) =>
     /^[1-9]\d*$/.test(value ?? '') ? Number(value) : undefined;
   const id                            = numberId(event.params.id);
@@ -129,7 +132,7 @@ export async function loadStorefrontPageData(
         const pageSize                                 = blogPageSize(
           blogViewType(store.init?.visual_settings?.blog_view_type),
         );
-        data[`orionplace:journal:${page}:${pageSize}`] = {
+        const journalPage: IBlogJournalPage            = {
           page,
           pageSize,
           data: await api.request(
@@ -137,6 +140,10 @@ export async function loadStorefrontPageData(
             blogPostsRequest({}, page, pageSize),
           ),
         };
+        data[`orionplace:journal:${page}:${pageSize}`] = journalPage;
+        // A page number past the last page has no articles: 404, so search
+        // engines drop it instead of indexing an empty list.
+        journalPastEnd                                 = journalPagePastEnd(page, journalPage);
       } else if (path.startsWith('/journal/') && id) {
         const post                            = await requestBlogPost(api, id);
         data[`orionplace:journal-post:${id}`] = { post: post ?? null };
@@ -158,6 +165,7 @@ export async function loadStorefrontPageData(
       ? data[`orionplace:tariff:${id}`]
       : undefined;
   if (
+    journalPastEnd ||
     (record as { found?: boolean } | undefined)?.found === false ||
     (data[`orionplace:journal-post:${id}`] as { post?: unknown } | undefined)
       ?.post === null

package/templates/src/lib/utils/orionplace/blogLayout.ts

@@ -93,3 +93,16 @@ export function blogCoverInitial(title: string) {
 export function blogCoverPattern(postId: number) {
   return Math.abs(postId) % 3;
 }
+
+/**
+ * Whether a journal page number lies past the last page: the server render
+ * loaded that page (no filters) and it has no articles. Page 1 of an empty
+ * journal is a page of its own.
+ */
+export function journalPagePastEnd(
+  page: number,
+  loaded: IBlogJournalPage | null | undefined,
+): boolean {
+  const posts = loaded?.data?.posts?.data;
+  return page > 1 && loaded?.page === page && Array.isArray(posts) && !posts.length;
+}

package/templates/src/lib/utils/orionplace/pageSeo.ts

@@ -263,17 +263,157 @@ const pageCopy = {
       'error, store',
     ],
   },
+  es: {
+    tariffs: [
+      'Planes de suscripción',
+      'Precios por periodo, periodos de prueba y opciones de cada plan.',
+      'planes, suscripciones, prueba',
+    ],
+    tariff: [
+      'Plan de suscripción',
+      'Descripción, funciones, periodos y opciones de un plan de suscripción.',
+      'plan, suscripción, periodo',
+    ],
+    subscriptions: [
+      'Mis suscripciones',
+      'Fechas de las suscripciones y renovación automática.',
+      'suscripciones, cuenta',
+    ],
+    sellers: ['Vendedores', 'Vendedores y sus productos.', 'vendedores, productos'],
+    stores: [
+      'Tiendas',
+      'Direcciones, contactos y horarios de las tiendas.',
+      'tiendas, direcciones',
+    ],
+    catalog: ['Catálogo', 'Categorías de productos de la tienda.', 'catálogo, categorías'],
+    activity: [
+      'Mi actividad',
+      'Códigos promocionales, reseñas e historial de accesos del cliente.',
+      'cuenta, códigos promocionales, reseñas, accesos',
+    ],
+    promo: [
+      'Productos del código promocional',
+      'Productos de la tienda a los que se aplica la oferta del código promocional.',
+      'código promocional, oferta, productos',
+    ],
+    wishlist: [
+      'Favoritos',
+      'Productos guardados y avisos de disponibilidad.',
+      'favoritos, productos',
+    ],
+    contact: [
+      'Contacto',
+      'Datos de contacto de la empresa y formulario de mensajes de la tienda.',
+      'contacto, mensaje',
+    ],
+    privacy: [
+      'Política de privacidad',
+      'Qué datos recibe la tienda, para qué, a quién los transmite y qué cookies usa el sitio.',
+      'datos personales, privacidad, cookies',
+    ],
+    unsubscribe: [
+      'Preferencias de correo',
+      'Darse de baja de los correos de la tienda.',
+      'correos, baja',
+    ],
+    tickets: [
+      'Soporte',
+      'Conversaciones del usuario con el soporte.',
+      'soporte, conversaciones',
+    ],
+    orders: [
+      'Mis pedidos',
+      'Historial de pedidos y artículos comprados.',
+      'pedidos, compras',
+    ],
+    cart: ['Carrito', 'Artículos y pago del pedido.', 'carrito, pago'],
+    addresses: [
+      'Mis direcciones',
+      'Direcciones de entrega guardadas.',
+      'direcciones, entrega',
+    ],
+    wallet: [
+      'Monedero y pagos',
+      'Saldo e historial de pagos.',
+      'monedero, pagos',
+    ],
+    home: [
+      'Tienda',
+      'Categorías y productos de la tienda.',
+      'tienda, catálogo, productos',
+    ],
+    browse: [
+      'Resultados de búsqueda',
+      'Productos que coinciden con la búsqueda y los filtros elegidos.',
+      'búsqueda de productos, filtros, catálogo',
+    ],
+    featured: [
+      'Destacados',
+      'Productos de las categorías que el cliente ha buscado en la tienda.',
+      'recomendaciones, productos, filtros',
+    ],
+    category: [
+      'Categoría de productos',
+      'Productos y filtros disponibles de la categoría elegida.',
+      'categoría, productos, filtros',
+    ],
+    journal: [
+      'Revista',
+      'Publicaciones de la tienda con títulos, resúmenes y tiempo de lectura.',
+      'revista, publicaciones, artículos',
+    ],
+    publication: [
+      'Publicación de la revista',
+      'Un artículo de la revista de la tienda.',
+      'revista, publicación, artículo',
+    ],
+    product: [
+      'Ficha de producto',
+      'Descripción, precio, variantes y disponibilidad del producto.',
+      'producto, precio, disponibilidad',
+    ],
+    manufacturers: [
+      'Fabricantes',
+      'Fabricantes de la tienda con logotipos e índice alfabético.',
+      'fabricantes, marcas, índice alfabético',
+    ],
+    profile: [
+      'Perfil personal',
+      'Datos personales, correo, notificaciones y contraseña de la cuenta.',
+      'perfil, cuenta, ajustes',
+    ],
+    logout: [
+      'Cerrar sesión',
+      'Fin de la sesión y vuelta a la página principal.',
+      'cuenta, cerrar sesión, sesión',
+    ],
+    notFound: [
+      'Página no encontrada',
+      'No hay ninguna página de la tienda en esta dirección.',
+      'página no encontrada, 404',
+    ],
+    error: [
+      'Algo salió mal',
+      'No se pudo mostrar la página de la tienda.',
+      'error, tienda',
+    ],
+  },
 } as const;
 
 export type StorefrontSeoPage = keyof typeof pageCopy.en;
 
+/** The page copy for a storefront language; languages without one use English. */
+function storefrontCopyLanguage(locale: string): keyof typeof pageCopy {
+  const language = locale.toLowerCase().split(/[-_]/)[0];
+  return language === 'ru' || language === 'es' ? language : 'en';
+}
+
 export function storefrontPageMetadata(
   page: StorefrontSeoPage,
   locale: string,
   values: { title?: string; description?: string; keywords?: string } = {},
 ) {
-  const copy  =
-    pageCopy[locale.toLowerCase().startsWith('ru') ? 'ru' : 'en'][page];
+  const copy  = pageCopy[storefrontCopyLanguage(locale)][page];
   const title = plainText(values.title ?? '') || copy[0];
 
   return {
@@ -320,11 +460,15 @@ export function storefrontAbsoluteUrl(
 // The pages the sitemap lists (runtime/marketplace.mjs), plus plan pages.
 const indexedPage = /^\/(?:|catalog|journal|tariffs|manufacturers|sellers|stores|contact|privacy|(?:category|product|journal)\/\d+|tariffs\/[^/]+\/\d+)$/;
 
+// Listed pages that are lists with page numbers (`?page=2`).
+const pagedList   = /^\/(?:journal|stores|category\/\d+)$/;
+
 /**
  * The canonical address of a page: the sitemap's address for it, the page in
- * the language it shows (`?locale=`). Pages that are not listed, pages with
- * other query parameters (filters, page numbers, private keys) and noindex
- * pages get none.
+ * the language it shows (`?locale=`). A later page of a list is a page of its
+ * own (`?locale=en&page=2`, Google's pagination guide), linked from the
+ * list's page links. Pages that are not listed, pages with other query
+ * parameters (filters, private keys) and noindex pages get none.
  */
 export function storefrontCanonicalUrl(
   origin: string,
@@ -333,9 +477,13 @@ export function storefrontCanonicalUrl(
   locale: string,
   robots?: string,
 ): string | undefined {
-  const path  = pathname.replace(/\/+$/, '') || '/';
-  const query = new URLSearchParams(search);
+  const path       = pathname.replace(/\/+$/, '') || '/';
+  const query      = new URLSearchParams(search);
+  const pageNumber = query.get('page');
   query.delete('locale');
+  if (pageNumber !== null && pagedList.test(path) && /^[1-9]\d{0,5}$/.test(pageNumber)) {
+    query.delete('page');
+  }
   if (
     !origin ||
     /noindex/i.test(robots ?? '') ||
@@ -344,9 +492,171 @@ export function storefrontCanonicalUrl(
   ) {
     return undefined;
   }
-  const url   = new URL(path, `${origin}/`);
+  const url        = new URL(path, `${origin}/`);
   if (locale) {
     url.searchParams.set('locale', locale);
   }
+  if (pageNumber && Number(pageNumber) > 1 && pagedList.test(path)) {
+    url.searchParams.set('page', pageNumber);
+  }
   return url.toString();
 }
+
+/**
+ * A later page of a list repeats the list's title and description; the page
+ * number keeps them distinct (search engines report repeated titles as
+ * duplicates). The number comes from the canonical address, so only the
+ * indexed list pages get it.
+ */
+export function storefrontPagedText(
+  text: string | undefined,
+  canonical: string | undefined,
+  locale: string,
+): string | undefined {
+  const page = canonical ? Number(new URL(canonical).searchParams.get('page')) : 0;
+  if (!text || !(page > 1)) {
+    return text;
+  }
+  const words: Record<string, string> = { ru: 'страница', es: 'página' };
+  const word                          = words[storefrontCopyLanguage(locale)] ?? 'page';
+  return `${text} · ${word} ${page}`;
+}
+
+/**
+ * The address of another page of the list on screen: the current address
+ * with `page=` set (left out for page 1), every other parameter kept. Page
+ * links are real links, so search engines reach every page of a list.
+ */
+export function storefrontPageHref(
+  pathname: string,
+  search: string,
+  page: number,
+): string {
+  const query = new URLSearchParams(search);
+  if (page > 1) {
+    query.set('page', String(page));
+  } else {
+    query.delete('page');
+  }
+  const text  = query.toString();
+  return `${pathname}${text ? `?${text}` : ''}`;
+}
+
+/** og:type of a page: a product and a journal article have their own kinds. */
+export function storefrontOpenGraphType(
+  page: StorefrontSeoPage,
+): 'product' | 'article' | 'website' {
+  if (page === 'product') {
+    return 'product';
+  }
+  return page === 'publication' ? 'article' : 'website';
+}
+
+const openGraphRegions: Record<string, string> = {
+  de: 'de_DE',
+  en: 'en_US',
+  es: 'es_ES',
+  fr: 'fr_FR',
+  it: 'it_IT',
+  kk: 'kk_KZ',
+  pl: 'pl_PL',
+  pt: 'pt_PT',
+  ru: 'ru_RU',
+  tr: 'tr_TR',
+  uk: 'uk_UA',
+  zh: 'zh_CN',
+};
+
+/** og:locale (`language_TERRITORY`) of a storefront language, when it is known. */
+export function storefrontOpenGraphLocale(locale: string): string | undefined {
+  return openGraphRegions[locale.toLowerCase().split(/[-_]/)[0]!];
+}
+
+/**
+ * The same page in every storefront language (hreflang), for a page with a
+ * canonical address: the canonical address with each language's `?locale=`,
+ * as the sitemap lists them. Search engines that ignore the sitemap's
+ * language links (Yandex) read these. A single language gives none.
+ */
+export function storefrontAlternateLinks(
+  canonical: string | undefined,
+  locales: string[],
+): { hreflang: string; href: string }[] {
+  const codes = [
+    ...new Set(
+      locales
+        .map((code) => code.trim())
+        .filter((code) => /^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/i.test(code)),
+    ),
+  ];
+  if (!canonical || codes.length < 2) {
+    return [];
+  }
+  return codes.map((code) => {
+    const url = new URL(canonical);
+    url.searchParams.set('locale', code);
+    return { hreflang: code, href: url.toString() };
+  });
+}
+
+/**
+ * A backend date (`d.m.Y`, e.g. `22.09.2026`) as an ISO 8601 date
+ * (`2026-09-22`); anything else gives `undefined`. A date without a time
+ * cannot disagree with the visible date in another time zone.
+ */
+export function storefrontIsoDate(
+  value: string | null | undefined,
+): string | undefined {
+  const match = /^(\d{2})\.(\d{2})\.(\d{4})$/.exec((value ?? '').trim());
+  return match ? `${match[3]}-${match[2]}-${match[1]}` : undefined;
+}
+
+/**
+ * schema.org BlogPosting of a journal article (Google "Article" structured
+ * data): headline, cover, dates, and the store as author and publisher.
+ */
+export function storefrontArticleData(input: {
+  canonical: string;
+  origin: string;
+  headline: string;
+  description?: string;
+  image?: string;
+  published?: string;
+  modified?: string;
+  locale: string;
+  storeName?: string;
+}): Record<string, unknown> {
+  const store = {
+    '@type': 'Organization',
+    name: input.storeName || new URL(input.origin).hostname,
+    url: `${input.origin}/`,
+  };
+  const modified = input.modified || input.published;
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'BlogPosting',
+    '@id': `${input.canonical}#article`,
+    mainEntityOfPage: input.canonical,
+    url: input.canonical,
+    headline: input.headline.slice(0, 110),
+    ...(input.description ? { description: input.description } : {}),
+    ...(input.image ? { image: [input.image] } : {}),
+    ...(input.published ? { datePublished: input.published } : {}),
+    ...(modified ? { dateModified: modified } : {}),
+    inLanguage: input.locale,
+    author: store,
+    publisher: store,
+  };
+}
+
+/**
+ * The store's icon (App Load `logos.ico`) as `<link rel="icon">` tags: search
+ * engines read the icon from the home page. Only a complete http(s) address
+ * is used; the type is left out, so it cannot disagree with the file.
+ */
+export function storefrontIconLinks(
+  icon: string | null | undefined,
+): { key: string; rel: 'icon'; href: string }[] {
+  const href = storefrontAbsoluteUrl(icon, '');
+  return href ? [{ key: 'icon', rel: 'icon', href }] : [];
+}

package/templates/src/routes/+layout.svelte

@@ -134,7 +134,10 @@
 </OrionplaceThemeProvider>
 
 <!-- Render after the page registers its metadata during server rendering. -->
-<StorefrontPageHead metadata={metadata.value} />
+<StorefrontPageHead
+  metadata={metadata.value}
+  icon={marketplace.init?.logos?.ico}
+/>
 
 <style>
   .storefront-progress {

package/templates/src/routes/journal/[id]/+page.svelte

@@ -7,6 +7,11 @@
   import { useOrionplaceStorefront } from '@/lib/composables/useOrionplaceStorefront.svelte';
   import { useOrionplaceServerData } from '@/lib/composables/useOrionplaceServerData.svelte';
   import { requestBlogPost } from '@/lib/utils/orionplace/blogLayout';
+  import {
+    storefrontAbsoluteUrl,
+    storefrontArticleData,
+    storefrontIsoDate,
+  } from '@/lib/utils/orionplace/pageSeo';
   import {
     getAvailableNestedValueFromObject,
     plainText,
@@ -77,6 +82,37 @@
         ),
       ).slice(0, 160),
     image: () => cover.value,
+    published: () => storefrontIsoDate(post.value?.date_created?.date),
+    modified: () =>
+      storefrontIsoDate(post.value?.date_updated?.date) ??
+      storefrontIsoDate(post.value?.date_created?.date),
+    // The article as schema.org BlogPosting, with the store as its author.
+    structuredData: (canonical, origin) =>
+      post.value
+        ? storefrontArticleData({
+            canonical,
+            origin,
+            headline:
+              getAvailableNestedValueFromObject(
+                post.value.locale,
+                store.localeCode,
+                'post_title',
+              ) ?? '',
+            description:
+              plainText(
+                getAvailableNestedValueFromObject(
+                  post.value.locale,
+                  store.localeCode,
+                  'post_preview_text',
+                ),
+              ).slice(0, 160) || undefined,
+            image: storefrontAbsoluteUrl(cover.value, origin),
+            published: storefrontIsoDate(post.value.date_created?.date),
+            modified: storefrontIsoDate(post.value.date_updated?.date),
+            locale: store.localeCode,
+            storeName: store.init?.contact?.company_name,
+          })
+        : undefined,
   });
 
   // An invalid ID, or an article that blog_posts_get does not return,