@asteby/storefront-react 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -420,6 +420,97 @@ type JsonLdProps = {
 /** Renders `<script type="application/ld+json">` safely (works in SSR). */
 declare function JsonLd({ data, nonce }: JsonLdProps): react.JSX.Element | null;
 
+/** Types OPS ships built in; they cannot be redefined through the API. */
+declare const OPS_BUILTIN_SECTION_TYPES: readonly ["hero", "product_grid", "collection_list", "rich_text", "faq", "image_with_text"];
+declare const OPS_PROP_KINDS: readonly ["text", "textarea", "richtext", "image", "link", "number", "select", "boolean", "collection", "collection_list", "product", "product_list", "list"];
+type OpsPropKind = (typeof OPS_PROP_KINDS)[number];
+type OpsSectionProp = {
+    key: string;
+    kind: OpsPropKind;
+    label: string;
+    required?: boolean;
+    default?: unknown;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    min?: number;
+    max?: number;
+    fields?: OpsSectionProp[];
+};
+type OpsSectionType = {
+    type: string;
+    label: string;
+    description?: string;
+    category?: string;
+    schema: {
+        props: OpsSectionProp[];
+    };
+    max_per_page?: number;
+};
+type SectionTypeIssue = {
+    /** Dotted path, e.g. `promo.schema.props[1].fields[0].key`. */
+    path: string;
+    message: string;
+};
+type SectionTypeWarning = {
+    type: string;
+    /** Prop key when the warning is about a single prop. */
+    prop?: string;
+    message: string;
+};
+declare class SectionTypesValidationError extends Error {
+    readonly issues: SectionTypeIssue[];
+    constructor(issues: SectionTypeIssue[]);
+}
+type ToOpsOptions = {
+    /** Skip OPS built-in types (default true). */
+    excludeBuiltin?: boolean;
+    /**
+     * Prop keys OPS already knows for each built-in type (e.g. `{ hero: ['title','subtitle'] }`).
+     * With it, only the extra local props are warned about; without it, every
+     * locally-defined built-in type gets one generic warning.
+     */
+    builtinProps?: Record<string, readonly string[]>;
+};
+type ToOpsResult = {
+    types: OpsSectionType[];
+    warnings: SectionTypeWarning[];
+};
+/** Local mirror of the OPS validation, so mistakes surface before the request. */
+declare function validateOpsSectionTypes(types: readonly OpsSectionType[]): SectionTypeIssue[];
+type DefinitionsSource = {
+    definitions(): SectionDefinition<any, any>[];
+} | readonly SectionDefinition<any, any>[];
+/**
+ * Converts the registry (or a list of definitions) to OPS section types.
+ * Throws `SectionTypesValidationError` (with `issues`) when something would
+ * be rejected by OPS.
+ */
+declare function sectionTypesToOps(source: DefinitionsSource, options?: ToOpsOptions): ToOpsResult;
+type SectionTypesTarget = {
+    request<T>(spec: {
+        method: 'PUT';
+        path: string;
+        body?: unknown;
+    }): Promise<T>;
+} | {
+    baseUrl: string;
+    token: string;
+    fetch?: typeof fetch;
+};
+type SyncResult = {
+    created: number;
+    updated: number;
+    warnings: SectionTypeWarning[];
+};
+/**
+ * Validates locally and then `PUT`s the section types to OPS. Needs an `sk_`
+ * token with `content:write`. `target` is a `createStorefrontClient()` client or
+ * `{ baseUrl, token, fetch? }`. Returns `{ created, updated, warnings }`.
+ */
+declare function syncSectionTypes(target: SectionTypesTarget, source: DefinitionsSource, options?: ToOpsOptions): Promise<SyncResult>;
+
 type SectionPropKind = 'text' | 'textarea' | 'richtext' | 'number' | 'boolean' | 'url' | 'image' | 'color' | 'select' | 'collection' | 'product' | 'products' | 'list';
 type SectionPropSchema = {
     label: string;
@@ -465,6 +556,10 @@ type SectionDefinition<P = Record<string, unknown>, C = any> = {
     type: string;
     label?: string;
     description?: string;
+    /** OPS editor grouping (only used when exporting to OPS). */
+    category?: string;
+    /** Max instances per page (only used when exporting to OPS). */
+    maxPerPage?: number;
     schema: SectionSchema;
     component: ComponentType<SectionComponentProps<P, C>>;
 };
@@ -485,6 +580,8 @@ declare function defineSection<const S extends SectionSchema, C = any>(definitio
     type: string;
     label?: string;
     description?: string;
+    category?: string;
+    maxPerPage?: number;
     schema: S;
     component: ComponentType<SectionComponentProps<InferSectionProps<S>, C>>;
 }): SectionDefinition<InferSectionProps<S>, C>;
@@ -513,6 +610,12 @@ declare class SectionRegistry {
     definitions(): SectionDefinition<any, any>[];
     /** JSON Schemas of every registered section, keyed by type. */
     toJSONSchema(): Record<string, Record<string, unknown>>;
+    /**
+     * Section types in the OPS `storefront_content` format, ready for
+     * `PUT /storefront/content/section-types`. Throws `SectionTypesValidationError`
+     * on anything OPS would reject; `warnings` flags built-in types.
+     */
+    toOpsSectionTypes(options?: ToOpsOptions): ToOpsResult;
 }
 declare function createSectionRegistry(definitions?: readonly SectionDefinition<any, any>[]): SectionRegistry;
 type SectionsProps<C = unknown> = {
@@ -773,4 +876,4 @@ type NearestLocationFormProps<L extends ShopBranch = ShopBranch> = {
  */
 declare function NearestLocationForm<L extends ShopBranch = ShopBranch>({ locations, action, name, defaultValue, onSubmitPostalCode, onLocate, labels, children, ...rest }: NearestLocationFormProps<L>): react.JSX.Element | null;
 
-export { AddToCartButton, type AddToCartButtonProps, AvailabilityBadge, type AvailabilityBadgeProps, type AvailabilityInput, type BreadcrumbItem, CART_COOKIE_NAME, type CartContextValue, type CartCookieOptions, type CartLineAddInput, CartLineProblem, type CartLineProblemProps, CartProvider, type CartProviderProps, type CartStatus, DirectionsLink, type DirectionsLinkProps, type FaqItem, type GeolocationErrorCode, type GeolocationFailure, type GeolocationPermission, type InferSectionProps, JsonLd, type JsonLdObject, type JsonLdProps, type LocalBusinessOptions, type LocationItemState, LocationList, type LocationListProps, LocationPicker, type LocationPickerProps, type MetaDescriptor, type NearbyLocation, NearestLocationForm, type NearestLocationFormLabels, type NearestLocationFormProps, OpenStatus, type OpenStatusLabels, type OpenStatusProps, type PickupInfo, PickupOption, type PickupOptionProps, type ProductOptionState, type ProductOptionValueState, type ProductOptionsState, RestockNotifyForm, type RestockNotifyFormProps, SELECTED_LOCATION_PARAM, SELECTED_LOCATION_STORAGE_KEY, type SectionComponentProps, type SectionDefinition, type SectionPropError, type SectionPropKind, type SectionPropSchema, SectionRegistry, type SectionSchema, Sections, type SectionsProps, type SeoMetaInput, SrOnly, StockConflictAlert, type StockConflictAlertProps, type StorefrontContextValue, StorefrontProvider, type StorefrontProviderProps, type ThemeCssOptions, ThemeStyle, type ThemeStyleProps, type UseGeolocationOptions, type UseGeolocationResult, type UseNearestLocationsOptions, type UseNearestLocationsResult, type UseProductOptionsConfig, type UseSelectedLocationOptions, type UseSelectedLocationResult, VariantOptionState, type VariantOptionStateProps, VariantSelector, type VariantSelectorProps, type VariantSelectorRenderProps, breadcrumbJsonLd, collectionJsonLd, collectionMeta, createSectionRegistry, defineSection, faqJsonLd, getCartIdFromCookie, isSafeCssValue, localBusinessJsonLd, openingHoursJsonLd, optimisticCart, organizationJsonLd, productJsonLd, productMeta, readCartCookie, readSelectedLocationId, resolveSectionProps, sectionJsonSchema, seoMeta, serializeCartCookie, serializeJsonLd, themeFontsHref, themeToCss, themeToCssVariables, toMerchandise, tokenName, useAvailability, useCart, useGeolocation, useNearestLocations, useOptionalCart, useOptionalStorefront, useProductOptions, useSelectedLocation, useStorefront, useStorefrontClient, writeCartCookie };
+export { AddToCartButton, type AddToCartButtonProps, AvailabilityBadge, type AvailabilityBadgeProps, type AvailabilityInput, type BreadcrumbItem, CART_COOKIE_NAME, type CartContextValue, type CartCookieOptions, type CartLineAddInput, CartLineProblem, type CartLineProblemProps, CartProvider, type CartProviderProps, type CartStatus, DirectionsLink, type DirectionsLinkProps, type FaqItem, type GeolocationErrorCode, type GeolocationFailure, type GeolocationPermission, type InferSectionProps, JsonLd, type JsonLdObject, type JsonLdProps, type LocalBusinessOptions, type LocationItemState, LocationList, type LocationListProps, LocationPicker, type LocationPickerProps, type MetaDescriptor, type NearbyLocation, NearestLocationForm, type NearestLocationFormLabels, type NearestLocationFormProps, OPS_BUILTIN_SECTION_TYPES, OPS_PROP_KINDS, OpenStatus, type OpenStatusLabels, type OpenStatusProps, type OpsPropKind, type OpsSectionProp, type OpsSectionType, type PickupInfo, PickupOption, type PickupOptionProps, type ProductOptionState, type ProductOptionValueState, type ProductOptionsState, RestockNotifyForm, type RestockNotifyFormProps, SELECTED_LOCATION_PARAM, SELECTED_LOCATION_STORAGE_KEY, type SectionComponentProps, type SectionDefinition, type SectionPropError, type SectionPropKind, type SectionPropSchema, SectionRegistry, type SectionSchema, type SectionTypeIssue, type SectionTypeWarning, type SectionTypesTarget, SectionTypesValidationError, Sections, type SectionsProps, type SeoMetaInput, SrOnly, StockConflictAlert, type StockConflictAlertProps, type StorefrontContextValue, StorefrontProvider, type StorefrontProviderProps, type SyncResult, type ThemeCssOptions, ThemeStyle, type ThemeStyleProps, type ToOpsOptions, type ToOpsResult, type UseGeolocationOptions, type UseGeolocationResult, type UseNearestLocationsOptions, type UseNearestLocationsResult, type UseProductOptionsConfig, type UseSelectedLocationOptions, type UseSelectedLocationResult, VariantOptionState, type VariantOptionStateProps, VariantSelector, type VariantSelectorProps, type VariantSelectorRenderProps, breadcrumbJsonLd, collectionJsonLd, collectionMeta, createSectionRegistry, defineSection, faqJsonLd, getCartIdFromCookie, isSafeCssValue, localBusinessJsonLd, openingHoursJsonLd, optimisticCart, organizationJsonLd, productJsonLd, productMeta, readCartCookie, readSelectedLocationId, resolveSectionProps, sectionJsonSchema, sectionTypesToOps, seoMeta, serializeCartCookie, serializeJsonLd, syncSectionTypes, themeFontsHref, themeToCss, themeToCssVariables, toMerchandise, tokenName, useAvailability, useCart, useGeolocation, useNearestLocations, useOptionalCart, useOptionalStorefront, useProductOptions, useSelectedLocation, useStorefront, useStorefrontClient, validateOpsSectionTypes, writeCartCookie };

package/dist/index.d.ts

@@ -420,6 +420,97 @@ type JsonLdProps = {
 /** Renders `<script type="application/ld+json">` safely (works in SSR). */
 declare function JsonLd({ data, nonce }: JsonLdProps): react.JSX.Element | null;
 
+/** Types OPS ships built in; they cannot be redefined through the API. */
+declare const OPS_BUILTIN_SECTION_TYPES: readonly ["hero", "product_grid", "collection_list", "rich_text", "faq", "image_with_text"];
+declare const OPS_PROP_KINDS: readonly ["text", "textarea", "richtext", "image", "link", "number", "select", "boolean", "collection", "collection_list", "product", "product_list", "list"];
+type OpsPropKind = (typeof OPS_PROP_KINDS)[number];
+type OpsSectionProp = {
+    key: string;
+    kind: OpsPropKind;
+    label: string;
+    required?: boolean;
+    default?: unknown;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    min?: number;
+    max?: number;
+    fields?: OpsSectionProp[];
+};
+type OpsSectionType = {
+    type: string;
+    label: string;
+    description?: string;
+    category?: string;
+    schema: {
+        props: OpsSectionProp[];
+    };
+    max_per_page?: number;
+};
+type SectionTypeIssue = {
+    /** Dotted path, e.g. `promo.schema.props[1].fields[0].key`. */
+    path: string;
+    message: string;
+};
+type SectionTypeWarning = {
+    type: string;
+    /** Prop key when the warning is about a single prop. */
+    prop?: string;
+    message: string;
+};
+declare class SectionTypesValidationError extends Error {
+    readonly issues: SectionTypeIssue[];
+    constructor(issues: SectionTypeIssue[]);
+}
+type ToOpsOptions = {
+    /** Skip OPS built-in types (default true). */
+    excludeBuiltin?: boolean;
+    /**
+     * Prop keys OPS already knows for each built-in type (e.g. `{ hero: ['title','subtitle'] }`).
+     * With it, only the extra local props are warned about; without it, every
+     * locally-defined built-in type gets one generic warning.
+     */
+    builtinProps?: Record<string, readonly string[]>;
+};
+type ToOpsResult = {
+    types: OpsSectionType[];
+    warnings: SectionTypeWarning[];
+};
+/** Local mirror of the OPS validation, so mistakes surface before the request. */
+declare function validateOpsSectionTypes(types: readonly OpsSectionType[]): SectionTypeIssue[];
+type DefinitionsSource = {
+    definitions(): SectionDefinition<any, any>[];
+} | readonly SectionDefinition<any, any>[];
+/**
+ * Converts the registry (or a list of definitions) to OPS section types.
+ * Throws `SectionTypesValidationError` (with `issues`) when something would
+ * be rejected by OPS.
+ */
+declare function sectionTypesToOps(source: DefinitionsSource, options?: ToOpsOptions): ToOpsResult;
+type SectionTypesTarget = {
+    request<T>(spec: {
+        method: 'PUT';
+        path: string;
+        body?: unknown;
+    }): Promise<T>;
+} | {
+    baseUrl: string;
+    token: string;
+    fetch?: typeof fetch;
+};
+type SyncResult = {
+    created: number;
+    updated: number;
+    warnings: SectionTypeWarning[];
+};
+/**
+ * Validates locally and then `PUT`s the section types to OPS. Needs an `sk_`
+ * token with `content:write`. `target` is a `createStorefrontClient()` client or
+ * `{ baseUrl, token, fetch? }`. Returns `{ created, updated, warnings }`.
+ */
+declare function syncSectionTypes(target: SectionTypesTarget, source: DefinitionsSource, options?: ToOpsOptions): Promise<SyncResult>;
+
 type SectionPropKind = 'text' | 'textarea' | 'richtext' | 'number' | 'boolean' | 'url' | 'image' | 'color' | 'select' | 'collection' | 'product' | 'products' | 'list';
 type SectionPropSchema = {
     label: string;
@@ -465,6 +556,10 @@ type SectionDefinition<P = Record<string, unknown>, C = any> = {
     type: string;
     label?: string;
     description?: string;
+    /** OPS editor grouping (only used when exporting to OPS). */
+    category?: string;
+    /** Max instances per page (only used when exporting to OPS). */
+    maxPerPage?: number;
     schema: SectionSchema;
     component: ComponentType<SectionComponentProps<P, C>>;
 };
@@ -485,6 +580,8 @@ declare function defineSection<const S extends SectionSchema, C = any>(definitio
     type: string;
     label?: string;
     description?: string;
+    category?: string;
+    maxPerPage?: number;
     schema: S;
     component: ComponentType<SectionComponentProps<InferSectionProps<S>, C>>;
 }): SectionDefinition<InferSectionProps<S>, C>;
@@ -513,6 +610,12 @@ declare class SectionRegistry {
     definitions(): SectionDefinition<any, any>[];
     /** JSON Schemas of every registered section, keyed by type. */
     toJSONSchema(): Record<string, Record<string, unknown>>;
+    /**
+     * Section types in the OPS `storefront_content` format, ready for
+     * `PUT /storefront/content/section-types`. Throws `SectionTypesValidationError`
+     * on anything OPS would reject; `warnings` flags built-in types.
+     */
+    toOpsSectionTypes(options?: ToOpsOptions): ToOpsResult;
 }
 declare function createSectionRegistry(definitions?: readonly SectionDefinition<any, any>[]): SectionRegistry;
 type SectionsProps<C = unknown> = {
@@ -773,4 +876,4 @@ type NearestLocationFormProps<L extends ShopBranch = ShopBranch> = {
  */
 declare function NearestLocationForm<L extends ShopBranch = ShopBranch>({ locations, action, name, defaultValue, onSubmitPostalCode, onLocate, labels, children, ...rest }: NearestLocationFormProps<L>): react.JSX.Element | null;
 
-export { AddToCartButton, type AddToCartButtonProps, AvailabilityBadge, type AvailabilityBadgeProps, type AvailabilityInput, type BreadcrumbItem, CART_COOKIE_NAME, type CartContextValue, type CartCookieOptions, type CartLineAddInput, CartLineProblem, type CartLineProblemProps, CartProvider, type CartProviderProps, type CartStatus, DirectionsLink, type DirectionsLinkProps, type FaqItem, type GeolocationErrorCode, type GeolocationFailure, type GeolocationPermission, type InferSectionProps, JsonLd, type JsonLdObject, type JsonLdProps, type LocalBusinessOptions, type LocationItemState, LocationList, type LocationListProps, LocationPicker, type LocationPickerProps, type MetaDescriptor, type NearbyLocation, NearestLocationForm, type NearestLocationFormLabels, type NearestLocationFormProps, OpenStatus, type OpenStatusLabels, type OpenStatusProps, type PickupInfo, PickupOption, type PickupOptionProps, type ProductOptionState, type ProductOptionValueState, type ProductOptionsState, RestockNotifyForm, type RestockNotifyFormProps, SELECTED_LOCATION_PARAM, SELECTED_LOCATION_STORAGE_KEY, type SectionComponentProps, type SectionDefinition, type SectionPropError, type SectionPropKind, type SectionPropSchema, SectionRegistry, type SectionSchema, Sections, type SectionsProps, type SeoMetaInput, SrOnly, StockConflictAlert, type StockConflictAlertProps, type StorefrontContextValue, StorefrontProvider, type StorefrontProviderProps, type ThemeCssOptions, ThemeStyle, type ThemeStyleProps, type UseGeolocationOptions, type UseGeolocationResult, type UseNearestLocationsOptions, type UseNearestLocationsResult, type UseProductOptionsConfig, type UseSelectedLocationOptions, type UseSelectedLocationResult, VariantOptionState, type VariantOptionStateProps, VariantSelector, type VariantSelectorProps, type VariantSelectorRenderProps, breadcrumbJsonLd, collectionJsonLd, collectionMeta, createSectionRegistry, defineSection, faqJsonLd, getCartIdFromCookie, isSafeCssValue, localBusinessJsonLd, openingHoursJsonLd, optimisticCart, organizationJsonLd, productJsonLd, productMeta, readCartCookie, readSelectedLocationId, resolveSectionProps, sectionJsonSchema, seoMeta, serializeCartCookie, serializeJsonLd, themeFontsHref, themeToCss, themeToCssVariables, toMerchandise, tokenName, useAvailability, useCart, useGeolocation, useNearestLocations, useOptionalCart, useOptionalStorefront, useProductOptions, useSelectedLocation, useStorefront, useStorefrontClient, writeCartCookie };
+export { AddToCartButton, type AddToCartButtonProps, AvailabilityBadge, type AvailabilityBadgeProps, type AvailabilityInput, type BreadcrumbItem, CART_COOKIE_NAME, type CartContextValue, type CartCookieOptions, type CartLineAddInput, CartLineProblem, type CartLineProblemProps, CartProvider, type CartProviderProps, type CartStatus, DirectionsLink, type DirectionsLinkProps, type FaqItem, type GeolocationErrorCode, type GeolocationFailure, type GeolocationPermission, type InferSectionProps, JsonLd, type JsonLdObject, type JsonLdProps, type LocalBusinessOptions, type LocationItemState, LocationList, type LocationListProps, LocationPicker, type LocationPickerProps, type MetaDescriptor, type NearbyLocation, NearestLocationForm, type NearestLocationFormLabels, type NearestLocationFormProps, OPS_BUILTIN_SECTION_TYPES, OPS_PROP_KINDS, OpenStatus, type OpenStatusLabels, type OpenStatusProps, type OpsPropKind, type OpsSectionProp, type OpsSectionType, type PickupInfo, PickupOption, type PickupOptionProps, type ProductOptionState, type ProductOptionValueState, type ProductOptionsState, RestockNotifyForm, type RestockNotifyFormProps, SELECTED_LOCATION_PARAM, SELECTED_LOCATION_STORAGE_KEY, type SectionComponentProps, type SectionDefinition, type SectionPropError, type SectionPropKind, type SectionPropSchema, SectionRegistry, type SectionSchema, type SectionTypeIssue, type SectionTypeWarning, type SectionTypesTarget, SectionTypesValidationError, Sections, type SectionsProps, type SeoMetaInput, SrOnly, StockConflictAlert, type StockConflictAlertProps, type StorefrontContextValue, StorefrontProvider, type StorefrontProviderProps, type SyncResult, type ThemeCssOptions, ThemeStyle, type ThemeStyleProps, type ToOpsOptions, type ToOpsResult, type UseGeolocationOptions, type UseGeolocationResult, type UseNearestLocationsOptions, type UseNearestLocationsResult, type UseProductOptionsConfig, type UseSelectedLocationOptions, type UseSelectedLocationResult, VariantOptionState, type VariantOptionStateProps, VariantSelector, type VariantSelectorProps, type VariantSelectorRenderProps, breadcrumbJsonLd, collectionJsonLd, collectionMeta, createSectionRegistry, defineSection, faqJsonLd, getCartIdFromCookie, isSafeCssValue, localBusinessJsonLd, openingHoursJsonLd, optimisticCart, organizationJsonLd, productJsonLd, productMeta, readCartCookie, readSelectedLocationId, resolveSectionProps, sectionJsonSchema, sectionTypesToOps, seoMeta, serializeCartCookie, serializeJsonLd, syncSectionTypes, themeFontsHref, themeToCss, themeToCssVariables, toMerchandise, tokenName, useAvailability, useCart, useGeolocation, useNearestLocations, useOptionalCart, useOptionalStorefront, useProductOptions, useSelectedLocation, useStorefront, useStorefrontClient, validateOpsSectionTypes, writeCartCookie };

package/dist/index.js

@@ -3,7 +3,7 @@ export { ThemeStyle, isSafeCssValue, themeFontsHref, themeToCss, themeToCssVaria
 import { useOptionalStorefront } from './chunk-DQBL2DFJ.js';
 export { StorefrontProvider, useOptionalStorefront, useStorefront, useStorefrontClient } from './chunk-DQBL2DFJ.js';
 import { createContext, useRef, useState, useCallback, useEffect, useMemo, useContext, Fragment as Fragment$1, useId } from 'react';
-import { resolveAvailability, productAvailability, availabilityView, availabilityMessages, formatAvailabilityMessage, cartLineProblemView, isStorefrontError, schemaAvailability, formatMoney } from '@asteby/storefront';
+import { resolveAvailability, productAvailability, availabilityView, availabilityMessages, formatAvailabilityMessage, cartLineProblemView, isStorefrontError, schemaAvailability, StorefrontError, formatMoney } from '@asteby/storefront';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { toSchemaOpeningHours, isValidPoint, rankByDistance, openStatus, directionsUrl } from '@asteby/storefront/geo';
 
@@ -857,6 +857,156 @@ function JsonLd({ data, nonce }) {
   if (!data || Array.isArray(data) && data.length === 0) return null;
   return /* @__PURE__ */ jsx("script", { type: "application/ld+json", nonce, dangerouslySetInnerHTML: { __html: serializeJsonLd(data) } });
 }
+var OPS_BUILTIN_SECTION_TYPES = ["hero", "product_grid", "collection_list", "rich_text", "faq", "image_with_text"];
+var OPS_PROP_KINDS = ["text", "textarea", "richtext", "image", "link", "number", "select", "boolean", "collection", "collection_list", "product", "product_list", "list"];
+var SectionTypesValidationError = class extends Error {
+  issues;
+  constructor(issues) {
+    super(`Invalid section types for OPS:
+${issues.map((i) => `  - ${i.path}: ${i.message}`).join("\n")}`);
+    this.name = "SectionTypesValidationError";
+    this.issues = issues;
+  }
+};
+var SNAKE = /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/;
+var KIND_MAP = {
+  text: "text",
+  textarea: "textarea",
+  richtext: "richtext",
+  url: "text",
+  color: "text",
+  image: "image",
+  number: "number",
+  boolean: "boolean",
+  select: "select",
+  collection: "collection",
+  product: "product",
+  products: "product_list",
+  list: "list"
+};
+var LIST_KINDS = /* @__PURE__ */ new Set(["list"]);
+function convertProps(schema, path, issues) {
+  const out = [];
+  for (const [key, spec] of Object.entries(schema ?? {})) {
+    const p = `${path}.${key}`;
+    const kind = KIND_MAP[spec.kind];
+    if (!kind) {
+      issues.push({ path: `${p}.kind`, message: `unknown kind "${String(spec.kind)}"` });
+      continue;
+    }
+    const prop = { key, kind, label: spec.label };
+    if (spec.required) prop.required = true;
+    if ("default" in spec && spec.default !== void 0) prop.default = spec.default;
+    if (spec.options) prop.options = spec.options.map((o) => ({ value: o.value, label: o.label }));
+    if (spec.min !== void 0) prop.min = spec.min;
+    if (spec.max !== void 0) prop.max = spec.max;
+    if (LIST_KINDS.has(kind)) prop.fields = convertProps(spec.items, `${p}.fields`, issues);
+    out.push(prop);
+  }
+  return out;
+}
+function validateOpsSectionTypes(types) {
+  const issues = [];
+  const seen = /* @__PURE__ */ new Set();
+  const walk = (props, path) => {
+    if (!Array.isArray(props)) {
+      issues.push({ path, message: "must be a list" });
+      return;
+    }
+    const keys = /* @__PURE__ */ new Set();
+    props.forEach((prop, i) => {
+      const p = `${path}[${i}]`;
+      if (typeof prop.key !== "string" || !SNAKE.test(prop.key)) issues.push({ path: `${p}.key`, message: `"${String(prop.key)}" must be snake_case (a-z, 0-9, _)` });
+      else if (keys.has(prop.key)) issues.push({ path: `${p}.key`, message: `duplicate key "${prop.key}"` });
+      else keys.add(prop.key);
+      if (typeof prop.label !== "string" || !prop.label.trim()) issues.push({ path: `${p}.label`, message: "label is required" });
+      if (!OPS_PROP_KINDS.includes(prop.kind)) {
+        issues.push({ path: `${p}.kind`, message: `unknown kind "${String(prop.kind)}"` });
+        return;
+      }
+      if (prop.kind === "list") {
+        if (!prop.fields || prop.fields.length === 0) issues.push({ path: `${p}.fields`, message: 'list requires a non-empty "fields"' });
+        else walk(prop.fields, `${p}.fields`);
+      }
+      if (prop.kind === "select" && (!prop.options || prop.options.length === 0)) issues.push({ path: `${p}.options`, message: 'select requires non-empty "options"' });
+      if (prop.min !== void 0 && prop.max !== void 0 && prop.min > prop.max) issues.push({ path: `${p}.max`, message: "max must be >= min" });
+    });
+  };
+  types.forEach((t, i) => {
+    const p = t.type ? t.type : `[${i}]`;
+    if (!t.type || !t.type.trim()) issues.push({ path: `${p}.type`, message: "type is required" });
+    else if (seen.has(t.type)) issues.push({ path: `${p}.type`, message: `duplicate type "${t.type}"` });
+    else seen.add(t.type);
+    if (!t.label || !t.label.trim()) issues.push({ path: `${p}.label`, message: "label is required" });
+    if (t.max_per_page !== void 0 && (!Number.isInteger(t.max_per_page) || t.max_per_page < 1)) issues.push({ path: `${p}.max_per_page`, message: "must be a positive integer" });
+    walk(t.schema?.props, `${p}.schema.props`);
+  });
+  return issues;
+}
+function sectionTypesToOps(source, options = {}) {
+  const excludeBuiltin = options.excludeBuiltin ?? true;
+  const defs = Array.isArray(source) ? source : source.definitions();
+  const builtin = new Set(OPS_BUILTIN_SECTION_TYPES);
+  const issues = [];
+  const warnings = [];
+  const types = [];
+  for (const def of defs) {
+    if (excludeBuiltin && builtin.has(def.type)) {
+      const known = options.builtinProps?.[def.type];
+      if (known) {
+        for (const name of Object.keys(def.schema ?? {})) {
+          if (!known.includes(name)) warnings.push({ type: def.type, prop: name, message: `prop "${name}" of built-in type "${def.type}" does not exist in the OPS schema; built-in types cannot be redefined, so it will not be editable in OPS` });
+        }
+      } else {
+        warnings.push({ type: def.type, message: `"${def.type}" is a built-in OPS type: not synced, and its local props cannot be verified against the OPS schema` });
+      }
+      continue;
+    }
+    const entryIssues = [];
+    const props = convertProps(def.schema, `${def.type}.schema.props`, entryIssues);
+    issues.push(...entryIssues);
+    const out = { type: def.type, label: def.label ?? def.type, schema: { props } };
+    if (def.description) out.description = def.description;
+    if (def.category) out.category = def.category;
+    if (def.maxPerPage !== void 0) out.max_per_page = def.maxPerPage;
+    types.push(out);
+  }
+  issues.push(...validateOpsSectionTypes(types));
+  if (issues.length) throw new SectionTypesValidationError(issues);
+  return { types, warnings };
+}
+var SYNC_PATH = "/storefront/content/section-types";
+var count = (v) => Array.isArray(v) ? v.length : typeof v === "number" ? v : 0;
+async function syncSectionTypes(target, source, options = {}) {
+  const { types, warnings } = sectionTypesToOps(source, options);
+  let raw;
+  if ("request" in target && typeof target.request === "function") {
+    raw = await target.request({ method: "PUT", path: SYNC_PATH, body: { section_types: types } });
+  } else {
+    const t = target;
+    if (!t.token.startsWith("sk_")) throw new TypeError("syncSectionTypes: an sk_ token with content:write is required");
+    const f = t.fetch ?? globalThis.fetch.bind(globalThis);
+    const url = t.baseUrl.replace(/\/+$/, "") + SYNC_PATH;
+    const res = await f(url, {
+      method: "PUT",
+      headers: { Authorization: `Bearer ${t.token}`, "Content-Type": "application/json", Accept: "application/json" },
+      body: JSON.stringify({ section_types: types })
+    });
+    const text = await res.text();
+    let body;
+    try {
+      body = text ? JSON.parse(text) : void 0;
+    } catch {
+      body = void 0;
+    }
+    if (!res.ok) {
+      throw new StorefrontError({ status: res.status, code: body?.code ?? body?.error?.code ?? "unknown", message: body?.message ?? body?.error?.message ?? `Section types sync failed (${res.status})`, url });
+    }
+    raw = body;
+  }
+  const data = raw && typeof raw === "object" && "data" in raw ? raw.data : raw;
+  return { created: count(data?.created), updated: count(data?.updated), warnings };
+}
 function defineSection(definition) {
   return definition;
 }
@@ -880,6 +1030,9 @@ function resolveSectionProps(schema, raw, path = "") {
       else if (spec.required) errors.push({ prop: key, message: "is required" });
       continue;
     }
+    if (spec.kind === "image" && typeof value === "object" && value !== null && typeof value.url === "string") {
+      value = value.url;
+    }
     if (STRING_KINDS.has(spec.kind)) {
       if (typeof value !== "string") {
         fail2("must be a string");
@@ -1003,6 +1156,14 @@ var SectionRegistry = class {
   toJSONSchema() {
     return Object.fromEntries(this.definitions().map((d) => [d.type, sectionJsonSchema(d)]));
   }
+  /**
+   * Section types in the OPS `storefront_content` format, ready for
+   * `PUT /storefront/content/section-types`. Throws `SectionTypesValidationError`
+   * on anything OPS would reject; `warnings` flags built-in types.
+   */
+  toOpsSectionTypes(options) {
+    return sectionTypesToOps(this, options);
+  }
 };
 function createSectionRegistry(definitions = []) {
   return new SectionRegistry(definitions);
@@ -1377,6 +1538,6 @@ function NearestLocationForm({
   );
 }
 
-export { AddToCartButton, AvailabilityBadge, CART_COOKIE_NAME, CartLineProblem, CartProvider, DirectionsLink, JsonLd, LocationList, LocationPicker, NearestLocationForm, OpenStatus, PickupOption, RestockNotifyForm, SELECTED_LOCATION_PARAM, SELECTED_LOCATION_STORAGE_KEY, SectionRegistry, Sections, SrOnly, StockConflictAlert, VariantOptionState, VariantSelector, breadcrumbJsonLd, collectionJsonLd, collectionMeta, createSectionRegistry, defineSection, faqJsonLd, getCartIdFromCookie, localBusinessJsonLd, openingHoursJsonLd, optimisticCart, organizationJsonLd, productJsonLd, productMeta, readCartCookie, readSelectedLocationId, resolveSectionProps, sectionJsonSchema, seoMeta, serializeCartCookie, serializeJsonLd, toMerchandise, useAvailability, useCart, useGeolocation, useNearestLocations, useOptionalCart, useProductOptions, useSelectedLocation, writeCartCookie };
+export { AddToCartButton, AvailabilityBadge, CART_COOKIE_NAME, CartLineProblem, CartProvider, DirectionsLink, JsonLd, LocationList, LocationPicker, NearestLocationForm, OPS_BUILTIN_SECTION_TYPES, OPS_PROP_KINDS, OpenStatus, PickupOption, RestockNotifyForm, SELECTED_LOCATION_PARAM, SELECTED_LOCATION_STORAGE_KEY, SectionRegistry, SectionTypesValidationError, Sections, SrOnly, StockConflictAlert, VariantOptionState, VariantSelector, breadcrumbJsonLd, collectionJsonLd, collectionMeta, createSectionRegistry, defineSection, faqJsonLd, getCartIdFromCookie, localBusinessJsonLd, openingHoursJsonLd, optimisticCart, organizationJsonLd, productJsonLd, productMeta, readCartCookie, readSelectedLocationId, resolveSectionProps, sectionJsonSchema, sectionTypesToOps, seoMeta, serializeCartCookie, serializeJsonLd, syncSectionTypes, toMerchandise, useAvailability, useCart, useGeolocation, useNearestLocations, useOptionalCart, useProductOptions, useSelectedLocation, validateOpsSectionTypes, writeCartCookie };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map