@vitrine-kit/contracts 1.1.0 → 1.2.1

package/README.md

@@ -1,7 +1,7 @@
 # @vitrine-kit/contracts
 
-Пять стабильных контрактов Vitrine, от которых зависит каждая фича реестра: **Tokens · Data · Slots · Config · Blueprint**.
+The five stable Vitrine contracts that every registry feature depends on: **Tokens · Data · Slots · Config · Blueprint**.
 
-Это API под semver. Сломанный контракт ломает `add` у всех клиентов → расширяем **только аддитивно** (§5, §13 спеки).
+This is a semver-governed API. A broken contract breaks `add` for every client → we extend it **additively only** (spec §5, §13).
 
-Скелет (M0). Содержимое контрактов наполняется в M1; предложение по именам слотов/токенов — [docs/contracts-v1-proposal.md](../../docs/contracts-v1-proposal.md).
+Source of truth is **zod**; the JSON Schemas in `schemas/` are generated from it. The v1 slot/token naming proposal lives in [docs/contracts-v1-proposal.md](../../docs/contracts-v1-proposal.md).

package/dist/index.d.ts

@@ -25,17 +25,17 @@ declare const SPACE_TOKENS: readonly ["unit", "container-max", "container-paddin
 type SpaceToken = (typeof SPACE_TOKENS)[number];
 declare const MOTION_TOKENS: readonly ["duration-fast", "duration-normal", "ease-default"];
 type MotionToken = (typeof MOTION_TOKENS)[number];
-/** Одиночные «ручки» без группы. */
+/** Single "knobs" without a group. */
 declare const SINGLETON_TOKENS: readonly ["density", "border-width"];
 type SingletonToken = (typeof SINGLETON_TOKENS)[number];
-/** Имя CSS-переменной для токена: cssVar('color','primary') → '--vt-color-primary'. */
+/** CSS variable name for a token: cssVar('color','primary') → '--vt-color-primary'. */
 declare function cssVar(group: string, name?: string): `--vt-${string}`;
-/** Полный перечень имён CSS-переменных контракта — для скаффолда theme и доков. */
+/** Full list of the contract's CSS variable names — for theme scaffolding and docs. */
 declare const TOKEN_CSS_VARS: string[];
 /**
- * Tailwind-preset Vitrine: маппит ключи Tailwind на CSS-переменные контракта.
- * Используется в клиентском tailwind.config: `presets: [vitrinePreset]`.
- * Типизирован свободно, чтобы не тащить зависимость на tailwindcss в контракты.
+ * The Vitrine Tailwind preset: maps Tailwind keys to the contract's CSS variables.
+ * Used in the client's tailwind.config: `presets: [vitrinePreset]`.
+ * Loosely typed so contracts don't take a dependency on tailwindcss.
  */
 declare const vitrinePreset: {
     theme: {
@@ -44,11 +44,11 @@ declare const vitrinePreset: {
 };
 
 /**
- * Деньги — целое в минимальных единицах валюты (копейки/центы).
- * 199000 = 1990.00. Решение зафиксировано (см. демо-сид §18.2 спеки).
+ * Money — an integer in the currency's minor units (cents).
+ * 199000 = 1990.00. Decision is fixed (see the demo seed, spec §18.2).
  */
 type Money = number;
-/** ISO 4217, напр. 'RUB', 'USD', 'EUR'. */
+/** ISO 4217, e.g. 'USD', 'EUR', 'GBP'. */
 type CurrencyCode = string;
 interface Category {
     id: string;
@@ -69,9 +69,9 @@ interface Variant {
     title?: string;
     price: Money;
     currency: CurrencyCode;
-    /** null/undefined = склад не отслеживается. */
+    /** null/undefined = stock not tracked. */
     stock?: number | null;
-    /** Опции варианта, напр. { size: 'M', color: 'red' }. */
+    /** Variant options, e.g. { size: 'M', color: 'red' }. */
     options?: Record<string, string>;
 }
 interface Seo {
@@ -94,20 +94,20 @@ interface Product {
     };
     seo?: Seo;
     /**
-     * Поля, добавленные фичами через blueprint extend() (контракт 5),
-     * сюда мапит адаптер. Контракт остаётся стабильным — фичи читают свои ключи.
+     * Fields added by features via blueprint extend() (contract 5),
+     * mapped here by the adapter. The contract stays stable — features read their own keys.
      */
     extensions?: Record<string, unknown>;
 }
 type ProductSort = 'newest' | 'price-asc' | 'price-desc' | 'relevance';
 interface ProductQuery {
-    /** slug категории. */
+    /** Category slug. */
     category?: string;
     search?: string;
     sort?: ProductSort;
     page?: number;
     perPage?: number;
-    /** Фасеты фильтров: { color: ['red','blue'], size: ['M'] }. */
+    /** Filter facets: { color: ['red','blue'], size: ['M'] }. */
     filters?: Record<string, string[]>;
 }
 interface CartLine {
@@ -151,8 +151,8 @@ interface Order {
     createdAt: string;
 }
 /**
- * Источник каталога. Реализуется адаптерами PayloadCatalog* / VendureCatalog*.
- * Нужен на всех уровнях (каталог и выше).
+ * Catalog source. Implemented by the PayloadCatalog* / VendureCatalog* adapters.
+ * Needed at every tier (catalog and above).
  */
 interface CatalogSource {
     listProducts(query: ProductQuery): Promise<Product[]>;
@@ -161,10 +161,10 @@ interface CatalogSource {
     search(term: string): Promise<Product[]>;
 }
 /**
- * Коммерческий бэкенд. Только simple-store / full-store.
- * Реализуется PayloadCommerce* / VendureCommerce*.
- * Полная поверхность корзины зафиксирована в v1 (добавлять методы в интерфейс
- * позже = ломающее изменение для реализаций).
+ * Commerce backend. Only simple-store / full-store.
+ * Implemented by PayloadCommerce* / VendureCommerce*.
+ * The full cart surface is fixed in v1 (adding methods to the interface
+ * later = a breaking change for implementations).
  */
 interface CommerceBackend {
     createCart(): Promise<Cart>;
@@ -172,21 +172,21 @@ interface CommerceBackend {
     addItem(cartId: string, variantId: string, qty: number): Promise<Cart>;
     updateItem(cartId: string, lineId: string, qty: number): Promise<Cart>;
     removeItem(cartId: string, lineId: string): Promise<Cart>;
-    /** Hosted checkout активного платёжного провайдера → redirectUrl. */
+    /** Hosted checkout of the active payment provider → redirectUrl. */
     startCheckout(cartId: string): Promise<{
         redirectUrl: string;
     }>;
     getOrder(id: string): Promise<Order | null>;
 }
 
-/** 32 слота v1. Порядок и группировка — как в утверждённом предложении. */
+/** 32 v1 slots. Order and grouping match the approved proposal. */
 declare const SLOT_IDS: readonly ["global.banner-top", "global.header-start", "global.header-nav", "global.header-actions", "global.footer", "global.body-end", "home.hero", "home.below-hero", "home.sections", "home.bottom", "catalog.toolbar", "catalog.sidebar", "catalog.grid-top", "catalog.grid-bottom", "category.header", "category.below-products", "product.gallery", "product.below-title", "product.below-price", "product.purchase", "product.below-description", "product.tabs", "product.related", "cart.items-bottom", "cart.summary", "cart.below", "checkout.top", "checkout.below", "order.top", "order.below", "search.results-top", "search.empty"];
 type SlotId = (typeof SLOT_IDS)[number];
-/** Zod-перечисление слотов (для валидации feature.json / site.config). */
+/** Zod enum of slots (for validating feature.json / site.config). */
 declare const slotIdSchema: z.ZodEnum<["global.banner-top", "global.header-start", "global.header-nav", "global.header-actions", "global.footer", "global.body-end", "home.hero", "home.below-hero", "home.sections", "home.bottom", "catalog.toolbar", "catalog.sidebar", "catalog.grid-top", "catalog.grid-bottom", "category.header", "category.below-products", "product.gallery", "product.below-title", "product.below-price", "product.purchase", "product.below-description", "product.tabs", "product.related", "cart.items-bottom", "cart.summary", "cart.below", "checkout.top", "checkout.below", "order.top", "order.below", "search.results-top", "search.empty"]>;
 /**
- * Декларативная регистрация слота в манифесте фичи (feature.json, §8 спеки):
- * component — ИМЯ компонента, резолвится в репозитории клиента.
+ * Declarative slot registration in the feature manifest (feature.json, spec §8):
+ * component is the component NAME, resolved in the client repository.
  */
 declare const slotRegistrationSchema: z.ZodObject<{
     slot: z.ZodEnum<["global.banner-top", "global.header-start", "global.header-nav", "global.header-actions", "global.footer", "global.body-end", "home.hero", "home.below-hero", "home.sections", "home.bottom", "catalog.toolbar", "catalog.sidebar", "catalog.grid-top", "catalog.grid-bottom", "category.header", "category.below-products", "product.gallery", "product.below-title", "product.below-price", "product.purchase", "product.below-description", "product.tabs", "product.related", "cart.items-bottom", "cart.summary", "cart.below", "checkout.top", "checkout.below", "order.top", "order.below", "search.results-top", "search.empty"]>;
@@ -203,9 +203,9 @@ declare const slotRegistrationSchema: z.ZodObject<{
 }>;
 type SlotRegistration = z.infer<typeof slotRegistrationSchema>;
 /**
- * Рантайм-привязка имени к фактическому компоненту (используется @vitrine-kit/core
- * в lib/slots.ts клиента). Дженерик по типу компонента, чтобы контракт не
- * зависел от React.
+ * Runtime binding of a name to an actual component (used by @vitrine-kit/core
+ * in the client's lib/slots.ts). Generic over the component type so the contract
+ * doesn't depend on React.
  */
 interface SlotMount<TComponent = unknown> {
     slot: SlotId;
@@ -213,11 +213,11 @@ interface SlotMount<TComponent = unknown> {
     order?: number;
 }
 
-/** Переопределение/порядок секции страницы (композиция поверх wireframe). */
+/** Override/ordering of a page section (composition over the wireframe). */
 declare const layoutSectionSchema: z.ZodObject<{
     slot: z.ZodEnum<["global.banner-top", "global.header-start", "global.header-nav", "global.header-actions", "global.footer", "global.body-end", "home.hero", "home.below-hero", "home.sections", "home.bottom", "catalog.toolbar", "catalog.sidebar", "catalog.grid-top", "catalog.grid-bottom", "category.header", "category.below-products", "product.gallery", "product.below-title", "product.below-price", "product.purchase", "product.below-description", "product.tabs", "product.related", "cart.items-bottom", "cart.summary", "cart.below", "checkout.top", "checkout.below", "order.top", "order.below", "search.results-top", "search.empty"]>;
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Путь к override-компоненту в репо клиента (уникальное — как override, §13). */
+    /** Path to the override component in the client repo (unique — as an override, §13). */
     override: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     slot: "global.banner-top" | "global.header-start" | "global.header-nav" | "global.header-actions" | "global.footer" | "global.body-end" | "home.hero" | "home.below-hero" | "home.sections" | "home.bottom" | "catalog.toolbar" | "catalog.sidebar" | "catalog.grid-top" | "catalog.grid-bottom" | "category.header" | "category.below-products" | "product.gallery" | "product.below-title" | "product.below-price" | "product.purchase" | "product.below-description" | "product.tabs" | "product.related" | "cart.items-bottom" | "cart.summary" | "cart.below" | "checkout.top" | "checkout.below" | "order.top" | "order.below" | "search.results-top" | "search.empty";
@@ -266,7 +266,7 @@ declare const i18nSchema: z.ZodDefault<z.ZodObject<{
 }>>;
 declare const themeSchema: z.ZodDefault<z.ZodObject<{
     name: z.ZodDefault<z.ZodString>;
-    /** Файл со значениями токенов (заполняет дизайн-шаг). */
+    /** File with token values (filled by the design step). */
     cssFile: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -278,13 +278,13 @@ declare const themeSchema: z.ZodDefault<z.ZodObject<{
 declare const siteConfigSchema: z.ZodObject<{
     backend: z.ZodEnum<["payload", "vendure"]>;
     tier: z.ZodEnum<["catalog", "simple-store", "full-store"]>;
-    /** Флаги фич: { 'reviews': true }. Поднимаются примитивом установки. */
+    /** Feature flags: { 'reviews': true }. Set by the install primitive. */
     features: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     layout: z.ZodDefault<z.ZodObject<{
         sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
             slot: z.ZodEnum<["global.banner-top", "global.header-start", "global.header-nav", "global.header-actions", "global.footer", "global.body-end", "home.hero", "home.below-hero", "home.sections", "home.bottom", "catalog.toolbar", "catalog.sidebar", "catalog.grid-top", "catalog.grid-bottom", "category.header", "category.below-products", "product.gallery", "product.below-title", "product.below-price", "product.purchase", "product.below-description", "product.tabs", "product.related", "cart.items-bottom", "cart.summary", "cart.below", "checkout.top", "checkout.below", "order.top", "order.below", "search.results-top", "search.empty"]>;
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Путь к override-компоненту в репо клиента (уникальное — как override, §13). */
+            /** Path to the override component in the client repo (unique — as an override, §13). */
             override: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             slot: "global.banner-top" | "global.header-start" | "global.header-nav" | "global.header-actions" | "global.footer" | "global.body-end" | "home.hero" | "home.below-hero" | "home.sections" | "home.bottom" | "catalog.toolbar" | "catalog.sidebar" | "catalog.grid-top" | "catalog.grid-bottom" | "category.header" | "category.below-products" | "product.gallery" | "product.below-title" | "product.below-price" | "product.purchase" | "product.below-description" | "product.tabs" | "product.related" | "cart.items-bottom" | "cart.summary" | "cart.below" | "checkout.top" | "checkout.below" | "order.top" | "order.below" | "search.results-top" | "search.empty";
@@ -310,7 +310,7 @@ declare const siteConfigSchema: z.ZodObject<{
     }>>;
     theme: z.ZodDefault<z.ZodObject<{
         name: z.ZodDefault<z.ZodString>;
-        /** Файл со значениями токенов (заполняет дизайн-шаг). */
+        /** File with token values (filled by the design step). */
         cssFile: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
@@ -413,16 +413,16 @@ declare const siteConfigSchema: z.ZodObject<{
 }>;
 type SiteConfig = z.infer<typeof siteConfigSchema>;
 
-/** Базовые коллекции blueprint, которые фича может расширять. */
+/** Base blueprint collections a feature can extend. */
 declare const BLUEPRINT_COLLECTIONS: readonly ["product", "variant", "category", "media", "order", "user"];
 type BlueprintCollection = (typeof BLUEPRINT_COLLECTIONS)[number];
 declare const blueprintCollectionSchema: z.ZodEnum<["product", "variant", "category", "media", "order", "user"]>;
-/** Поддерживаемые типы добавляемых полей (минимальный набор v1). */
+/** Supported types for added fields (minimal v1 set). */
 declare const BLUEPRINT_FIELD_TYPES: readonly ["text", "textarea", "richText", "number", "checkbox", "select", "relationship", "date", "json", "array", "group"];
 type BlueprintFieldType = (typeof BLUEPRINT_FIELD_TYPES)[number];
 /**
- * Определение добавляемого поля (рантайм-форма для @vitrine-kit/payload-blueprint).
- * Допускает доп. ключи Payload-поля (options, relationTo, …) через passthrough.
+ * Definition of an added field (runtime form for @vitrine-kit/payload-blueprint).
+ * Allows extra Payload field keys (options, relationTo, …) via passthrough.
  */
 declare const blueprintFieldDefSchema: z.ZodObject<{
     name: z.ZodString;
@@ -441,21 +441,21 @@ declare const blueprintFieldDefSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">>;
 type BlueprintFieldDef = z.infer<typeof blueprintFieldDefSchema>;
-/** Рантайм-расширение, применяемое extend(). */
+/** Runtime extension applied by extend(). */
 interface BlueprintExtension {
     extend: BlueprintCollection;
     addFields: BlueprintFieldDef[];
 }
 /**
- * Сигнатура extend(), реализуемая в @vitrine-kit/payload-blueprint.
- * Аддитивна по контракту: добавляет поля в коллекцию.
+ * The extend() signature, implemented in @vitrine-kit/payload-blueprint.
+ * Additive by contract: it adds fields to a collection.
  */
 type Extend = (collection: BlueprintCollection, patch: {
     addFields: BlueprintFieldDef[];
 }) => void;
 /**
- * Форма blueprint в манифесте фичи (feature.json, §8): addFields — ИМЕНА полей
- * (строки); фактические определения живут в коде фичи / payload-blueprint.
+ * The blueprint shape in the feature manifest (feature.json, §8): addFields are field NAMES
+ * (strings); the actual definitions live in the feature code / payload-blueprint.
  */
 declare const blueprintManifestSchema: z.ZodObject<{
     extend: z.ZodEnum<["product", "variant", "category", "media", "order", "user"]>;
@@ -489,16 +489,16 @@ declare const featureEnvSchema: z.ZodObject<{
     key: string;
     required?: boolean | undefined;
 }>;
-/** registry/<feature>/feature.json — декларативный манифест фичи (§8). */
+/** registry/<feature>/feature.json — the declarative feature manifest (§8). */
 declare const featureManifestSchema: z.ZodObject<{
     name: z.ZodString;
     title: z.ZodString;
     kitVersion: z.ZodString;
-    /** semver-диапазон требуемых контрактов, напр. ">=1.0.0 <2.0.0". */
+    /** semver range of required contracts, e.g. ">=1.0.0 <2.0.0". */
     requiresContracts: z.ZodString;
     tier: z.ZodArray<z.ZodEnum<["catalog", "simple-store", "full-store"]>, "atleastone">;
     registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    /** Версионируемые пакеты: { "@vitrine-kit/core": ">=1.0.0" }. */
+    /** Versioned packages: { "@vitrine-kit/core": ">=1.0.0" }. */
     corePackages: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     npm: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     files: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -519,9 +519,9 @@ declare const featureManifestSchema: z.ZodObject<{
         set: Record<string, boolean>;
     }>>;
     /**
-     * Платёжный провайдер фичи checkout-<provider>. CLI по нему: (1) генерирует
-     * регистрацию провайдера в lib/payments.ts, (2) проставляет integrations.payments
-     * в site.config. register<Pascal>Provider() экспортируется из lib/<name>/register.ts.
+     * The payment provider of a checkout-<provider> feature. From it the CLI: (1) generates
+     * the provider registration in lib/payments.ts, (2) sets integrations.payments
+     * in site.config. register<Pascal>Provider() is exported from lib/<name>/register.ts.
      */
     payment: z.ZodOptional<z.ZodObject<{
         provider: z.ZodEnum<["stripe", "paddle", "yookassa"]>;
@@ -563,7 +563,7 @@ declare const featureManifestSchema: z.ZodObject<{
         key: string;
         required?: boolean | undefined;
     }>, "many">>;
-    /** Док, дописываемый в CLAUDE.md клиента. */
+    /** Doc appended to the client's CLAUDE.md. */
     claudeDoc: z.ZodOptional<z.ZodString>;
     conflicts: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     removable: z.ZodDefault<z.ZodBoolean>;
@@ -639,7 +639,7 @@ declare const featureManifestSchema: z.ZodObject<{
     removable?: boolean | undefined;
 }>;
 type FeatureManifest = z.infer<typeof featureManifestSchema>;
-/** vitrine.json — лок-файл клиентского репо (§6). */
+/** vitrine.json — the client repo's lock file (§6). */
 declare const vitrineLockSchema: z.ZodObject<{
     kitVersion: z.ZodString;
     contracts: z.ZodString;
@@ -670,7 +670,7 @@ declare const vitrineLockSchema: z.ZodObject<{
     }> | undefined;
 }>;
 type VitrineLock = z.infer<typeof vitrineLockSchema>;
-/** registry/_index.json — манифест реестра: все фичи + версия kit. */
+/** registry/_index.json — the registry manifest: all features + the kit version. */
 declare const registryIndexSchema: z.ZodObject<{
     kitVersion: z.ZodString;
     contracts: z.ZodString;

package/dist/index.js

@@ -101,7 +101,7 @@ var vitrinePreset = {
 // src/slots.ts
 import { z as z2 } from "zod";
 var SLOT_IDS = [
-  // global — на всех страницах
+  // global — on every page
   "global.banner-top",
   "global.header-start",
   "global.header-nav",
@@ -113,7 +113,7 @@ var SLOT_IDS = [
   "home.below-hero",
   "home.sections",
   "home.bottom",
-  // catalog — листинг/грид
+  // catalog — listing/grid
   "catalog.toolbar",
   "catalog.sidebar",
   "catalog.grid-top",
@@ -155,7 +155,7 @@ import { z as z3 } from "zod";
 var layoutSectionSchema = z3.object({
   slot: slotIdSchema,
   enabled: z3.boolean().default(true),
-  /** Путь к override-компоненту в репо клиента (уникальное — как override, §13). */
+  /** Path to the override component in the client repo (unique — as an override, §13). */
   override: z3.string().optional()
 });
 var integrationsSchema = z3.object({
@@ -166,20 +166,20 @@ var integrationsSchema = z3.object({
   shipping: z3.string().optional()
 }).default({});
 var i18nSchema = z3.object({
-  defaultLocale: z3.string().default("ru"),
-  locales: z3.array(z3.string()).default(["ru"]),
-  currency: z3.string().default("RUB"),
+  defaultLocale: z3.string().default("en"),
+  locales: z3.array(z3.string()).default(["en"]),
+  currency: z3.string().default("USD"),
   priceFormat: z3.string().optional()
-}).default({ defaultLocale: "ru", locales: ["ru"], currency: "RUB" });
+}).default({ defaultLocale: "en", locales: ["en"], currency: "USD" });
 var themeSchema = z3.object({
   name: z3.string().default("default"),
-  /** Файл со значениями токенов (заполняет дизайн-шаг). */
+  /** File with token values (filled by the design step). */
   cssFile: z3.string().default("theme/client.css")
 }).default({ name: "default", cssFile: "theme/client.css" });
 var siteConfigSchema = z3.object({
   backend: backendSchema,
   tier: tierSchema,
-  /** Флаги фич: { 'reviews': true }. Поднимаются примитивом установки. */
+  /** Feature flags: { 'reviews': true }. Set by the install primitive. */
   features: z3.record(z3.string(), z3.boolean()).default({}),
   layout: z3.object({ sections: z3.array(layoutSectionSchema).default([]) }).default({ sections: [] }),
   theme: themeSchema,
@@ -236,25 +236,25 @@ var featureManifestSchema = z5.object({
   name: z5.string().min(1),
   title: z5.string().min(1),
   kitVersion: z5.string().min(1),
-  /** semver-диапазон требуемых контрактов, напр. ">=1.0.0 <2.0.0". */
+  /** semver range of required contracts, e.g. ">=1.0.0 <2.0.0". */
   requiresContracts: z5.string().min(1),
   tier: z5.array(tierSchema).nonempty(),
   registryDependencies: z5.array(z5.string()).default([]),
-  /** Версионируемые пакеты: { "@vitrine-kit/core": ">=1.0.0" }. */
+  /** Versioned packages: { "@vitrine-kit/core": ">=1.0.0" }. */
   corePackages: z5.record(z5.string(), z5.string()).default({}),
   npm: z5.array(z5.string()).default([]),
   files: z5.array(featureFileMapSchema).default([]),
   config: z5.object({ set: z5.record(z5.string(), z5.boolean()) }).optional(),
   /**
-   * Платёжный провайдер фичи checkout-<provider>. CLI по нему: (1) генерирует
-   * регистрацию провайдера в lib/payments.ts, (2) проставляет integrations.payments
-   * в site.config. register<Pascal>Provider() экспортируется из lib/<name>/register.ts.
+   * The payment provider of a checkout-<provider> feature. From it the CLI: (1) generates
+   * the provider registration in lib/payments.ts, (2) sets integrations.payments
+   * in site.config. register<Pascal>Provider() is exported from lib/<name>/register.ts.
    */
   payment: z5.object({ provider: z5.enum(["stripe", "paddle", "yookassa"]) }).optional(),
   slots: z5.array(slotRegistrationSchema).default([]),
   blueprint: blueprintManifestSchema.optional(),
   env: z5.array(featureEnvSchema).default([]),
-  /** Док, дописываемый в CLAUDE.md клиента. */
+  /** Doc appended to the client's CLAUDE.md. */
   claudeDoc: z5.string().optional(),
   conflicts: z5.array(z5.string()).default([]),
   removable: z5.boolean().default(true)

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@vitrine-kit/contracts",
-  "version": "1.1.0",
-  "description": "Vitrine — пять стабильных контрактов: Tokens, Data, Slots, Config, Blueprint.",
+  "version": "1.2.1",
+  "description": "Vitrine — the five stable contracts: Tokens, Data, Slots, Config, Blueprint.",
   "license": "MIT",
   "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
   "module": "./dist/index.js",