orionplace-react 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +203 -150
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,155 +1,26 @@
1
1
  # orionplace-react
2
2
 
3
- Set up a Next.js 16 storefront for your personal Orionplace marketplace API.
4
- The package includes a setup CLI, the App Router starter with typed Application Load
5
- initialization, and commented server source that is copied into your project
6
- alongside an integration README.
7
-
8
- The generated source includes the shared
9
- [`OrionplaceImage`](templates/components/orionplace/shared/OrionplaceImage.README.md),
10
- [`OrionplaceEmptyState`](templates/components/orionplace/shared/OrionplaceEmptyState.README.md),
11
- [`OrionplaceAvatar`](templates/components/orionplace/shared/OrionplaceAvatar.README.md),
12
- [`OrionplaceBreadcrumbs`](templates/components/orionplace/shared/OrionplaceBreadcrumbs.README.md),
13
- [`OrionplaceInfoHint`](templates/components/orionplace/shared/OrionplaceInfoHint.README.md),
14
- [`OrionplacePasswordInput`](templates/components/orionplace/shared/OrionplacePasswordInput.README.md)
15
- and
16
- [`StorefrontPagination`](templates/components/orionplace/shared/StorefrontPagination.README.md).
17
- [`StorefrontErrorPage`](templates/components/orionplace/shared/StorefrontErrorPage.README.md)
18
- provides the public error view.
19
- [`OrionplaceSelect`](templates/components/orionplace/shared/OrionplaceSelect.README.md)
20
- provides the shared keyboard-accessible selection control.
21
- [`OrionplaceSearchSelect`](templates/components/orionplace/shared/OrionplaceSearchSelect.README.md)
22
- provides delayed search with a controlled confirmed selection, loading, empty
23
- and retry states.
24
- [`ProfileAvatar`](templates/components/orionplace/account/ProfileAvatar.README.md)
25
- provides the profile photo upload and removal contract with an initials fallback.
26
- [`ProfileDetailsForm`](templates/components/orionplace/account/ProfileDetailsForm.README.md)
27
- edits the customer's name and date of birth while keeping the sign-in phone
28
- read-only.
29
- [`ProfilePasswordForm`](templates/components/orionplace/account/ProfilePasswordForm.README.md)
30
- creates or changes the customer's password with matching confirmation.
31
- [`ProfileDeleteAccount`](templates/components/orionplace/account/ProfileDeleteAccount.README.md)
32
- lets the customer delete their own account after confirming it cannot be restored.
33
- [`ProfileEmailSettings`](templates/components/orionplace/account/ProfileEmailSettings.README.md)
34
- handles the email verification steps, optional notification choice and notification
35
- language.
36
- [`AccountSection`](templates/components/orionplace/account/AccountSection.README.md)
37
- provides authenticated account navigation plus guest and initialization failure
38
- states.
39
- [`StorefrontLogout`](templates/components/orionplace/account/StorefrontLogout.README.md)
40
- presents pending, failed and completed sign-out states while the route owns the
41
- request and navigation.
42
- [`StorefrontProfile`](templates/components/orionplace/account/StorefrontProfile.README.md)
43
- assembles the authenticated profile summary and all four profile settings
44
- sections, and shows a sign-in explanation to guests.
45
- [`ProfileSignIn`](templates/components/orionplace/account/ProfileSignIn.README.md)
46
- renders every phone, password, one-time-code and registration step and reports
47
- typed authentication actions to the host.
48
- [`SignInHistory`](templates/components/orionplace/account/SignInHistory.README.md)
49
- reports initial, filtered and paginated sign-in-history requests and renders the
50
- returned devices, browsers and locations.
51
- [`AccountPromocodes`](templates/components/orionplace/account/AccountPromocodes.README.md)
52
- shows issued promo-code conditions and statuses and reports load and apply
53
- requests to the host.
54
- [`AccountActivity`](templates/components/orionplace/account/AccountActivity.README.md)
55
- switches between promo codes, the customer's reviews and sign-in history while
56
- mounting only the active section.
57
- [`AddressForm`](templates/components/orionplace/address/AddressForm.README.md)
58
- creates or edits a delivery address with region search, address suggestions and
59
- optional coordinate lookup.
60
- [`StorefrontAddresses`](templates/components/orionplace/address/StorefrontAddresses.README.md)
61
- loads saved addresses and provides add, edit, default and confirmed delete
62
- actions.
63
- [`BlogPostCard`](templates/components/orionplace/blog/BlogPostCard.README.md)
64
- renders a localized article preview as a link or selection button.
65
- [`BlogPostGroup`](templates/components/orionplace/blog/BlogPostGroup.README.md)
66
- arranges the browse store's article previews using the configured journal view.
67
- [`BlogCommentForm`](templates/components/orionplace/blog/BlogCommentForm.README.md)
68
- collects validated text for a new comment, reply or edit.
69
- [`BlogComments`](templates/components/orionplace/blog/BlogComments.README.md)
70
- renders nested article discussions, the customer's comments and all comment
71
- write actions.
72
- [`BlogArticle`](templates/components/orionplace/blog/BlogArticle.README.md)
73
- renders an SSR-readable article, subscription access, safe editor HTML,
74
- reading accounting, related product cards and its discussion.
75
- [`StorefrontJournal`](templates/components/orionplace/blog/StorefrontJournal.README.md)
76
- renders the SSR-ready article list with category and author filters,
77
- pagination, linked cards and an optional inline article.
78
- [`CartCheckoutDetails`](templates/components/orionplace/cart/CartCheckoutDetails.README.md)
79
- connects the confirmed cart address, payment, recipient and comment fields to
80
- their typed mutation actions.
81
- [`MainSearch`](templates/components/orionplace/search/MainSearch.README.md)
82
- connects the localized search field and hints to the separate browse store.
83
- The first storefront data components are
84
- [`BrandLogos`](templates/components/orionplace/branding/BrandLogos.README.md)
85
- and [`SocialLinks`](templates/components/orionplace/social/SocialLinks.README.md).
86
- [`MainBanner`](templates/components/orionplace/banners/MainBanner.README.md)
87
- renders localized banner images with manual navigation and category actions.
88
- [`EventsBlock`](templates/components/orionplace/events/EventsBlock.README.md)
89
- renders page events for the selected language and reports the selected event.
90
- [`CategoryGroup`](templates/components/orionplace/categories/CategoryGroup.README.md)
91
- renders ordered public categories or one parent's immediate public children.
92
- [`StorefrontHome`](templates/components/orionplace/storefront/StorefrontHome.README.md)
93
- assembles banners, categories, product sections and page events in storefront
94
- order.
95
- [`CatalogRepresentative`](templates/components/orionplace/catalog/CatalogRepresentative.README.md)
96
- adapts the verified compact product card for category highlights.
97
- [`CatalogHeader`](templates/components/orionplace/catalog/CatalogHeader.README.md)
98
- provides the focus-managed category panel, shortcuts, trails and representative
99
- product actions used by the storefront header.
100
- [`StorefrontCartButton`](templates/components/orionplace/storefront/StorefrontCartButton.README.md)
101
- shows the shared cart-position count and reports a cart selection.
102
- [`StorefrontWishlistButton`](templates/components/orionplace/storefront/StorefrontWishlistButton.README.md)
103
- shows the shared wishlist count with plain-click application handling and
104
- native modifier-click navigation.
105
- [`WalletBalance`](templates/components/orionplace/wallet/WalletBalance.README.md)
106
- formats the selected currency's Application Load wallet amount in full or
107
- compact form.
108
- [`StorefrontAccount`](templates/components/orionplace/storefront/StorefrontAccount.README.md)
109
- provides the guest login action and the authenticated profile, wallet and logout
110
- menu with keyboard navigation.
111
- [`StorefrontFooter`](templates/components/orionplace/storefront/StorefrontFooter.README.md)
112
- combines branding, social links, public categories and locale-preserving
113
- storefront links.
114
- [`StorefrontHeader`](templates/components/orionplace/storefront/StorefrontHeader.README.md)
115
- assembles search, selections, account actions and the interactive catalog with
116
- localized navigation.
117
- [`OrionplaceThemeProvider`](templates/components/orionplace/theme/OrionplaceThemeProvider.README.md)
118
- sets their shared color tokens.
119
- [`MainCurrencySwitcher`](templates/components/orionplace/currencies/MainCurrencySwitcher.README.md)
120
- [`UnitSwitcher`](templates/components/orionplace/units/UnitSwitcher.README.md)
121
- and [`MainLanguageSwitcher`](templates/components/orionplace/locale/MainLanguageSwitcher.README.md)
122
- use the separate current-selection store.
123
- [`HoverImageViewer`](templates/components/orionplace/products/HoverImageViewer.README.md)
124
- shows a product's first image in server HTML and starts loading its other
125
- images after hover or keyboard focus.
126
- The first product-card parts cover the
127
- [`title`](templates/components/orionplace/products/ProductCardTitle.README.md),
128
- [`description`](templates/components/orionplace/products/ProductCardDescription.README.md),
129
- [`price`](templates/components/orionplace/products/ProductCardPrice.README.md),
130
- [`stock notice`](templates/components/orionplace/products/ProductCardStockNotice.README.md),
131
- [`review rating`](templates/components/orionplace/products/ProductCardRating.README.md),
132
- [`seller`](templates/components/orionplace/products/ProductCardSeller.README.md),
133
- [`badges`](templates/components/orionplace/products/ProductCardBadges.README.md),
134
- [`favorite`](templates/components/orionplace/products/ProductCardFavorite.README.md),
135
- [`purchase actions`](templates/components/orionplace/products/ProductCardActions.README.md),
136
- [`variant choices`](templates/components/orionplace/products/ProductCardVariants.README.md)
137
- and the [`secondary-choice dialog`](templates/components/orionplace/products/ProductSecondaryVariantModal.README.md).
138
- [`ProductCard`](templates/components/orionplace/products/ProductCard.README.md)
139
- assembles these parts and delays each card's secondary images until hover
140
- or keyboard focus. [`ProductGroup`](templates/components/orionplace/products/ProductGroup.README.md)
141
- renders responsive rows of cards.
142
- [`ProductReviewImageViewer`](templates/components/orionplace/products/ProductReviewImageViewer.README.md)
143
- opens review photos with keyboard navigation.
144
- [`ProductReviewForm`](templates/components/orionplace/products/ProductReviewForm.README.md)
145
- collects validated review, reply and edit values.
146
- [`ProductReviewGallery`](templates/components/orionplace/products/ProductReviewGallery.README.md)
147
- loads scoped review photos and reports the owning review selection.
148
- [`ProductReviews`](templates/components/orionplace/products/ProductReviews.README.md)
149
- assembles review statistics, filters, photos, replies, reactions and writing
150
- controls for product, seller and account views.
151
- Their contracts are documented in English and Russian beside the maintained
152
- React source.
3
+ **A complete Next.js 16 storefront for your Orionplace marketplace, set up with one command.**
4
+
5
+ `orionplace-react` creates a server-rendered shop connected to your personal
6
+ marketplace API: catalog and search, product pages, cart and checkout, customer
7
+ account, journal and support, in English and Russian. The package includes a
8
+ setup CLI and the full storefront source, so every page and component in your
9
+ project is yours to change.
10
+
11
+ - **Setup CLI:** `init`, `set backend`, `add frontend`, `set mimic` and `update`.
12
+ - **API gateway:** the browser calls `/api/...` on your own domain; the server
13
+ forwards it to your marketplace backend with cookies bound to the storefront.
14
+ - **Typed store:** one Application Load request fills it before the first render.
15
+ - **124 storefront components**, each with an English and Russian README
16
+ ([list](#components)).
17
+ - **Several storefront domains** on one backend, each with its own mapping.
18
+ - **Android app** from the same project with Capacitor 8.
19
+
20
+ **Contents:** [Quick start](#quick-start-from-zero) ·
21
+ [Existing project](#existing-nextjs-16-project) · [Components](#components) ·
22
+ [Commands](#commands) · [Android app](#android-app) ·
23
+ [Update](#update-an-existing-project)
153
24
 
154
25
  Requires Node.js 20.9+ and a Node server deployment. Static export and edge-only
155
26
  hosting are not supported by this filesystem-based integration; only the Android
@@ -251,6 +122,188 @@ these mappings for new projects and updates unchanged generated configuration.
251
122
  If you already own `tsconfig.json`, it is preserved; merge these aliases before
252
123
  starting the application. Imports then work at any component directory depth.
253
124
 
125
+ <!-- components:start (generated by scripts/generate-package-readme-components.mjs) -->
126
+ ## Components
127
+
128
+ The starter includes **124 storefront components**, copied into
129
+ `components/orionplace/` of your project. Each one has a README in English and Russian
130
+ next to its source that describes its inputs, data and actions.
131
+
132
+ ### Storefront structure
133
+
134
+ Main pages and the shared storefront frame.
135
+
136
+ | Component | Name | What it does |
137
+ | --- | --- | --- |
138
+ | **Header** | `StorefrontHeader` | The storefront header and its search, catalog, manufacturer and journal links, locale, currency, account, wishlist and cart controls. |
139
+ | **Storefront logo** | `BrandLogos` | Displays one logo from store.init.logos. |
140
+ | **Product search** | `MainSearch` | A search input with suggestions in the storefront language. |
141
+ | **Language selector** | `MainLanguageSwitcher` | Selects the storefront language and its associated currency and measurement units. |
142
+ | **Currency selector** | `MainCurrencySwitcher` | Selects the current storefront currency from the available options. |
143
+ | **Storefront account** | `StorefrontAccount` | Guest sign-in button and signed-in account menu with profile and wallet actions. |
144
+ | **Wallet balance** | `WalletBalance` | Displays the wallet balance in the selected storefront currency. |
145
+ | **Sign-out page** | `StorefrontLogout` | Session sign-out, failure retry and return to the storefront. |
146
+ | **Wishlist button** | `StorefrontWishlistButton` | Displays the wishlist count and links to the wishlist page. |
147
+ | **Cart button** | `StorefrontCartButton` | Displays the cart count and emits a request to open the cart page. |
148
+ | **Cart preview** | `CartPreview` | A compact dropdown under the header's cart button with cart products, quantities and amounts in the selected currency. |
149
+ | **Catalog menu** | `CatalogHeader` | Category navigation with nested sections and representative product cards. |
150
+ | **Catalog representative** | `CatalogRepresentative` | A compact product card used in the catalog menu, with the same navigation, variant, wishlist and purchase actions. |
151
+ | **Storefront home** | `StorefrontHome` | Banners, the optional Popular categories block, product sections, storefront events and recommendations. |
152
+ | **Storefront banners** | `MainBanner` | A carousel of banner images for the current storefront language, with responsive image formats. |
153
+ | **Popular categories block** | `CategoryGroup` | Optional home-page block of public category tiles. |
154
+ | **Product group** | `ProductGroup` | Displays a collection of product cards with images, prices, variant selection and purchase controls. |
155
+ | **Product card** | `ProductCard` | Combines a product’s image, name, price, variants, wishlist button and purchase controls in one card. |
156
+ | **Product photo viewer** | `HoverImageViewer` | A separate product photo viewer with dot buttons: it switches photos with the pointer, with a swipe and from the keyboard, and a click passes the chosen photo's address to the application. |
157
+ | **Product card title** | `ProductCardTitle` | Displays the localized product name in the card. |
158
+ | **Product card description** | `ProductCardDescription` | Displays the localized short product description as plain text, with HTML tags removed. |
159
+ | **Product card badges** | `ProductCardBadges` | Marks new, popular, good-deal and low-stock products with badges in the card. |
160
+ | **Product card wishlist button** | `ProductCardFavorite` | Requests adding or removing the product from the wishlist; the supplied storefront sends guests to sign-in. |
161
+ | **Seller in the product card** | `ProductCardSeller` | Displays the product seller’s name and rating in the card. |
162
+ | **Product card rating** | `ProductCardRating` | Displays the product’s average rating and review count in the card. |
163
+ | **Product card variants** | `ProductCardVariants` | Selects a primary or secondary product variant. |
164
+ | **Secondary variant selector** | `ProductSecondaryVariantModal` | Shows primary and secondary product choices in a modal and can continue the selected purchase action. |
165
+ | **Product card price** | `ProductCardPrice` | Displays the price in the selected currency and the original price when the product is discounted. |
166
+ | **Low-stock notice** | `ProductCardStockNotice` | Warns that the product will soon run out of stock. |
167
+ | **Product card purchase controls** | `ProductCardActions` | Product-card controls for the cart, quantity, availability notifications and preorder when available. |
168
+ | **Preorder dialog** | `ProductPreorderDialog` | The selected product and contact details for a preorder request. |
169
+ | **Storefront events** | `EventsBlock` | A full-width carousel of layout-event images for the current storefront language, with responsive image formats. |
170
+ | **Event block and promotion enrollment** | `EventEnrollmentDialog` | Displaying the event block and opening promotion enrollment from the selected event. |
171
+ | **Footer** | `StorefrontFooter` | Store identity, navigation, a contact-page link and social links. |
172
+ | **Social links** | `SocialLinks` | Display the store’s published social links and icons. |
173
+ | **Error page** | `StorefrontErrorPage` | Page-not-found (404) and failure (500) page with Home, Catalog and Retry actions. |
174
+ | **Storefront theme** | `OrionplaceThemeProvider` | Applies the selected light or dark storefront theme and optional color overrides to its content. |
175
+
176
+ ### Catalog and discovery
177
+
178
+ Browse categories, search results and product sources.
179
+
180
+ | Component | Name | What it does |
181
+ | --- | --- | --- |
182
+ | **Catalog component** | `StorefrontCatalog` | The component shows store categories, subcategories and product links. |
183
+ | **Category page** | `StorefrontCategory` | A category with its breadcrumb path, subcategories, filters and paginated product cards. |
184
+ | **Search results** | `ProductSearchResults` | Filters, products, loading and empty states for search, category, seller and recommendation results. |
185
+ | **Search filters** | `SearchFilters` | Price, discount, rating, review, category, seller, manufacturer and variant facets with selectable values and optional result counts. |
186
+ | **Sellers** | `StorefrontSellers` | Seller directory with filters and sorting, and a seller profile with its products. |
187
+ | **Seller filters** | `SellerFilters` | Seller name, minimum rating and category filters for the seller directory. |
188
+ | **Seller summary** | `SellerSummary` | Seller logo, name, rating, selling-since badge, product count and description. |
189
+ | **Seller photos** | `SellerPhotoGallery` | The seller’s approved photos as a square grid with a photo viewer. |
190
+ | **Stores** | `StorefrontStores` | Store addresses, map, phone numbers, opening hours and products. |
191
+ | **Manufacturers and their products** | `StorefrontManufacturers` | Alphabetical index, letter-based lists and manufacturer details. |
192
+ | **Manufacturer index** | `ManufacturerIndex` | Manufacturer logos and letter groups. |
193
+
194
+ ### Products and shopping
195
+
196
+ Product details, saved items and the cart.
197
+
198
+ | Component | Name | What it does |
199
+ | --- | --- | --- |
200
+ | **Product details** | `StorefrontProduct` | Loads and displays a published product or a secret-key preview with images, purchase choices, details and reviews. |
201
+ | **Page path** | `OrionplaceBreadcrumbs` | Linked path from the storefront home page through parent categories to the current page. |
202
+ | **Product characteristics** | `ProductSpecificationsDialog` | Every characteristic of the product in a dialog over the page. |
203
+ | **Product reviews** | `ProductReviews` | Reviews, replies, ratings and the user’s submissions. |
204
+ | **Review form** | `ProductReviewForm` | Rating, text and photos for a review or reply. |
205
+ | **Customer review photos** | `ProductReviewGallery` | Review photos for the selected product. |
206
+ | **Review photo viewer** | `ProductReviewImageViewer` | The photos of one review, shown large on the same page. |
207
+ | **Promo code products** | `PromoProducts` | The products a promo code offer applies to, with the offer’s conditions. |
208
+ | **Wishlist and availability notices** | `StorefrontWishlist` | Saved products and products with availability notifications, shown as standard product cards. |
209
+ | **Cart and checkout** | `StorefrontCart` | Cart items, promo codes, delivery, payment and order creation. |
210
+ | **Cart item** | `CartLineItem` | Item name, image, price, quantity and removal. |
211
+ | **Cart item options** | `CartItemOptions` | Option products as product cards, with text and file attachment for an item. |
212
+ | **Checkout details** | `CartCheckoutDetails` | Delivery address, payment method, recipient and comment. |
213
+ | **Shipment delivery selection** | `CartDeliverySelector` | Delivery methods with icons, pickup points and their map for one shipment. |
214
+ | **Delivery map** | `DeliveryMap` | Selectable locations on Yandex Maps for delivery pickup and the store directory. |
215
+
216
+ ### Customer account
217
+
218
+ Profile, orders, addresses and account activity.
219
+
220
+ | Component | Name | What it does |
221
+ | --- | --- | --- |
222
+ | **Account sections** | `AccountSection` | Account navigation and sign-in for private storefront sections. |
223
+ | **Personal profile** | `StorefrontProfile` | Account overview and forms for personal details, verified email, notification preferences, avatar, password and account deletion. |
224
+ | **Profile photo** | `ProfileAvatar` | Upload or remove the current account’s avatar. |
225
+ | **Personal details** | `ProfileDetailsForm` | Edit the account holder’s name and date of birth. |
226
+ | **Email and notifications** | `ProfileEmailSettings` | Verify an email address and choose optional email-notification and email-language preferences. |
227
+ | **Account password** | `ProfilePasswordForm` | Create or change the account password. |
228
+ | **Password field** | `OrionplacePasswordInput` | Password input with a button that shows or hides the entered password. |
229
+ | **Delete account** | `ProfileDeleteAccount` | Delete the signed-in customer's own account. |
230
+ | **Account sign-in** | `ProfileSignIn` | Phone-based account sign-in and registration. |
231
+ | **User promo codes** | `AccountPromocodes` | Available promo codes and applying a selected code to the cart. |
232
+ | **My activity** | `AccountActivity` | The user’s promo codes, reviews and sign-in history. |
233
+ | **Sign-in history** | `SignInHistory` | The user’s sign-in dates, devices, browsers and IP addresses. |
234
+ | **User orders** | `StorefrontOrders` | Order history, purchased items, payment, cancellation and repeat. |
235
+ | **Order details** | `OrderDetails` | Order items, shipments, tracking, purchased content and attachments. |
236
+ | **Order payment selection** | `OrderPaymentForm` | Available payment-method selection for an existing order. |
237
+ | **User addresses** | `StorefrontAddresses` | Saved addresses, address editing and default delivery selection. |
238
+ | **Address form** | `AddressForm` | Address creation and editing with country selection, region search, text suggestions and location lookup. |
239
+ | **Value selector** | `OrionplaceSelect` | Selects one value from a labeled list, with keyboard controls, country flags and option icons. |
240
+ | **Search selector** | `OrionplaceSearchSelect` | Selects one value from options searched as the user types, with a loading spinner and retry. |
241
+ | **Wallet and payments** | `StorefrontWallet` | Payment history, balance top-ups and cancellation of unpaid invoices. |
242
+ | **Wallet top-up form** | `WalletTopUpForm` | Amount, currency and payment-method selection for a wallet top-up. |
243
+ | **Payment panel** | `PaymentPanel` | Opens the payment link and lets the user refresh its status. |
244
+ | **Pagination** | `StorefrontPagination` | Previous and next controls with the current page for a returned list. |
245
+
246
+ ### Subscriptions and support
247
+
248
+ Plans, active subscriptions and support requests.
249
+
250
+ | Component | Name | What it does |
251
+ | --- | --- | --- |
252
+ | **Subscription plans** | `StorefrontTariffs` | Plans grouped by subscription, with search, sign-in for guests and subscription purchase. |
253
+ | **Subscription plan details** | `StorefrontTariff` | One public plan with its media, description, features, periods, options and subscription purchase. |
254
+ | **Subscription plans** | `TariffCards` | Plan cards in a responsive grid. |
255
+ | **Subscription plan card** | `TariffCard` | A plan card with its image, trial badge, name, description, the modules and limits of the plan, the option chooser, period prices and subscribe actions. |
256
+ | **Plan image** | `TariffCardImage` | The first small plan image. |
257
+ | **Plan name** | `TariffCardTitle` | The tariff name in its card, in the selected language. |
258
+ | **Plan description** | `TariffCardDescription` | The short plan description without HTML tags, and the full description under Details. |
259
+ | **Plan modules, limits and options** | `TariffCardFeatures` | The modules and limits of a plan from `tariff_variables_json`, each with its explanation, and the chooser of the plan options. |
260
+ | **Information hint** | `OrionplaceInfoHint` | Small information button that explains the term beside it. |
261
+ | **Plan prices** | `TariffCardPrices` | The period switcher, the price for the chosen period and the Subscribe and Try actions. |
262
+ | **Plan purchase** | `TariffSubscriptionModal` | Select an option, enter a promotion code and confirm a subscription purchase. |
263
+ | **My subscriptions** | `StorefrontSubscriptions` | Subscription dates, plan, usage, service details, automatic renewal, renewal payment and support. |
264
+ | **Renewal payment** | `SubscriptionExtendDialog` | The period, the promo code and the amount for extending a subscription. |
265
+ | **Automatic renewal** | `SubscriptionRenewalDialog` | The period that is paid automatically, or turning it off. |
266
+ | **Plan and option change** | `SubscriptionChangeDialog` | The new plan or service option, its period and the amount that is charged. |
267
+ | **Subscription cancellation** | `SubscriptionCancelDialog` | The confirmation that stops automatic renewal and keeps the paid period. |
268
+ | **Plan and usage** | `SubscriptionPlanSummary` | The plan picture, description and parameters with the usage the subscription service reported. |
269
+ | **Subscription service details** | `SubscriptionRemoteDetails` | The identifier, confirmation time and host a subscription service returned. |
270
+ | **Support conversations** | `StorefrontSupport` | Customer support conversations for general questions, sellers, order items and subscriptions. |
271
+ | **Conversation messages** | `TicketConversation` | Messages, attachments, conversation closing and support rating. |
272
+ | **Conversation item** | `TicketItemCard` | The purchased item a conversation is about, with its image, variant or option, quantity and paid amount. |
273
+ | **Subscription of a conversation** | `TicketSubscriptionCard` | The subscription a support conversation is about: plan, number, state, paid-until date and automatic renewal. |
274
+ | **Conversation image** | `TicketImage` | Loading and viewing an image from the user’s conversation. |
275
+ | **Support message form** | `TicketMessageForm` | Message text and images for a new conversation or reply. |
276
+
277
+ ### Content and contact
278
+
279
+ Journal content and customer contact flows.
280
+
281
+ | Component | Name | What it does |
282
+ | --- | --- | --- |
283
+ | **Journal** | `StorefrontJournal` | Paged journal of store articles with category and author filters. |
284
+ | **Journal article** | `BlogArticle` | An article, subscription access and its discussion. |
285
+ | **Article comments** | `BlogComments` | Discussion, replies and the user’s own comments. |
286
+ | **Comment form** | `BlogCommentForm` | Text for a new comment, reply or edit. |
287
+ | **Blog posts** | `BlogPostGroup` | Publication previews in a grid, list or layout with a lead card. |
288
+ | **Blog post card** | `BlogPostCard` | Publication image, localized title, plain-text preview and reading time. |
289
+ | **Contact page** | `StorefrontContact` | Company contact and registration details, with a form for messaging the store. |
290
+ | **Contact details** | `AboutPage` | Display the store’s published company and contact information. |
291
+ | **Contact form** | `ContactForm` | Sending a question to the store. |
292
+ | **Unsubscribe from emails** | `EmailUnsubscribe` | Confirming an unsubscribe request from an email link. |
293
+
294
+ ### Shared interface
295
+
296
+ Small reusable states and identity elements.
297
+
298
+ | Component | Name | What it does |
299
+ | --- | --- | --- |
300
+ | **Empty state** | `OrionplaceEmptyState` | Line drawing and message shown when a list, history or search result has no items. |
301
+ | **Avatar** | `OrionplaceAvatar` | Round user photo with initials when no photo is available. |
302
+ | **Storefront image** | `OrionplaceImage` | Loads a safe public image lazily and shows an accessible placeholder when the image is missing or fails. |
303
+ | **Measurement unit selector** | `UnitSwitcher` | Selects a weight or length unit from those available in the storefront. |
304
+
305
+ <!-- components:end -->
306
+
254
307
  ## Commands
255
308
 
256
309
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "orionplace-react",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Next.js 16 storefront for your Orionplace marketplace: setup CLI, server API gateway, typed store and ready-made catalog, cart, checkout and account components in English and Russian, plus an Android app build.",
5
5
  "type": "module",
6
6
  "license": "MIT",