@salla.sa/twilight-theme-engine 1.0.109 → 1.0.110

package/dist/utils/cookies.d.ts

@@ -1,6 +1,12 @@
 export declare const AUTH_TOKEN_COOKIE_NAME = "token";
 export declare const SCOPE_COOKIE_NAME = "scope";
 export declare const CURRENCY_COOKIE_NAME = "s-curr";
+/** The language the SDK's localization modal remembers; host-wide, so shared by every store on a shared host. */
+export declare const LANGUAGE_COOKIE_NAME = "s-lang";
+/** Query parameter the localization modal navigates with to ask for a language. */
+export declare const LANGUAGE_PARAM = "lang";
+/** How long a language choice is remembered: one year, like the `scope` cookie. */
+export declare const LANGUAGE_COOKIE_MAX_AGE: number;
 /**
  * Which store this request is for, when the hostname does not say.
  *

package/dist/utils/cookies.d.ts.map

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

package/dist/utils/index.js

@@ -1,16 +1,16 @@
 export { stripUnsafeHtml } from '../chunk-RUHSV4Z6.js';
 export { formatSallaPlural } from '../chunk-BT6HEEAP.js';
-export { dispatchRouteChanged } from '../chunk-RJ5HY6PN.js';
+export { dispatchRouteChanged } from '../chunk-EJLVOWXU.js';
 export { sortOptions } from '../chunk-3LZJXKVO.js';
 export { color } from '../chunk-VVZNW5CB.js';
-export { applyAppScopeMocks, registerThemeHookSlots } from '../chunk-GGATZRAY.js';
+export { applyAppScopeMocks, registerThemeHookSlots } from '../chunk-I7WSIN27.js';
 export { mergeHead, resolveHead, setHeadAdapter } from '../chunk-GD26FI4J.js';
-export { buildBaseHead, buildHreflangAlternates, localeToOgLocale } from '../chunk-4SZZPXM2.js';
+export { buildBaseHead, buildHreflangAlternates, localeToOgLocale } from '../chunk-TMMK2VYE.js';
 export { asset, cdn, isPlaceholder } from '../chunk-ZCH7W7DZ.js';
 export { mergeDocumentDescriptors, mergeElementAttrs, normalizeClasses, syncAttrsToElement, toReactProps } from '../chunk-CW625T2E.js';
-import '../chunk-TTTI4W5F.js';
-export { getSallaSDK, getStoreIdentifier, onSallaEvent, whenSallaLoaded, whenSallaReady } from '../chunk-L6TSHT52.js';
-export { AUTH_TOKEN_COOKIE_NAME, clearAuthTokenCookie, extractTokenFromCookies } from '../chunk-YUI6R2PA.js';
+import '../chunk-BFA2U7P3.js';
+export { getSallaSDK, getStoreIdentifier, onSallaEvent, whenSallaLoaded, whenSallaReady } from '../chunk-X2JCU7GY.js';
+export { AUTH_TOKEN_COOKIE_NAME, clearAuthTokenCookie, extractTokenFromCookies } from '../chunk-POI4G5EA.js';
 import '../chunk-QRHXAKJ3.js';
 import '../chunk-T72DAX7R.js';
 import '../chunk-DGUM43GV.js';

package/dist/utils/language-cookie.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The query string of the page being rendered (`?lang=en`, or `''`): the request's on the
+ * server, the address bar's in the browser, so both sides read the same one.
+ */
+export declare function readPageSearch(): string;
+/** The `Cookie` header of the request being handled, or `document.cookie` in the browser. */
+export declare function readCookieHeader(): string | null;
+/** Remembers `code` as the visitor's language for every store on this host. */
+export declare function persistLanguageCookie(code: string): void;
+//# sourceMappingURL=language-cookie.d.ts.map

package/dist/utils/language-cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-cookie.d.ts","sourceRoot":"","sources":["../../src/utils/language-cookie.ts"],"names":[],"mappings":"AA+CA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKxD"}

package/dist/utils/shared-host-language.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview The language of a page on a Salla shared host, where the URL does not carry it.
+ *
+ * On `demostore.salla.sa` and `salla.sa` a store is addressed `/dev-x/cart`. The route tree
+ * still has a `/{-$locale}` segment, so the router puts a *virtual* locale in front of the
+ * path on the way in and takes it off on the way out (`tanstack/store-base.ts`). This file
+ * decides which one, and what to do when the choice is not one the store offers. See
+ * `docs/store-base-path.md`.
+ *
+ * Pure: no request, no cookies written. The callers read and write those.
+ */
+import type { StoreContext } from '../api/store';
+/** Whether a query string (with or without the `?`) carries `lang`, whatever its value. */
+export declare function hasLanguageParam(search: string): boolean;
+/** The language the `s-lang` cookie remembers, if it is a known one. */
+export declare function languageFromCookies(cookieHeader: string | null): string | null;
+/**
+ * The language a request on a shared host is for, before the store's settings are known:
+ * `?lang=`, then the `s-lang` cookie, then {@link FALLBACK_LOCALE}. Each must be a language
+ * the engine knows; whether the store offers it is {@link decideSharedHostLanguage}'s
+ * question.
+ */
+export declare function virtualLocale(search: string, cookieHeader: string | null): string;
+/**
+ * Whether the store has more than one language to choose between.
+ *
+ * Both signals count: the merchant's `is_multilingual` switch, and the number of languages
+ * the settings list. Either one saying "single" makes the store single-language. The count
+ * is only used when the settings carry the list at all.
+ */
+export declare function isMultilingualStore(settings: StoreContext | null | undefined): boolean;
+/** The store's default language: the one marked, else the engine's fallback, else the first listed. */
+export declare function defaultLanguage(settings: StoreContext): string | null;
+/**
+ * The languages this store can be shown in, or null when its settings did not list any
+ * (nothing to check against). A store that is not multilingual shows its default only.
+ */
+export declare function offeredLanguages(settings: StoreContext): string[] | null;
+/** `search` (a query string, with or without `?`) without `lang`, and then `lang=<code>` if given. */
+export declare function withLanguageParam(search: string, code?: string): string;
+export interface SharedHostLanguage {
+    /** A language to remember in the `s-lang` cookie, or null to leave the cookie alone. */
+    cookie: string | null;
+    /** Where to send the visitor (path, query and hash, in the address the browser uses), or null to render. */
+    redirectTo: string | null;
+}
+/**
+ * What to do with the language of a page on a shared host, once the store's settings are in.
+ *
+ * - `?lang=` asking for a language the store offers is remembered in the cookie. It is taken
+ *   off the URL with a redirect when that cannot change what the next request renders: the
+ *   cookie already says it, or it is the fallback a cookieless request gets anyway. Otherwise
+ *   it stays, so a visitor whose browser drops the cookie is not sent round in circles.
+ * - `?lang=` asking for one the store does not offer is dropped, and nothing is remembered.
+ * - No `?lang=`, and the language the request resolved to is not offered (a stale cookie
+ *   from another store on this host, or the fallback of a store that does not offer it):
+ *   sent to `?lang=<the store's default>`.
+ *
+ * Every redirect either removes `?lang=` or adds one for an offered language, so none
+ * returns the request to itself.
+ *
+ * @param href - the browser's address for this page: path (with the store segment, without
+ *   a language), query and hash.
+ * @param locale - the language the request resolved to ({@link virtualLocale}).
+ */
+export declare function decideSharedHostLanguage(args: {
+    settings: StoreContext;
+    locale: string;
+    href: string;
+    cookieHeader: string | null;
+}): SharedHostLanguage;
+//# sourceMappingURL=shared-host-language.d.ts.map

package/dist/utils/shared-host-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-host-language.d.ts","sourceRoot":"","sources":["../../src/utils/shared-host-language.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA2BjD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEjF;AAUD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGtF;AAED,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAOrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,IAAI,CAMxE;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4GAA4G;IAC5G,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,kBAAkB,CAyBrB"}

package/dist/utils/store-base.d.ts

@@ -5,11 +5,19 @@
  * pathname that does not start with the segment comes back unchanged.
  *
  * With `followsLocale` the segment is also taken from behind a leading locale,
- * where Salla's shared hosts put it (`/ar/dev-x/cart` → `/ar/cart`). It is looked
- * for there first, then at the root, which is where a store that is not
- * multilingual has it (`/dev-x/cart`).
+ * where Salla's shared hosts used to put it (`/ar/dev-x/cart` → `/ar/cart`). It is
+ * looked for there first, then at the root, which is where it is now
+ * (`/dev-x/cart`).
  */
 export declare function stripStoreBase(pathname: string, base: string, followsLocale?: boolean): string;
+/**
+ * A rooted path split into its first segment and what follows it (a path, a query, a hash, or
+ * nothing). The segment ends at the first `/`, `?` or `#`. Plain string work, no pattern.
+ */
+export declare function splitLeadingSegment(rooted: string): {
+    first: string;
+    rest: string;
+};
 /**
  * An application path as the browser addresses it, with the store segment in front.
  *
@@ -17,11 +25,25 @@ export declare function stripStoreBase(pathname: string, base: string, followsLo
  * told apart from a page of the same name: a store called `cart` keeps its cart at
  * `/cart/cart`. Callers pass application paths only.
  *
- * With `followsLocale` the segment goes behind a leading locale instead, which is
- * the address Salla gives a store on a shared host (`/ar/cart` → `/ar/dev-x/cart`,
- * the same shape as its `store.url`). A path with no locale still gets it in front.
+ * With `followsLocale` (a Salla shared host) the address has no language in it at
+ * all: a leading locale is dropped (`/ar/cart` → `/dev-x/cart`). The language comes
+ * back from `?lang=` or the `s-lang` cookie on the way in (`tanstack/store-base.ts`).
  */
 export declare function prefixStoreBase(path: string, base: string, followsLocale?: boolean): string;
+/**
+ * Where to send a request that still uses the old shared-host address, or null when it
+ * does not.
+ *
+ * Shared hosts used to put the language in front of the store (`/ar/dev-x/cart`) and now
+ * leave it out (`/dev-x/cart`). A link in the old shape is sent once to the new one,
+ * carrying its language as `?lang=` so the visitor keeps it; the page then remembers it
+ * and the language stays out of the address (`rootBeforeLoad`).
+ *
+ * Only a path that *starts* with a locale and then names this store as a whole segment
+ * matches, so a page whose slug is a locale code, or that is spelled like the store, is
+ * never redirected. The result is a relative path: it cannot leave the host.
+ */
+export declare function legacyLocaleRedirectHref(url: string, base: string): string | null;
 /**
  * A pathname from a link the Salla API handed out, without the store's username in it.
  *

package/dist/utils/store-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-base.d.ts","sourceRoot":"","sources":["../../src/utils/store-base.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,MAAM,CAY5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,MAAM,CAWzF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAMT;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,GAAG,IAAI,CAShB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,MAAM,GAAG,IAAI,CAUhB"}
+{"version":3,"file":"store-base.d.ts","sourceRoot":"","sources":["../../src/utils/store-base.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,MAAM,CAY5F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,MAAM,CAYzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBjF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAMT;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,GAAG,IAAI,CAShB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,MAAM,GAAG,IAAI,CAUhB"}

package/dist/vite/index.js

@@ -1,12 +1,13 @@
 import { validateTwilightManifest } from '../chunk-X5NK4TZH.js';
 export { REACT_THEME_TYPE, describeThemeTypeIssue, getThemeType, isReactThemeManifest, validateTwilightManifest } from '../chunk-X5NK4TZH.js';
-import { tanstackHeadAdapter } from '../chunk-UCJNWQF2.js';
+import { tanstackHeadAdapter } from '../chunk-4INSECDW.js';
 import { nextjsHeadAdapter } from '../chunk-HOSHJBPS.js';
 import '../chunk-LZZ6EESI.js';
 import { EMPTY_DEV_SCHEMA, DEV_PREVIEW_GLOBAL, DEV_PREVIEW_ENDPOINT, normalizePreviewState, DEV_PREVIEW_EVENT, DEV_EDITOR_PATH, DEV_PREVIEW_IMAGE_ENDPOINT, DEV_PREVIEW_IMAGE_MAX_BYTES } from '../chunk-OXMUPNMH.js';
 import { setHeadAdapter } from '../chunk-GD26FI4J.js';
-import '../chunk-4SZZPXM2.js';
+import '../chunk-TMMK2VYE.js';
 import { RouteId } from '../chunk-OUW6WESU.js';
+import '../chunk-POI4G5EA.js';
 import '../chunk-QRHXAKJ3.js';
 import '../chunk-T72DAX7R.js';
 import '../chunk-DGUM43GV.js';
@@ -1871,12 +1872,47 @@ export const Route = createFileRoute('/{-$locale}')({
     }
   },
   loader: async ({ params, context, location }) => {
+    // On a Salla shared host the address never carries a language: the router adds a virtual
+    // one on the way in and strips it on the way out, and \`rootBeforeLoad\` settles which
+    // language the store shows (\`?lang=\`, the \`s-lang\` cookie, the store's default). A redirect
+    // here between locale-less and locale-bearing paths would come back as the same URL.
+    if (context.storeBaseFollowsLocale) return;
+
     const settings = await context.queryClient.ensureQueryData(store.queries.settings());
-    const isMultilingual = settings?.store?.settings?.is_multilingual ?? true;
+    // Single-language when the merchant says so, or when the store lists fewer than two
+    // languages. A page with no locale is read as FALLBACK_LOCALE (\`rootBeforeLoad\`), so a
+    // single-language store in another language keeps its segment instead: it is what the
+    // page is addressed and read by. Without it an English-only store would render in Arabic.
+    const listed = settings?.languages;
+    const soleEntry = listed?.length === 1 ? listed[0] : undefined;
+    const soleLang = soleEntry ? (soleEntry.iso_code ?? soleEntry.code)?.toLowerCase() : undefined;
+    const single =
+      settings?.store?.settings?.is_multilingual === false || (listed != null && listed.length < 2);
+    const segment = single && isLocale(soleLang) && soleLang !== FALLBACK_LOCALE ? soleLang : null;
+    const isMultilingual = !single;
+    const pathWithoutLocale = params.locale
+      ? location.pathname.slice(params.locale.length + 1) || '/'
+      : location.pathname;
 
-    if (!isMultilingual && params.locale) {
+    if (!isMultilingual && !segment && params.locale) {
+      throw redirect({
+        to: pathWithoutLocale,
+        search: location.search,
+        replace: true,
+      });
+    }
+    if (!isMultilingual && segment && params.locale !== segment) {
+      // The store's one language, wherever the path pointed: the right page, and the one
+      // every other rule sends this visitor to.
+      throw redirect({
+        to: \`/\${segment}\${pathWithoutLocale === '/' ? '' : pathWithoutLocale}\`,
+        search: location.search,
+        replace: true,
+      });
+    }
+    if (!isMultilingual && segment && !params.locale) {
       throw redirect({
-        to: location.pathname.slice(\`/\${params.locale}\`.length) || '/',
+        to: \`/\${segment}\${location.pathname === '/' ? '' : location.pathname}\`,
         search: location.search,
         replace: true,
       });