@kotao/storefront

Das Theme-Runtime-SDK. Server-Helfer liegen auf dem Root-Entrypoint, UI-Bausteine unter /react, fokussierte Utilities unter eigenen Subpaths. Diese Seite ist eine Entrypoint-Landkarte — tiefere Dokumentation pro Symbol wird in einem späteren Release generiert.

@kotao/storefront (Root)

Serverseitiges Toolkit für Worker-Entry und Route-Loader:

• Kontext & Client — createKotaoContext, createStorefrontClient: der Request-Kontext, den deine Loader als context.storefront erreichen.
• Cart — createCartHandler, CartForm-Actions (CART_FORM_ACTIONS), applyOptimisticCartAction, Cart-Id-Cookie-Helfer.
• Caching — CacheShort, CacheLong, CacheNone, CacheCustom, createWithCache, generateCacheControlHeader.
• SEO & Routing — getSeoMeta, JSON-LD-Builder (productJsonLd, organizationJsonLd, …), storefrontRedirect, Sitemap-/Robots-Responses.
• Lokalisierung — Locale-Erkennung (localeFromRequest, localizePath, stripLocalePrefixFromRequest), der Lokalisierungs-Form-Handler.
• Consent & Analytics — Consent-Cookie encode/decode, createAnalyticsEmitter, getShopAnalytics.
• Checkout — resolveCheckoutUrl, Consent-Durchreichung, Design-Token-Extraktion.
• Pagination — getPaginationVariables, getPaginationInfo, flattenConnection.

@kotao/storefront/react

Client-Komponenten und Hooks: Image, Money / useMoney, Seo, Pagination, MediaFile, CartForm + OptimisticInput / useOptimisticData, Analytics*-Views + useAnalytics, ConsentBanner, ShopPayButton, Theme-Settings via ThemeSettingsProvider / useThemeSettings / useSectionSettings, und openSmartCart für den Plattform-Cart-Drawer.

@kotao/storefront/react-router

Das React-Router-7-Binding: getKotaoLoadContext (verdrahtet den Worker-Request mit deinen Routen) plus defer-/json-Compat-Re-Exports.

@kotao/storefront/product

Variantenauswahl-Logik: getProductOptions, getSelectedVariant, getSelectedProductOptions, getAdjacentAndFirstAvailableVariants, useOptimisticVariant, useSelectedOptionInUrlParam.

@kotao/storefront/image

imageUrl, imageSrcSet, buildImageAttrs — CDN-Bild-URLs mit Transforms und vollständige <img>-Attributsätze (inkl. Dimensionen, CLS-sicher).

@kotao/storefront/seo

Das SEO-Toolkit standalone: getSeoMeta, JSON-LD-Builder, robotsResponse, sitemapResponse / sitemapIndexResponse, storefrontRedirect.

@kotao/storefront/settings

Settings-as-data-Unterbau: fetchThemeSettings, resolveThemeSettings, mergeSettings / mergeSection, createThemeSettingsStore.

@kotao/storefront/editor

createStorefrontEditorBridge / createStorefrontEditorHostBridge — die Live-Preview-Brücke, über die der Workspace-Theme-Editor mit deinem Theme spricht.

Weitere Entrypoints

/cart-documents (die Cart-GraphQL-Dokumente), /storefront-api-types und /customer-account-api-types (generierte API-Typen).