@stapel/listings-react 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1 +1,66 @@
 # @stapel/listings-react
+
+## 0.2.0
+
+### Minor Changes
+
+- fcc9f1e: Two axes, both on screen — the storefront's long pole
+
+  `@stapel/listings-react` is the pair for stapel-listings: the listing page, the
+  submission flow, the seller's dashboard, and favourites.
+
+  The module has two independent state axes and 0.5.0 made them genuinely
+  diverge. `status` decides whether anyone can see a listing and nothing else
+  does; `moderation_status` decides nothing about that. Editing a LIVE listing
+  keeps `status: published` and moves only the moderation axis, so "published,
+  and we are reviewing your changes" is a real state — one a dashboard that
+  derived either field from the other could not say, because it would either
+  hide a listing buyers are reading or never tell its owner their edit is being
+  screened. `model/status.ts` produces both halves of the sentence from both
+  fields, once; the 9 × 4 table is asserted.
+
+  A publish refusal is per-field and arrives in an unusual envelope: an invalid
+  draft comes back as a BARE `ValidationBatchResult`, while a promotion that
+  fails afterwards comes back as the ordinary one. `publishRefusal` branches on
+  the body rather than the status, and `featureErrorsBySlug` adds the `field`
+  the fleet's routing convention reads — so "this box is wrong" never degrades
+  into "something is wrong".
+
+  Three contracts meet on the composer and none of them is an import. L2 pairs do
+  not import each other, so the gallery arrives as a two-member structural bag
+  (`@stapel/cdn-react`'s `refs` IS `images_draft`; its `settled` is the submit
+  gate), the category schema as a plain `FeatureDef[]`, and a stored CDN
+  reference through a host-supplied resolver — because no contract in this fleet
+  resolves a stranger's reference, and inventing `${cdnBase}/${ref}` would be
+  writing a contract nobody agreed to. `@stapel/attributes-react` is a real
+  dependency; it is L0, and it owns the editors, the mirror and the formatter.
+
+  Four things the pair says out loud rather than papering over:
+
+  - **there is no owner-scoped list endpoint.** `GET /listings/` answers
+    `published()` and takes no owner parameter, so a seller's drafts are
+    unreachable. The counters are real and are shown; the rows come from an
+    injected source, and with none the dashboard reports a NAMED failure instead
+    of an empty grid;
+  - **no read returns the `*_draft` twin**, so an abandoned draft reopens empty
+    and the composer says so. Editing a live listing is unaffected — the
+    published half IS the listing;
+  - **`PUT`/`PATCH` skip the ownership check** that every other owner operation
+    in the module performs, so they are absent from `ListingsApi`;
+    `save-draft` does the same write with the check;
+  - **`GET /{pk}/` has no `published()` filter**, so a draft answers 200 to
+    anyone with the id. The pane reports it instead of dressing a draft up as a
+    shop page.
+
+  Also here: the card another pair renders (badges formatted from the stored DAO
+  projection, so a grid of forty costs one query and no category read); a soft
+  delete that reads as "this listing was removed" rather than as a typo, using
+  the AllowAny status probe that still answers for it; favourites (owner verdict
+  F7) with the heart blocked-and-explained for a visitor rather than hidden; and
+  ru/es carrying the UI copy, not only the error keys, because the storefront is
+  ru-first and a half-translated submission form is visible immediately.
+
+  Generated against stapel-listings **0.6.1** — the release that fixed
+  `FeatureDto`/`FeatureDao`'s `discriminator.mapping` from one bogus `"null"`
+  entry to the ten type slugs, which is what makes the generated union usable as
+  the wire type at all.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stapel contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/api/types.d.ts

@@ -146,7 +146,7 @@ export interface ListingPageParams {
 /**
  * The currency a composer starts a new listing in.
  *
- * RUB by owner verdict F6 (`tasks/darom-storefront-design.md`, the owner's
+ * RUB by owner verdict F6 (storefront spec, the owner's
  * fork verdicts of 2026-08-22), and a default rather than a constant: `currency` is
  * a free `maxLength: 8` string on the wire (stapel-listings has no currency
  * enum — the vocabulary lives in stapel-currencies), so a deployment that

package/dist/api/types.js

@@ -27,7 +27,7 @@ export const MODERATION_STATUSES = [
 /**
  * The currency a composer starts a new listing in.
  *
- * RUB by owner verdict F6 (`tasks/darom-storefront-design.md`, the owner's
+ * RUB by owner verdict F6 (storefront spec, the owner's
  * fork verdicts of 2026-08-22), and a default rather than a constant: `currency` is
  * a free `maxLength: 8` string on the wire (stapel-listings has no currency
  * enum — the vocabulary lives in stapel-currencies), so a deployment that

package/dist/i18n/ru.d.ts

@@ -6,7 +6,7 @@ export { listingsErrorBundleRu } from "./generated/errors.ru.gen.js";
  * register it never carry these strings (the main entry does not import this
  * module — gated by size-limit + the bundle-purity test).
  *
- * This is the storefront's DEFAULT language (darom-storefront verdict F1:
+ * This is the storefront's DEFAULT language (storefront spec verdict F1:
  * ru-first), which is why the UI copy is here in full and not only the error
  * keys: a seller filling in a listing is the surface where a half-translated
  * form is most obvious.

package/dist/i18n/ru.js

@@ -6,7 +6,7 @@ export { listingsErrorBundleRu } from "./generated/errors.ru.gen.js";
  * register it never carry these strings (the main entry does not import this
  * module — gated by size-limit + the bundle-purity test).
  *
- * This is the storefront's DEFAULT language (darom-storefront verdict F1:
+ * This is the storefront's DEFAULT language (storefront spec verdict F1:
  * ru-first), which is why the UI copy is here in full and not only the error
  * keys: a seller filling in a listing is the surface where a half-translated
  * form is most obvious.

package/llms.txt

@@ -1,4 +1,4 @@
-# @stapel/listings-react 0.1.0
+# @stapel/listings-react 0.2.0
 
 Headless React flow pair for stapel-listings (contract >=0.6 <0.7) — business + state, zero visual opinion.
 Built on @stapel/core: typed client + StapelApiError envelope, auth token refresh,

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-manifest.mjs — do not edit; drift-gated (pnpm gen:manifest:check)",
   "package": "@stapel/listings-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "backend": {
     "module": "stapel-listings",
     "contract": ">=0.6 <0.7"

package/nav-manifest.json

@@ -1,6 +1,6 @@
 {
   "package": "@stapel/listings-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "entries": [
     {
       "id": "listings.detail",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/listings-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Headless React pair for stapel-listings: a typed client over the draft twin, the composer that turns a category schema into a submittable listing, and the owner's dashboard. Two independent axes are rendered as two — lifecycle `status` decides visibility and `moderation_status` decides nothing about it, so an edit to a live listing stays live and says 'under review' instead of vanishing. Feature values are drawn and mirrored by @stapel/attributes-react; photos arrive as an injected upload bag whose `refs` ARE `images_draft` and whose `settled` gates the submit; a publish refusal is routed onto the control that caused it by slug. Zero visual opinion in the main entry; an opt-in /default subpath ships the antd skin.",
   "license": "MIT",
   "repository": {
@@ -46,13 +46,6 @@
     "nav-manifest.json",
     "llms.txt"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "tsc -p tsconfig.test.json && vitest run --exclude test/prodBundlePurity.test.ts",
-    "lint": "eslint .",
-    "size": "size-limit",
-    "test:pack": "vitest run test/prodBundlePurity.test.ts"
-  },
   "size-limit": [
     {
       "name": "index — the headless pair (client + status axes + draft model + hooks): no antd",
@@ -94,12 +87,6 @@
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.2.0",
-    "@stapel/attributes-react": "workspace:^",
-    "@stapel/core": "workspace:^",
-    "@stapel/image": "workspace:^",
-    "@stapel/showcase": "workspace:^",
-    "@stapel/tokens": "workspace:^",
-    "@stapel/tokens-antd": "workspace:^",
     "@tanstack/react-query": "^5.81.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.1.0",
@@ -110,12 +97,25 @@
     "react-dom": "^19.1.0",
     "size-limit": "^11.2.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@stapel/attributes-react": "^0.2.0",
+    "@stapel/core": "^0.15.0",
+    "@stapel/image": "^0.2.0",
+    "@stapel/showcase": "^0.2.0",
+    "@stapel/tokens": "^0.5.0",
+    "@stapel/tokens-antd": "^0.5.0"
   },
   "engines": {
     "node": ">=22"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.test.json && vitest run --exclude test/prodBundlePurity.test.ts",
+    "lint": "eslint .",
+    "size": "size-limit",
+    "test:pack": "vitest run test/prodBundlePurity.test.ts"
   }
-}
+}

package/src/analytics/generated/events.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-events.mjs — do not edit; drift-gated (pnpm gen:events:check)",
   "package": "@stapel/listings-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "defined": [],
   "flows": []
 }