@wocart/theme 2.2.0 → 3.0.0

package/dist/image-service.d.ts

@@ -1,23 +1,20 @@
 /**
  * An Astro image service for Wocart storefronts: every `<Image>` and
- * `getImage()` of a media-domain image is resized by Cloudflare Image Resizing
- * on the media domain itself (`https://<media>/cdn-cgi/image/…/<path>`).
+ * `getImage()` of a store image is resized by the store's own media delivery
+ * — ImageKit or Cloudflare — so a storefront on any host gets the same URLs
+ * and no second image bill. Any other image (another host, a file imported
+ * into the theme) is served as it is, and so is every image of a `direct`
+ * delivery, which does not resize.
  *
- * The media domain is always a Cloudflare zone, wherever the storefront runs,
- * so a storefront on Cloudflare and one on Vercel get the same URLs, the same
- * edge cache and no second image bill. Any other image — another host, a file
- * imported into the theme — is served as it is. Without a media domain (local
- * development, a store without one) every image passes through unchanged.
- *
- * The domain is read per call, not at build: one theme build serves every
- * store. Bind it once, in the theme, to wherever the store's media domain
- * lives:
+ * The delivery is the store config's `media`, read per image, not at build:
+ * one theme build serves every store. Bind it once, in the theme, to where
+ * the theme keeps the store's config:
  *
  * ```ts
  * // src/image-service.ts
- * import { MEDIA_DOMAIN } from "astro:env/server";
  * import { mediaImageService } from "@wocart/theme/image-service";
- * export default mediaImageService(() => MEDIA_DOMAIN);
+ * import { storeMedia } from "./store-media";
+ * export default mediaImageService(storeMedia);
  * ```
  *
  * ```js
@@ -27,13 +24,13 @@
  * ```
  */
 import type { ExternalImageService, ImageTransform } from "astro";
-import { type MediaImageParams } from "@wocart/storefront";
-/** The Cloudflare resizing options an Astro image transform asks for. */
+import { type MediaDelivery, type MediaImageParams } from "@wocart/storefront";
+/** The resizing options an Astro image transform asks for. */
 export declare function mediaImageParams(options: ImageTransform): MediaImageParams;
 /**
- * The image service, bound to the store's media domain.
+ * The image service, bound to the store's media delivery.
  *
- * @param mediaDomain - Read on every image (e.g. `() => MEDIA_DOMAIN`): the
- *   store's media domain, or `undefined` to pass every image through.
+ * @param delivery - Read on every image (e.g. `() => config.media`): the
+ *   store's `MediaDelivery`, or `null` / `undefined` to pass every image through.
  */
-export declare function mediaImageService(mediaDomain: () => string | undefined): ExternalImageService;
+export declare function mediaImageService(delivery: () => MediaDelivery | null | undefined | Promise<MediaDelivery | null | undefined>): ExternalImageService;

package/dist/image-service.js

@@ -1,23 +1,20 @@
 /**
  * An Astro image service for Wocart storefronts: every `<Image>` and
- * `getImage()` of a media-domain image is resized by Cloudflare Image Resizing
- * on the media domain itself (`https://<media>/cdn-cgi/image/…/<path>`).
+ * `getImage()` of a store image is resized by the store's own media delivery
+ * — ImageKit or Cloudflare — so a storefront on any host gets the same URLs
+ * and no second image bill. Any other image (another host, a file imported
+ * into the theme) is served as it is, and so is every image of a `direct`
+ * delivery, which does not resize.
  *
- * The media domain is always a Cloudflare zone, wherever the storefront runs,
- * so a storefront on Cloudflare and one on Vercel get the same URLs, the same
- * edge cache and no second image bill. Any other image — another host, a file
- * imported into the theme — is served as it is. Without a media domain (local
- * development, a store without one) every image passes through unchanged.
- *
- * The domain is read per call, not at build: one theme build serves every
- * store. Bind it once, in the theme, to wherever the store's media domain
- * lives:
+ * The delivery is the store config's `media`, read per image, not at build:
+ * one theme build serves every store. Bind it once, in the theme, to where
+ * the theme keeps the store's config:
  *
  * ```ts
  * // src/image-service.ts
- * import { MEDIA_DOMAIN } from "astro:env/server";
  * import { mediaImageService } from "@wocart/theme/image-service";
- * export default mediaImageService(() => MEDIA_DOMAIN);
+ * import { storeMedia } from "./store-media";
+ * export default mediaImageService(storeMedia);
  * ```
  *
  * ```js
@@ -28,8 +25,8 @@
  */
 import { baseService } from "astro/assets";
 import { mediaImageUrl } from "@wocart/storefront";
-/** Astro's `fit` (CSS object-fit) in Cloudflare's words; a value Cloudflare also knows passes as it is. */
-const CLOUDFLARE_FIT = {
+/** Astro's `fit` (CSS object-fit) in the words `mediaImageUrl` takes; a value it also knows passes as it is. */
+const FIT = {
     cover: "cover",
     contain: "contain",
     fill: "squeeze",
@@ -38,7 +35,7 @@ const CLOUDFLARE_FIT = {
     pad: "pad",
     squeeze: "squeeze",
 };
-/** The Cloudflare resizing options an Astro image transform asks for. */
+/** The resizing options an Astro image transform asks for. */
 export function mediaImageParams(options) {
     const params = {};
     if (options.width)
@@ -49,25 +46,25 @@ export function mediaImageParams(options) {
         params.format = options.format;
     if (typeof options.quality === "number")
         params.quality = options.quality;
-    const fit = options.fit ? CLOUDFLARE_FIT[options.fit] : undefined;
+    const fit = options.fit ? FIT[options.fit] : undefined;
     if (fit)
         params.fit = fit;
     return params;
 }
 /**
- * The image service, bound to the store's media domain.
+ * The image service, bound to the store's media delivery.
  *
- * @param mediaDomain - Read on every image (e.g. `() => MEDIA_DOMAIN`): the
- *   store's media domain, or `undefined` to pass every image through.
+ * @param delivery - Read on every image (e.g. `() => config.media`): the
+ *   store's `MediaDelivery`, or `null` / `undefined` to pass every image through.
  */
-export function mediaImageService(mediaDomain) {
+export function mediaImageService(delivery) {
     return {
         ...baseService,
-        getURL(options) {
+        async getURL(options) {
             const src = options.src;
             if (typeof src !== "string")
                 return src.src;
-            return mediaImageUrl(src, mediaImageParams(options), mediaDomain()) ?? src;
+            return mediaImageUrl(src, mediaImageParams(options), await delivery()) ?? src;
         },
     };
 }

package/dist/manifest.d.ts

@@ -21,8 +21,8 @@ export declare const THEME_MANIFEST_PATH = "/wocart-theme.json";
 /** Derive the data-only manifest from a theme. `component` and `load` are dropped. */
 export declare function themeManifest(theme: ThemeDefinition): ThemeManifest;
 /**
- * The manifest's structural shape. Unknown keys are stripped (the forward-compat
- * tradeoff documented in the README); absent `fields`/`slots` normalize to `[]`.
+ * The manifest's structural shape. Unknown keys are stripped, so a manifest
+ * from a newer theme still reads; absent `fields`/`slots` normalize to `[]`.
  * Rules that span fields are not here — `validateThemeManifest` applies them.
  */
 export declare const ThemeManifestSchema: z.ZodObject<{

package/dist/manifest.js

@@ -214,8 +214,8 @@ const ComponentSpecSchema = z.object({
         .default([]),
 });
 /**
- * The manifest's structural shape. Unknown keys are stripped (the forward-compat
- * tradeoff documented in the README); absent `fields`/`slots` normalize to `[]`.
+ * The manifest's structural shape. Unknown keys are stripped, so a manifest
+ * from a newer theme still reads; absent `fields`/`slots` normalize to `[]`.
  * Rules that span fields are not here — `validateThemeManifest` applies them.
  */
 export const ThemeManifestSchema = z.object({

package/dist/patterns.d.ts

@@ -17,7 +17,7 @@ export declare const TYPE_KEY_PATTERN: RegExp;
  */
 export declare const SURFACE_KEY_PATTERN: RegExp;
 /** The platform page types a surface can render (`SurfacePageType`), mirrored from the storefront's page types. */
-export declare const PAGE_TYPES: readonly ["home", "catalog", "category", "collection", "product", "page", "landing", "checkout", "thankYou"];
+export declare const PAGE_TYPES: readonly ["home", "catalog", "category", "collection", "product", "page", "landing", "checkout", "thankYou", "trackOrder"];
 /** A `color` field's value: a hex color, `#rgb` or `#rrggbb`. */
 export declare const COLOR_PATTERN: RegExp;
 /**

package/dist/patterns.js

@@ -27,6 +27,7 @@ export const PAGE_TYPES = [
     "landing",
     "checkout",
     "thankYou",
+    "trackOrder",
 ];
 /** A `color` field's value: a hex color, `#rgb` or `#rrggbb`. */
 export const COLOR_PATTERN = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;

package/dist/types.d.ts

@@ -749,7 +749,7 @@ export interface AreaSpec {
  * The storefront's page types — what a URL means, with the paths the platform
  * owns. The same names as `StorefrontPageType` in `@wocart/storefront`.
  */
-export type SurfacePageType = "home" | "catalog" | "category" | "collection" | "product" | "page" | "landing" | "checkout" | "thankYou";
+export type SurfacePageType = "home" | "catalog" | "category" | "collection" | "product" | "page" | "landing" | "checkout" | "thankYou" | "trackOrder";
 /**
  * One component as data: a `ComponentDefinition` minus its runtime-only
  * implementation. `component` (the live component reference) and `load` (the

package/dist/version.d.ts

@@ -4,4 +4,4 @@
  * reads. Always equal to `package.json`'s version; the package check refuses
  * a release where they differ.
  */
-export declare const THEME_SDK_VERSION = "2.2.0";
+export declare const THEME_SDK_VERSION = "3.0.0";

package/dist/version.js

@@ -4,4 +4,4 @@
  * reads. Always equal to `package.json`'s version; the package check refuses
  * a release where they differ.
  */
-export const THEME_SDK_VERSION = "2.2.0";
+export const THEME_SDK_VERSION = "3.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wocart/theme",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "description": "The Wocart theme contract: code-owned component definitions, JSON page documents, validation and resolution, and a reference Astro renderer.",
   "keywords": [
     "wocart",
@@ -82,7 +82,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@wocart/storefront": "^1.20.0",
+    "@wocart/storefront": "^2.0.0",
     "astro": "^7.0.0"
   },
   "peerDependenciesMeta": {
@@ -92,7 +92,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
-    "@wocart/storefront": "^1.0.0",
+    "@wocart/storefront": "^2.0.0",
     "astro": "^7.3.2",
     "fast-check": "^4.6.0",
     "happy-dom": "^20.11.6",