@zenky/storefront-vue 0.9.47 → 0.10.0

package/dist/pagination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pagination/usePaginatedList.ts"],"names":[],"mappings":";;;AAwFA,IAAM,gBAAA,GAAmB,EAAA;AAElB,SAAS,iBAAoB,OAAA,EAA0D;AAC1F,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,gBAAA;AACnC,EAAA,MAAM,UAAU,OAAA,CAAQ,OAAA;AAExB,EAAA,MAAM,UAAA,GAAa,GAAA,CAAoB,EAAE,CAAA;AACzC,EAAA,MAAM,WAAA,GAAc,GAAA,CAAY,OAAA,CAAQ,WAAA,IAAe,CAAC,CAAA;AACxD,EAAA,MAAM,aAAa,GAAA,CAAkC;AAAA,IACjD,IAAA,EAAM,QAAQ,WAAA,IAAe,CAAA;AAAA,IAC7B,EAAA,EAAI,QAAQ,WAAA,IAAe;AAAA,GAC9B,CAAA;AACD,EAAA,MAAM,UAAA,GAAa,IAAY,CAAC,CAAA;AAChC,EAAA,MAAM,UAAA,GAAa,IAAY,CAAC,CAAA;AAChC,EAAA,MAAM,OAAA,GAAU,IAAa,KAAK,CAAA;AAClC,EAAA,MAAM,OAAA,GAAU,IAAa,KAAK,CAAA;AAClC,EAAA,MAAM,KAAA,GAAQ,IAAoB,IAAI,CAAA;AAGtC,EAAA,MAAM,KAAA,GAAQ,SAAc,MAAM,UAAA,CAAW,MAAM,OAAA,CAAQ,CAAA,KAAA,KAAS,KAAA,CAAM,KAAK,CAAC,CAAA;AAKhF,EAAA,SAAS,oBAAA,CAAqB,UAAgC,IAAA,EAAoB;AAC9E,IAAA,UAAA,CAAW,QAAQ,CAAC,EAAE,MAAM,KAAA,EAAO,QAAA,CAAS,OAAO,CAAA;AACnD,IAAA,WAAA,CAAY,KAAA,GAAQ,IAAA;AACpB,IAAA,UAAA,CAAW,KAAA,GAAQ,EAAE,IAAA,EAAM,IAAA,EAAM,IAAI,IAAA,EAAK;AAC1C,IAAA,UAAA,CAAW,KAAA,GAAQ,SAAS,UAAA,CAAW,WAAA;AACvC,IAAA,UAAA,CAAW,KAAA,GAAQ,SAAS,UAAA,CAAW,KAAA;AACvC,IAAA,OAAA,CAAQ,KAAA,GAAQ,SAAS,UAAA,CAAW,aAAA;AAAA,EACxC;AAGA,EAAA,IAAI,QAAQ,WAAA,EAAa;AACrB,IAAA,oBAAA,CAAqB,OAAA,CAAQ,WAAA,EAAa,OAAA,CAAQ,WAAA,IAAe,CAAC,CAAA;AAAA,EACtE;AAEA,EAAA,eAAe,SAAS,IAAA,EAA6B;AACjD,IAAA,IAAI,QAAQ,KAAA,EAAO;AAEnB,IAAA,OAAA,CAAQ,KAAA,GAAQ,IAAA;AAChB,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AAEd,IAAA,UAAA,CAAW,QAAQ,EAAC;AAEpB,IAAA,IAAI;AACA,MAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAC5C,MAAA,oBAAA,CAAqB,UAAU,IAAI,CAAA;AAAA,IACvC,SAAS,CAAA,EAAG;AACR,MAAA,KAAA,CAAM,KAAA,GAAQ,CAAA;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,oCAAoC,CAAC,CAAA;AAAA,IACvD,CAAA,SAAE;AACE,MAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAAA,IACpB;AAAA,EACJ;AAEA,EAAA,eAAe,QAAA,GAA0B;AACrC,IAAA,IAAI,OAAA,CAAQ,KAAA,IAAS,CAAC,OAAA,CAAQ,KAAA,EAAO;AAErC,IAAA,MAAM,QAAA,GAAW,YAAY,KAAA,GAAQ,CAAA;AACrC,IAAA,OAAA,CAAQ,KAAA,GAAQ,IAAA;AAChB,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AAEd,IAAA,IAAI;AACA,MAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,QAAA,EAAU,OAAO,CAAA;AAGhD,MAAA,UAAA,CAAW,KAAA,GAAQ,CAAC,GAAG,UAAA,CAAW,KAAA,EAAO,EAAE,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,QAAA,CAAS,KAAA,EAAO,CAAA;AAClF,MAAA,WAAA,CAAY,KAAA,GAAQ,QAAA;AACpB,MAAA,UAAA,CAAW,QAAQ,EAAE,IAAA,EAAM,WAAW,KAAA,CAAM,IAAA,EAAM,IAAI,QAAA,EAAS;AAC/D,MAAA,UAAA,CAAW,KAAA,GAAQ,SAAS,UAAA,CAAW,WAAA;AACvC,MAAA,UAAA,CAAW,KAAA,GAAQ,SAAS,UAAA,CAAW,KAAA;AACvC,MAAA,OAAA,CAAQ,KAAA,GAAQ,SAAS,UAAA,CAAW,aAAA;AAAA,IACxC,SAAS,CAAA,EAAG;AACR,MAAA,KAAA,CAAM,KAAA,GAAQ,CAAA;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,oCAAoC,CAAC,CAAA;AAAA,IACvD,CAAA,SAAE;AACE,MAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAAA,IACpB;AAAA,EACJ;AAEA,EAAA,SAAS,gBAAA,CAAiB,UAAgC,IAAA,EAAoB;AAC1E,IAAA,oBAAA,CAAqB,UAAU,IAAI,CAAA;AACnC,IAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAAA,EACpB;AAEA,EAAA,SAAS,YAAA,GAAqB;AAC1B,IAAA,OAAA,CAAQ,KAAA,GAAQ,IAAA;AAChB,IAAA,UAAA,CAAW,QAAQ,EAAC;AAAA,EACxB;AAEA,EAAA,SAAS,WAAA,GAAoB;AACzB,IAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAAA,EACpB;AAEA,EAAA,OAAO;AAAA,IACH,UAAA;AAAA,IACA,KAAA;AAAA,IACA,WAAA;AAAA,IACA,UAAA;AAAA,IACA,UAAA;AAAA,IACA,UAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAA;AAAA,IACA,KAAA;AAAA,IACA,QAAA;AAAA,IACA,QAAA;AAAA,IACA,gBAAA;AAAA,IACA,YAAA;AAAA,IACA;AAAA,GACJ;AACJ","file":"index.js","sourcesContent":["import { computed, ref, type ComputedRef, type Ref } from 'vue'\n\nimport type { PaginatedResponse } from '@zenky/storefront-api'\n\n/**\n * Pure composable пагинации списка (товары, статьи блога и т.д.).\n *\n * Универсальный — фетчер и тип элемента передаются снаружи через дженерик `T` и\n * замыкание, поэтому можно использовать для категории, коллекции, блога и т.п.\n * Не зависит от Nuxt — можно вынести в библиотеку.\n *\n * Поддерживает два режима навигации:\n * - `loadPage(N)` — заменяет всё содержимое элементами N-й страницы (для прямого\n *   ?page=N и для классической пагинации цифрами)\n * - `loadMore()` — добавляет следующую страницу к текущему списку (load-more / infinite)\n *\n * Хранит данные не как плоский массив, а как **чанки по страницам** (`pageChunks`).\n * Это позволяет UI рендерить каждую страницу отдельной секцией с `data-page` атрибутом,\n * что нужно для `content-visibility: auto` (оптимизация рендера скрытых секций).\n *\n * Параллельные вызовы игнорируются (одна загрузка за раз).\n */\n\nexport type PaginatedFetcher<T> = (page: number, count: number) => Promise<PaginatedResponse<T>>\n\nexport interface PageChunk<T> {\n    page: number\n    items: T[]\n}\n\nexport interface UsePaginatedListOptions<T> {\n    /** Размер страницы. По умолчанию 20 — баланс для 2/4/5-колоночных сеток. */\n    perPage?: number\n    /** С какой страницы начинать. Используется для инициализации из ?page=N. */\n    initialPage?: number\n    /**\n     * Готовые данные первой загрузки (для SSR-friendly инициализации без повторного\n     * запроса на клиенте). Если переданы — composable не делает первичный fetch.\n     */\n    initialData?: PaginatedResponse<T> | null\n    /** Функция загрузки страницы. Замыкание родителя — может включать фильтры, категорию и т.д. */\n    fetcher: PaginatedFetcher<T>\n}\n\nexport interface UsePaginatedList<T> {\n    /**\n     * Чанки страниц — основной источник данных. Каждый элемент — это загруженная\n     * страница со своими элементами. При `loadPage` — массив заменяется одним чанком.\n     * При `loadMore` — новый чанк добавляется в конец.\n     */\n    pageChunks: Ref<PageChunk<T>[]>\n    /** Плоский массив всех загруженных элементов (computed из pageChunks для удобства). */\n    items: ComputedRef<T[]>\n    /** Самая последняя загруженная страница (не обязательно «текущая» для пагинации). */\n    currentPage: Ref<number>\n    /** Диапазон страниц, чьи элементы сейчас в `pageChunks`. */\n    pageWindow: Ref<{ from: number; to: number }>\n    /** Всего страниц по данным API. */\n    totalPages: Ref<number>\n    /** Всего элементов по данным API. */\n    totalItems: Ref<number>\n    /** Есть ли следующая страница для load-more. */\n    hasMore: Ref<boolean>\n    /** Идёт ли запрос. */\n    loading: Ref<boolean>\n    /** Произошла ли ошибка при последнем запросе. */\n    error: Ref<unknown | null>\n\n    /** Заменить state элементами страницы N. Используется для прямого перехода и кликов на цифру. */\n    loadPage(page: number): Promise<void>\n    /** Догрузить следующую страницу (append). */\n    loadMore(): Promise<void>\n    /**\n     * Применить готовые данные страницы без запроса (используется когда initialData\n     * приходит асинхронно через `useAsyncData({ lazy: true })` на клиенте).\n     */\n    applyInitialData(response: PaginatedResponse<T>, page: number): void\n    /**\n     * Принудительно включить loading-флаг и очистить pageChunks. Используется\n     * когда SSR вернул пустые initialData и мы ждём клиентскую загрузку.\n     */\n    startLoading(): void\n    /**\n     * Выключить loading-флаг без применения данных (при ошибке, чтобы скрыть скелетоны).\n     */\n    stopLoading(): void\n}\n\nconst DEFAULT_PER_PAGE = 20\n\nexport function usePaginatedList<T>(options: UsePaginatedListOptions<T>): UsePaginatedList<T> {\n    const perPage = options.perPage ?? DEFAULT_PER_PAGE\n    const fetcher = options.fetcher\n\n    const pageChunks = ref<PageChunk<T>[]>([]) as Ref<PageChunk<T>[]>\n    const currentPage = ref<number>(options.initialPage ?? 1)\n    const pageWindow = ref<{ from: number; to: number }>({\n        from: options.initialPage ?? 1,\n        to: options.initialPage ?? 1,\n    })\n    const totalPages = ref<number>(1)\n    const totalItems = ref<number>(0)\n    const hasMore = ref<boolean>(false)\n    const loading = ref<boolean>(false)\n    const error = ref<unknown | null>(null)\n\n    /** Плоский массив для обратной совместимости — просто flatMap по чанкам. */\n    const items = computed<T[]>(() => pageChunks.value.flatMap(chunk => chunk.items))\n\n    /**\n     * Применить ответ API в replace-режиме (loadPage) — один чанк заменяет всё.\n     */\n    function applyReplaceResponse(response: PaginatedResponse<T>, page: number): void {\n        pageChunks.value = [{ page, items: response.items }]\n        currentPage.value = page\n        pageWindow.value = { from: page, to: page }\n        totalPages.value = response.pagination.total_pages\n        totalItems.value = response.pagination.total\n        hasMore.value = response.pagination.has_next_page\n    }\n\n    // Если переданы готовые данные первой страницы — заиспользуем без запроса\n    if (options.initialData) {\n        applyReplaceResponse(options.initialData, options.initialPage ?? 1)\n    }\n\n    async function loadPage(page: number): Promise<void> {\n        if (loading.value) return\n\n        loading.value = true\n        error.value = null\n        // Очищаем старые данные, чтобы UI показал skeleton вместо застывшей старой страницы.\n        pageChunks.value = []\n\n        try {\n            const response = await fetcher(page, perPage)\n            applyReplaceResponse(response, page)\n        } catch (e) {\n            error.value = e\n            console.error('[paginated-list] loadPage failed', e)\n        } finally {\n            loading.value = false\n        }\n    }\n\n    async function loadMore(): Promise<void> {\n        if (loading.value || !hasMore.value) return\n\n        const nextPage = currentPage.value + 1\n        loading.value = true\n        error.value = null\n\n        try {\n            const response = await fetcher(nextPage, perPage)\n\n            // Append — добавляем новый чанк вместо мержа в плоский массив\n            pageChunks.value = [...pageChunks.value, { page: nextPage, items: response.items }]\n            currentPage.value = nextPage\n            pageWindow.value = { from: pageWindow.value.from, to: nextPage }\n            totalPages.value = response.pagination.total_pages\n            totalItems.value = response.pagination.total\n            hasMore.value = response.pagination.has_next_page\n        } catch (e) {\n            error.value = e\n            console.error('[paginated-list] loadMore failed', e)\n        } finally {\n            loading.value = false\n        }\n    }\n\n    function applyInitialData(response: PaginatedResponse<T>, page: number): void {\n        applyReplaceResponse(response, page)\n        loading.value = false\n    }\n\n    function startLoading(): void {\n        loading.value = true\n        pageChunks.value = []\n    }\n\n    function stopLoading(): void {\n        loading.value = false\n    }\n\n    return {\n        pageChunks,\n        items,\n        currentPage,\n        pageWindow,\n        totalPages,\n        totalItems,\n        hasMore,\n        loading,\n        error,\n        loadPage,\n        loadMore,\n        applyInitialData,\n        startLoading,\n        stopLoading,\n    }\n}\n"]}

package/dist/ports/index.d.ts

@@ -0,0 +1,124 @@
+import { Ref } from 'vue';
+import { ZenkyIntegrationsSDK } from '@zenky/integrations-sdk';
+import { RemoteCatalog, ZenkyStorefront } from '@zenky/storefront-api';
+
+interface StorageOptions {
+    /** Время жизни в секундах. */
+    maxAge?: number;
+    sameSite?: 'strict' | 'lax' | 'none';
+    secure?: boolean;
+    path?: string;
+}
+/** Персистентное key-value хранилище (куки / localStorage / память). */
+interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string, options?: StorageOptions): void;
+    remove(key: string, options?: StorageOptions): void;
+}
+/** Конфиг рантайма, который ядро не должно знать откуда берётся. */
+interface StorefrontConfig {
+    baseUrl: string;
+    baseAuthUrl: string;
+    /** Опциональный sales channel для креативов/каналов. */
+    salesChannelId?: string;
+}
+/** Уведомления пользователю (тосты). Реализация — на стороне потребителя. */
+interface Notifier {
+    error(message: string): void;
+    success(message: string): void;
+    warning(message: string): void;
+    message(title: string, options?: {
+        description?: string;
+    }): void;
+}
+/** Репортер активности (busy-индикаторы, длительные операции). */
+interface ActivityReporter {
+    begin(kind: string): void;
+    end(kind: string): void;
+}
+/** Realtime-канал: подписка на события (WebSocket). Ядро не знает про pusher/транспорт. */
+interface RealtimeChannel {
+    bind(event: string, handler: (data?: unknown) => void): void;
+}
+interface RealtimeAdapter {
+    subscribe(channelName: string): RealtimeChannel | null;
+    unsubscribe(channelName: string): void;
+    isReady: Ref<boolean>;
+}
+interface RealtimePort {
+    get(): RealtimeAdapter | null;
+}
+interface EventsPort {
+    get(): ZenkyIntegrationsSDK | null;
+}
+/** Перезагрузка каталога при смене склада. Транспорт (fetch) — на стороне потребителя. */
+interface CatalogReloader {
+    reload(storeId: string, remoteCatalog: RemoteCatalog): Promise<void>;
+}
+/** RUM-репортер производительности (performance-marks). Реализация — у потребителя. */
+interface RumReporter {
+    mark(name: string): void;
+    measure(metric: string, startMark: string): void;
+}
+/** Идентификаторы commerce-события (session/anonymous) — попадают в checkout-request. */
+interface CommerceEventIdentity {
+    session_id?: string;
+    anonymous_id?: string;
+}
+interface CommerceAddedToCartPayload {
+    productId: string;
+    productVariantId: string;
+    quantity?: number;
+    unitPrice?: number;
+    totalPrice?: number;
+}
+interface CommerceRemovedFromCartPayload {
+    productId: string;
+    productVariantId: string;
+    quantity?: number;
+}
+/** Commerce-event трекинг (#29). Реализация/очередь/транспорт — у потребителя. */
+interface CommerceEventsPort {
+    trackAddedToCart(orderId: string, payload: CommerceAddedToCartPayload): void;
+    trackRemovedFromCart(orderId: string, payload: CommerceRemovedFromCartPayload): void;
+    getIdentity(): CommerceEventIdentity;
+}
+/**
+ * Railway-style результат: компилятор не даст прочитать `.value`,
+ * пока потребитель не проверил `.ok`. Замена throw на публичной границе.
+ */
+type Result<T = void, E = unknown> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+declare const ok: <T>(value: T) => Result<T, never>;
+declare const err: <E>(error: E) => Result<never, E>;
+/** Полный рантайм, который потребитель собирает и отдаёт в createStorefront(). */
+interface StorefrontRuntime {
+    /** SDK-клиент Zenky. Потребитель создаёт один инстанс и отдаёт сюда. */
+    sdk: ZenkyStorefront;
+    storage: StorageAdapter;
+    config: StorefrontConfig;
+    notifier: Notifier;
+    activity: ActivityReporter;
+    /** Ленивый провайдер analytics-интеграции, которая может появиться после setup. */
+    events?: EventsPort | null;
+    /** Ленивый провайдер realtime-транспорта (WebSocket). */
+    realtime?: RealtimePort | null;
+    /** Перезагрузка каталога при смене склада. Нет — reload пропускается. */
+    catalogReloader?: CatalogReloader | null;
+    /** RUM-метрики. Нет — инструментирование пропускается. */
+    rum?: RumReporter | null;
+    /** Commerce-event трекинг (#29). Нет — трекинг пропускается. */
+    commerceEvents?: CommerceEventsPort | null;
+}
+declare const NOOP_NOTIFIER: Notifier;
+declare const NOOP_ACTIVITY_REPORTER: ActivityReporter;
+declare const NOOP_RUM: RumReporter;
+/** In-memory storage — для SSR/тестов, без побочных эффектов на реальные куки. */
+declare function createMemoryStorage(): StorageAdapter;
+
+export { type ActivityReporter, type CatalogReloader, type CommerceAddedToCartPayload, type CommerceEventIdentity, type CommerceEventsPort, type CommerceRemovedFromCartPayload, type EventsPort, NOOP_ACTIVITY_REPORTER, NOOP_NOTIFIER, NOOP_RUM, type Notifier, type RealtimeAdapter, type RealtimeChannel, type RealtimePort, type Result, type RumReporter, type StorageAdapter, type StorageOptions, type StorefrontConfig, type StorefrontRuntime, createMemoryStorage, err, ok };

package/dist/ports/index.js

@@ -0,0 +1,3 @@
+export { NOOP_ACTIVITY_REPORTER, NOOP_NOTIFIER, NOOP_RUM, createMemoryStorage, err, ok } from '../chunk-AL5W5JSD.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/products/index.d.ts

@@ -0,0 +1,105 @@
+import { UnitType, Product, ProductVariant, NestedCategory, ProductModifiersRequest, Discount, ProductVariantOptionValue, CatalogItem } from '@zenky/storefront-api';
+import { ComputedRef, Ref } from 'vue';
+
+declare function getVariantWeight(variant: ProductVariant | null | undefined): number | null;
+declare function getProductWeight(product: Product): number | null;
+declare function toGrams(weight: number | null, unitType: UnitType): number | null;
+declare function formatWeight(weight: number | null, unitType: UnitType): string | null;
+
+interface CategoryWithProducts {
+    id: string;
+    shortId: string;
+    slug: string | null;
+    name: string | null;
+    products: Product[];
+}
+declare function useProductsByCategory(products: ComputedRef<Product[]>, categories: ComputedRef<NestedCategory[]>): {
+    grouped: ComputedRef<CategoryWithProducts[]>;
+};
+
+declare function useProductVariantModifiers(variant: ComputedRef<ProductVariant | null>): {
+    modifiersModel: Ref<ProductModifiersRequest[]>;
+    selectedModifiersHash: Ref<string | null>;
+    hasAnyModifier: ComputedRef<boolean>;
+};
+
+interface ResolvedPrice {
+    price: number;
+    originalPrice: number | null;
+    discount: Discount | null;
+}
+/**
+ * Определяет цену варианта с учётом склада.
+ * Приоритет: prices[stockId] → prices[null] → top-level price.
+ */
+declare function resolveVariantPrice(variant: ProductVariant, stockId?: string | null): ResolvedPrice;
+declare function useProductPricing(product: ComputedRef<Product>, stockId?: ComputedRef<string | null | undefined>): {
+    displayPrice: ComputedRef<number>;
+    originalDisplayPrice: ComputedRef<number | null>;
+    hasDifferentPrices: ComputedRef<boolean>;
+    needsSelection: ComputedRef<boolean>;
+};
+
+interface ProductVariantOptionListItem {
+    id: string;
+    name: string | null;
+    values: ProductVariantOptionValue[];
+}
+declare function useProductVariant(product: ComputedRef<Product>): {
+    optionsModel: Ref<Record<string, string>>;
+    optionsList: Ref<ProductVariantOptionListItem[]>;
+    selectedVariant: ComputedRef<ProductVariant | null>;
+    disabledValues: ComputedRef<Record<string, Set<string>>>;
+};
+
+interface PriceRecalculationOptions {
+    product: ComputedRef<Product>;
+    selectedVariant: ComputedRef<ProductVariant | null>;
+    modifiersModel: Ref<ProductModifiersRequest[]>;
+    requiredModifiersGroupIsMissing: ComputedRef<boolean>;
+    selectedModifiersHash: Ref<string | null>;
+}
+declare function usePriceRecalculation({ product, selectedVariant, modifiersModel, requiredModifiersGroupIsMissing, selectedModifiersHash, }: PriceRecalculationOptions): {
+    price: ComputedRef<number>;
+    originalPrice: ComputedRef<number | null>;
+    priceWasModified: ComputedRef<boolean>;
+    priceIsRecalculating: Ref<boolean>;
+};
+
+declare function useProductVariantSelector(product: ComputedRef<Product>): {
+    optionsModel: Ref<Record<string, string>>;
+    optionsList: Ref<ProductVariantOptionListItem[]>;
+    disabledValues: ComputedRef<Record<string, Set<string>>>;
+    modifiersModel: Ref<ProductModifiersRequest[]>;
+    selectedVariant: ComputedRef<ProductVariant | null>;
+    price: ComputedRef<number>;
+    originalPrice: ComputedRef<number | null>;
+    priceWasModified: ComputedRef<boolean>;
+    priceIsRecalculating: Ref<boolean>;
+    selectedModifiersHash: Ref<string | null>;
+    requiredModifiersGroupIsMissing: ComputedRef<boolean>;
+};
+
+interface OrderCredentials {
+    id: string;
+    token: string;
+}
+interface UseRelatedProductsApi {
+    fetchForProduct: (productId: string, orderCredentials: OrderCredentials | null, signal?: AbortSignal) => Promise<Product[]>;
+    fetchForOrder: (orderId: string, orderToken: string, signal?: AbortSignal) => Promise<Product[]>;
+}
+/**
+ * Один из вариантов товара и ни одного модификатора — такой товар можно класть
+ * в корзину одним кликом по рекомендации, минуя открытие карточки.
+ */
+declare function canAddDirectly(product: Product): boolean;
+declare function useRelatedProducts(): UseRelatedProductsApi;
+
+interface CatalogProductMatch {
+    product: Product;
+    catalogItem: CatalogItem;
+}
+/** Поиск товара по short_id в статичном каталоге. null — если не найден. */
+declare function findProductInCatalog(catalog: CatalogItem[], shortId: string): CatalogProductMatch | null;
+
+export { type CatalogProductMatch, type CategoryWithProducts, type OrderCredentials, type ProductVariantOptionListItem, type ResolvedPrice, canAddDirectly, findProductInCatalog, formatWeight, getProductWeight, getVariantWeight, resolveVariantPrice, toGrams, usePriceRecalculation, useProductPricing, useProductVariant, useProductVariantModifiers, useProductVariantSelector, useProductsByCategory, useRelatedProducts };

package/dist/products/index.js

@@ -0,0 +1,7 @@
+export { canAddDirectly, findProductInCatalog, formatWeight, getProductWeight, getVariantWeight, resolveVariantPrice, toGrams, usePriceRecalculation, useProductPricing, useProductVariant, useProductVariantModifiers, useProductVariantSelector, useProductsByCategory, useRelatedProducts } from '../chunk-IGDDWGS4.js';
+import '../chunk-5QCUH3FF.js';
+import '../chunk-PWHIDGKW.js';
+import '../chunk-XUGXLJZB.js';
+import '../chunk-V3VVDQIR.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/products/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/promotions/index.d.ts

@@ -0,0 +1,10 @@
+interface PromotionsChecker {
+    dispatchCheck: () => Promise<void>;
+}
+/**
+ * Проверка промо-акций. Вызывает dispatchPromotionsChecker после изменения корзины.
+ * Результат приходит через WebSocket (обрабатывается в useOrderChannel).
+ */
+declare function usePromotionsChecker(): PromotionsChecker;
+
+export { type PromotionsChecker, usePromotionsChecker };

package/dist/promotions/index.js

@@ -0,0 +1,7 @@
+export { usePromotionsChecker } from '../chunk-4MJKN7PL.js';
+import '../chunk-BWUKMWHL.js';
+import '../chunk-PWHIDGKW.js';
+import '../chunk-VL3T36VM.js';
+import '../chunk-V3VVDQIR.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/promotions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/schedule-Dd3zwHEb.d.ts

@@ -0,0 +1,27 @@
+import { ContactType, Contact, Schedule } from '@zenky/storefront-api';
+
+interface SocialLink {
+    type: ContactType;
+    url: string;
+    label: string;
+}
+declare function getSocialLinks(contacts: Contact[]): SocialLink[];
+declare function getEmailLink(contacts: Contact[]): string | null;
+declare function getWebsiteLink(contacts: Contact[]): string | null;
+
+interface DayScheduleInfo {
+    dayKey: string;
+    name: string;
+    hours: string | null;
+}
+interface TodayScheduleInfo {
+    isOpenNow: boolean;
+    todayHours: string | null;
+    openingAt: string | null;
+    closingAt: string | null;
+}
+declare function getTodayInfo(schedule: Schedule | null | undefined): TodayScheduleInfo | null;
+declare function getWeeklySchedule(schedule: Schedule | null | undefined, locale?: string): DayScheduleInfo[];
+declare function formatScheduleStatus(schedule: Schedule | null | undefined, locale?: string): string | null;
+
+export { type DayScheduleInfo as D, type SocialLink as S, type TodayScheduleInfo as T, getSocialLinks as a, getTodayInfo as b, getWebsiteLink as c, getWeeklySchedule as d, formatScheduleStatus as f, getEmailLink as g };

package/dist/seo/index.d.ts

@@ -0,0 +1,91 @@
+import { Media, Store, Product, NestedCategory, Article, OfferArticle, Seo, SeoMetaTag as SeoMetaTag$1 } from '@zenky/storefront-api';
+
+/**
+ * Shared SEO types used across storefront composables.
+ * Kept framework-agnostic for future extraction to a standalone library.
+ */
+interface BreadcrumbItem {
+    label: string;
+    to?: string;
+}
+
+declare const SEO_META_TAG_PRIORITY = "critical";
+type SeoMetaTag = Record<string, string>;
+declare function withSeoMetaPriority<T extends SeoMetaTag>(tag: T): T & {
+    tagPriority: typeof SEO_META_TAG_PRIORITY;
+};
+
+/**
+ * Resolves the best available URL from a Media object.
+ */
+declare function resolveMediaUrl(media: Media): string | null;
+/**
+ * Resolves store logo URL, preferring square logo over rectangular.
+ * Tries all available size variants so CDN assets with only hd/xlarge are found too.
+ */
+declare function resolveStoreLogoUrl(store: Store | null | undefined): string | null;
+/**
+ * Strips HTML tags from a string.
+ */
+declare function stripHtml(html: string): string;
+/**
+ * Prepares a string for use as og:description or meta description:
+ * strips HTML tags and truncates to maxLength (default 160).
+ */
+declare function prepareOgDescription(text: string | null | undefined, maxLength?: number): string | null;
+
+/**
+ * Каноничный публичный origin сайта из `store.domain`. Fallback (хост запроса)
+ * приносит потребитель — ядро не знает про useRequestURL.
+ */
+declare function resolveSiteOrigin(storeDomain: string | null | undefined, fallbackOrigin: string): string;
+
+/**
+ * JSON-LD schema.org/Product. Google → Rich Results (цена/наличие/рейтинг в выдаче).
+ * Возвращает массив (0 или 1 объект) — потребитель оборачивает в `<script ld+json>`.
+ * Spec: https://schema.org/Product
+ */
+declare function buildProductSchema(product: Product, currency: string): Record<string, unknown>[];
+
+/**
+ * JSON-LD для страницы категории: BreadcrumbList (хлебные крошки) + ItemList
+ * (первые 10 товаров). Возвращает массив JSON-LD объектов (0–2).
+ * Spec: https://schema.org/ItemList · https://schema.org/BreadcrumbList
+ */
+declare function buildCategorySchemas(category: NestedCategory, products: Product[], breadcrumbs: BreadcrumbItem[], origin: string): Record<string, unknown>[];
+
+/**
+ * JSON-LD schema.org/Article для страницы акции (редакционный контент).
+ * Spec: https://schema.org/Article
+ */
+declare function buildOfferArticleSchema(article: OfferArticle, storeName: string, origin: string): Record<string, unknown>[];
+/**
+ * JSON-LD schema.org/BlogPosting для статьи блога (Google Rich Results).
+ * Spec: https://schema.org/BlogPosting
+ */
+declare function buildBlogPostSchema(article: Article, storeName: string, origin: string): Record<string, unknown>[];
+
+/**
+ * JSON-LD schema.org/Organization (или LocalBusiness при наличии физической точки)
+ * для главной. Google → Knowledge Panel. Все данные из уже загруженного профиля.
+ * Spec: https://schema.org/Organization · https://schema.org/LocalBusiness
+ */
+declare function buildOrganizationSchema(store: Store, origin: string): Record<string, unknown>[];
+
+/** Уже разрешённые (с учётом дефолтов потребителя) значения OG/Twitter-тегов. */
+interface OgTagsInput {
+    title: string | null;
+    description?: string | null;
+    image?: string | null;
+    type?: string;
+    url?: string | null;
+}
+/** OG + Twitter meta-теги (critical-приоритет). Telegram читает twitter:image. */
+declare function buildOgTags(input: OgTagsInput): Record<string, string>[];
+
+/** SDK-теги `Seo.meta` → head-meta records (с critical-приоритетом для og/twitter/description). */
+declare function mapSeoMetaTags(tags: SeoMetaTag$1[]): Record<string, string>[];
+/** meta-теги из `Seo`-сущности (description + маппинг `Seo.meta`). Title резолвит потребитель. */
+declare function buildEntitySeoMeta(seo: Seo | null | undefined): Record<string, string>[];
+
+export { type BreadcrumbItem, type OgTagsInput, buildBlogPostSchema, buildCategorySchemas, buildEntitySeoMeta, buildOfferArticleSchema, buildOgTags, buildOrganizationSchema, buildProductSchema, mapSeoMetaTags, prepareOgDescription, resolveMediaUrl, resolveSiteOrigin, resolveStoreLogoUrl, stripHtml, withSeoMetaPriority };