@shop-on/theme-runtime 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -12,12 +12,14 @@ import { isDefaultSingleVariant } from "./product-variants/is-default-single-var
 import { isVariantSelectable } from "./product-variants/is-variant-selectable.js";
 import { ResolvedVariant, resolveSelectedVariant } from "./product-variants/resolve-selected-variant.js";
 import { selectionKey } from "./product-variants/selection-key.js";
+import { ArticleSchemaSource, BlockInstance, BreadcrumbSchemaSource, ProductSchemaSource, SectionGroupConfig, TemplateJSON, TemplateSeoSource, WebsiteSchemaSource } from "./template-types.js";
+import { staleVariantFlag } from "./product-variants/stale-variant.js";
 import { SwatchSource, isSwatchOption, swatchSource } from "./product-variants/swatch-source.js";
 import { VariantPriceRange, variantPriceRange } from "./product-variants/variant-price-range.js";
+import "./product-variants/index.js";
 import { productHref } from "./product-href.js";
 import { isOnSale, savePercent } from "./sale.js";
 import { BuildSeoHeadArgs, SEO_DESCRIPTION_MAX_LENGTH, SeoHead, buildSeoHead, canonicalPath, isNarrowedListing, truncateSeoDescription } from "./seo.js";
 import { stripPostAuthParams } from "./strip-handoff-url.js";
-import { ArticleSchemaSource, BlockInstance, BreadcrumbSchemaSource, ProductSchemaSource, SectionGroupConfig, TemplateJSON, TemplateSeoSource, WebsiteSchemaSource } from "./template-types.js";
 import { thumbhashDataUrl } from "./thumbhash.js";
-export { ArticleSchemaSource, BlockInstance, BreadcrumbSchemaSource, BuildSeoHeadArgs, Embed, EmbedKind, type LinkedMetafieldRef, type LinkedMetaobject, type LinkedMetaobjectField, Money, type OptionAvailability, PlayerEmbed, type ProductForVariantState, type ProductOption, type ProductOptionValue, ProductSchemaSource, type ProductVariant, type ResolvedVariant, SEO_DESCRIPTION_MAX_LENGTH, SectionGroupConfig, type SelectedOption, SeoHead, type SwatchSource, type SwatchVariant, TemplateJSON, TemplateSeoSource, type VariantPriceRange, type VariantState, WebsiteSchemaSource, buildAvailabilityIndex, buildSeoHead, buildVariantState, canonicalPath, currencySymbol, defaultPriceMaxBound, embedBackgroundSrc, escapeForScriptTag, findClosestVariant, formatMoney, formatMoneyWithCurrency, initials, isDefaultSingleVariant, isNarrowedListing, isOnSale, isSwatchOption, isVariantSelectable, pageCursor, parseEmbedUrl, productHref, resolveSelectedVariant, savePercent, selectionKey, stripPostAuthParams, swatchSource, thumbhashDataUrl, truncateSeoDescription, variantPriceRange };
+export { ArticleSchemaSource, BlockInstance, BreadcrumbSchemaSource, BuildSeoHeadArgs, Embed, EmbedKind, type LinkedMetafieldRef, type LinkedMetaobject, type LinkedMetaobjectField, Money, type OptionAvailability, PlayerEmbed, type ProductForVariantState, type ProductOption, type ProductOptionValue, ProductSchemaSource, type ProductVariant, type ResolvedVariant, SEO_DESCRIPTION_MAX_LENGTH, SectionGroupConfig, type SelectedOption, SeoHead, type SwatchSource, type SwatchVariant, TemplateJSON, TemplateSeoSource, type VariantPriceRange, type VariantState, WebsiteSchemaSource, buildAvailabilityIndex, buildSeoHead, buildVariantState, canonicalPath, currencySymbol, defaultPriceMaxBound, embedBackgroundSrc, escapeForScriptTag, findClosestVariant, formatMoney, formatMoneyWithCurrency, initials, isDefaultSingleVariant, isNarrowedListing, isOnSale, isSwatchOption, isVariantSelectable, pageCursor, parseEmbedUrl, productHref, resolveSelectedVariant, savePercent, selectionKey, staleVariantFlag, stripPostAuthParams, swatchSource, thumbhashDataUrl, truncateSeoDescription, variantPriceRange };

package/dist/index.js

@@ -11,6 +11,7 @@ import { findClosestVariant } from "./product-variants/find-closest-variant.js";
 import { isDefaultSingleVariant } from "./product-variants/is-default-single-variant.js";
 import { isVariantSelectable } from "./product-variants/is-variant-selectable.js";
 import { selectionKey } from "./product-variants/selection-key.js";
+import { staleVariantFlag } from "./product-variants/stale-variant.js";
 import { isSwatchOption, swatchSource } from "./product-variants/swatch-source.js";
 import { variantPriceRange } from "./product-variants/variant-price-range.js";
 import { productHref } from "./product-href.js";
@@ -18,4 +19,4 @@ import { isOnSale, savePercent } from "./sale.js";
 import { SEO_DESCRIPTION_MAX_LENGTH, buildSeoHead, canonicalPath, isNarrowedListing, truncateSeoDescription } from "./seo.js";
 import { stripPostAuthParams } from "./strip-handoff-url.js";
 import { thumbhashDataUrl } from "./thumbhash.js";
-export { SEO_DESCRIPTION_MAX_LENGTH, buildAvailabilityIndex, buildSeoHead, buildVariantState, canonicalPath, currencySymbol, defaultPriceMaxBound, embedBackgroundSrc, escapeForScriptTag, findClosestVariant, formatMoney, formatMoneyWithCurrency, initials, isDefaultSingleVariant, isNarrowedListing, isOnSale, isSwatchOption, isVariantSelectable, pageCursor, parseEmbedUrl, productHref, resolveSelectedVariant, savePercent, selectionKey, stripPostAuthParams, swatchSource, thumbhashDataUrl, truncateSeoDescription, variantPriceRange };
+export { SEO_DESCRIPTION_MAX_LENGTH, buildAvailabilityIndex, buildSeoHead, buildVariantState, canonicalPath, currencySymbol, defaultPriceMaxBound, embedBackgroundSrc, escapeForScriptTag, findClosestVariant, formatMoney, formatMoneyWithCurrency, initials, isDefaultSingleVariant, isNarrowedListing, isOnSale, isSwatchOption, isVariantSelectable, pageCursor, parseEmbedUrl, productHref, resolveSelectedVariant, savePercent, selectionKey, staleVariantFlag, stripPostAuthParams, swatchSource, thumbhashDataUrl, truncateSeoDescription, variantPriceRange };

package/dist/product-variants/index.d.ts

@@ -6,6 +6,7 @@ import { isDefaultSingleVariant } from "./is-default-single-variant.js";
 import { isVariantSelectable } from "./is-variant-selectable.js";
 import { ResolvedVariant, resolveSelectedVariant } from "./resolve-selected-variant.js";
 import { selectionKey } from "./selection-key.js";
+import { staleVariantFlag } from "./stale-variant.js";
 import { SwatchSource, isSwatchOption, swatchSource } from "./swatch-source.js";
 import { VariantPriceRange, variantPriceRange } from "./variant-price-range.js";
-export { type LinkedMetafieldRef, type LinkedMetaobject, type LinkedMetaobjectField, type OptionAvailability, type ProductForVariantState, type ProductOption, type ProductOptionValue, type ProductVariant, type ResolvedVariant, type SelectedOption, type SwatchSource, type SwatchVariant, type VariantPriceRange, type VariantState, buildAvailabilityIndex, buildVariantState, findClosestVariant, isDefaultSingleVariant, isSwatchOption, isVariantSelectable, resolveSelectedVariant, selectionKey, swatchSource, variantPriceRange };
+export { type LinkedMetafieldRef, type LinkedMetaobject, type LinkedMetaobjectField, type OptionAvailability, type ProductForVariantState, type ProductOption, type ProductOptionValue, type ProductVariant, type ResolvedVariant, type SelectedOption, type SwatchSource, type SwatchVariant, type VariantPriceRange, type VariantState, buildAvailabilityIndex, buildVariantState, findClosestVariant, isDefaultSingleVariant, isSwatchOption, isVariantSelectable, resolveSelectedVariant, selectionKey, staleVariantFlag, swatchSource, variantPriceRange };

package/dist/product-variants/index.js

@@ -5,6 +5,7 @@ import { findClosestVariant } from "./find-closest-variant.js";
 import { isDefaultSingleVariant } from "./is-default-single-variant.js";
 import { isVariantSelectable } from "./is-variant-selectable.js";
 import { selectionKey } from "./selection-key.js";
+import { staleVariantFlag } from "./stale-variant.js";
 import { isSwatchOption, swatchSource } from "./swatch-source.js";
 import { variantPriceRange } from "./variant-price-range.js";
-export { buildAvailabilityIndex, buildVariantState, findClosestVariant, isDefaultSingleVariant, isSwatchOption, isVariantSelectable, resolveSelectedVariant, selectionKey, swatchSource, variantPriceRange };
+export { buildAvailabilityIndex, buildVariantState, findClosestVariant, isDefaultSingleVariant, isSwatchOption, isVariantSelectable, resolveSelectedVariant, selectionKey, staleVariantFlag, swatchSource, variantPriceRange };

package/dist/product-variants/stale-variant.d.ts

@@ -0,0 +1,9 @@
+import { TemplateJSON } from "../template-types.js";
+//#region src/product-variants/stale-variant.d.ts
+/** The product page's flag for a `?variant=` that named no variant: spread
+ * onto the template a theme returns, and the shared PDP route redirects to the
+ * URL without it. Nothing when the param was absent or matched. */
+export declare function staleVariantFlag(state: {
+  wasInvalidId: boolean;
+} | null | undefined): Pick<TemplateJSON, "staleVariant">;
+//#endregion

package/dist/product-variants/stale-variant.js

@@ -0,0 +1,9 @@
+//#region src/product-variants/stale-variant.ts
+/** The product page's flag for a `?variant=` that named no variant: spread
+* onto the template a theme returns, and the shared PDP route redirects to the
+* URL without it. Nothing when the param was absent or matched. */
+function staleVariantFlag(state) {
+	return state?.wasInvalidId ? { staleVariant: true } : {};
+}
+//#endregion
+export { staleVariantFlag };

package/dist/template-types.d.ts

@@ -119,6 +119,10 @@ export interface TemplateJSON {
   /** Set by `getProductTemplate` so the PDP route can render
    * `<ProductJsonLd>`. Only present on product templates. */
   productSchema?: ProductSchemaSource;
+  /** Set by `getProductTemplate` when the URL's `?variant=` names no variant
+   * of the product — a deleted one, an old share. The PDP route redirects to
+   * the same URL without it, so the page and its address agree. */
+  staleVariant?: true;
   /** Set by `getArticleTemplate` so the article route can render
    * `<ArticleJsonLd>`. Only present on article templates. */
   articleSchema?: ArticleSchemaSource;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shop-on/theme-runtime",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "SEE LICENSE IN dist/LICENSE.md",
   "files": [
     "dist"
@@ -35,15 +35,15 @@
   },
   "dependencies": {
     "thumbhash": "0.1.1",
-    "@shop-on/theme-contract": "0.1.0"
+    "@shop-on/theme-contract": "0.2.0"
   },
   "devDependencies": {
-    "@types/node": "26.6.3",
+    "@types/node": "26.6.5",
     "typescript": "7.0.2",
-    "vitest": "5.0.3"
+    "vitest": "5.0.5"
   },
   "scripts": {
     "check-types": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run --maxWorkers=2"
   }
 }