@stapel/listings-react 0.25.1 → 0.25.2

package/dist/index.js

@@ -68,6 +68,7 @@ export { MY_LISTINGS_TABS, MY_LISTINGS_TAB_STATUSES, MY_LISTINGS_UNTABBED_STATUS
 export { LISTING_TRANSITIONS, OWNER_TRANSITIONS, canDelete, canTransition, ownerMoves, } from "./model/transitions.js";
 // ── model: the owner's own rows ──────────────────────────────────────────────
 export { defaultMyListingsSource } from "./model/mineSource.js";
+export { MY_LISTINGS_TAB_PARAM, NO_ADDRESS, browserAddress, searchWithTab, tabFromSearch, } from "./model/tabAddress.js";
 export { myListingImages, myListingPrice, myListingTitle, showsDraft, } from "./model/mine.js";
 // ── model: the draft twin ────────────────────────────────────────────────────
 export { EMPTY_LOCATION, createDraftBody, draftPatchFromValues, draftValuesFromDetail, draftValuesFromWire, droppedFeatureSlugs, emptyDraftValues, retainKnownFeatureValues, } from "./model/draft.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/model/tabAddress.d.ts

@@ -0,0 +1,42 @@
+import type { MyListingsTab } from "./status.js";
+/** The query parameter the tab lives in. */
+export declare const MY_LISTINGS_TAB_PARAM = "tab";
+/**
+ * The tab a query string names, or `undefined`.
+ *
+ * An unknown value is `undefined` and NOT an error: a link written by hand, a
+ * tab this build has dropped, or a `?tab=` some other component on the page
+ * owns must all fall back to the host's `initialTab` rather than throwing or
+ * opening an empty list.
+ */
+export declare function tabFromSearch(search: string): MyListingsTab | undefined;
+/**
+ * The same query string with the tab written into it.
+ *
+ * Every other parameter is preserved verbatim and in place: the dashboard is
+ * one component on somebody's page, and rewriting an address it does not own
+ * would drop whatever else is in it.
+ */
+export declare function searchWithTab(search: string, tab: MyListingsTab): string;
+/**
+ * The address binding. A host with a router passes its own; absent, the
+ * browser's is used and a non-DOM environment gets one that does nothing.
+ */
+export interface MyListingsAddress {
+    /** The current query string, `?`-prefixed or not — both parse. */
+    readonly search: string;
+    /** Write the tab. See the module note for why this replaces. */
+    setTab(tab: MyListingsTab): void;
+}
+/** An address that carries nothing and remembers nothing — SSR, and a host
+ * that opts out. */
+export declare const NO_ADDRESS: MyListingsAddress;
+/**
+ * The browser's own address, or {@link NO_ADDRESS} where there is no document.
+ *
+ * Read fresh on every call rather than captured: the host's router may have
+ * navigated since this component mounted, and a stale copy would write back
+ * an address that is no longer on screen.
+ */
+export declare function browserAddress(): MyListingsAddress;
+//# sourceMappingURL=tabAddress.d.ts.map

package/dist/model/tabAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabAddress.d.ts","sourceRoot":"","sources":["../../src/model/tabAddress.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAKxE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;CAClC;AAED;oBACoB;AACpB,eAAO,MAAM,UAAU,EAAE,iBAGxB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAelD"}

package/dist/model/tabAddress.js

@@ -0,0 +1,84 @@
+/**
+ * The dashboard's open tab, IN THE ADDRESS.
+ *
+ * `<MyListingsPane>` kept its tab in component state, which is the same as
+ * keeping it nowhere: `/account/listings?tab=drafts` opened Active, a reload
+ * threw the tab away, and a seller who wanted to send somebody (or themselves,
+ * tomorrow) to their drafts had no address that meant "drafts". "Which of my
+ * three lists am I looking at" is exactly the kind of state a URL is for —
+ * `@stapel/search-react` says the same thing at length about its filters.
+ *
+ * ── Why this module and not a router ─────────────────────────────────────
+ *
+ * This pair carries no router and must not grow one: a package that reached
+ * for `react-router` would be unusable in a Next.js app and vice versa. So the
+ * address is read and written through the two DOM APIs every browser has, and
+ * the whole of that contact is here — three pure functions plus one guarded
+ * read/write pair, so a test can exercise the rules without a window and a
+ * host with its own router can pass {@link MyListingsAddress} instead.
+ *
+ * ── replace, not push ────────────────────────────────────────────────────
+ *
+ * Switching tab is a READ of your own dashboard, not a step in a flow. A
+ * `pushState` per tab would make Back walk Archive → Drafts → Active before it
+ * left the dashboard at all, which is the history churn `@stapel/search-react`
+ * documents for its own "a filter is a read" decision. `replaceState` keeps
+ * the address shareable and reloadable, which is the whole point, and leaves
+ * Back meaning "the page before this one".
+ */
+import { MY_LISTINGS_TABS } from "./status.js";
+/** The query parameter the tab lives in. */
+export const MY_LISTINGS_TAB_PARAM = "tab";
+/**
+ * The tab a query string names, or `undefined`.
+ *
+ * An unknown value is `undefined` and NOT an error: a link written by hand, a
+ * tab this build has dropped, or a `?tab=` some other component on the page
+ * owns must all fall back to the host's `initialTab` rather than throwing or
+ * opening an empty list.
+ */
+export function tabFromSearch(search) {
+    const value = new URLSearchParams(search).get(MY_LISTINGS_TAB_PARAM);
+    if (value === null)
+        return undefined;
+    return MY_LISTINGS_TABS.find((tab) => tab === value);
+}
+/**
+ * The same query string with the tab written into it.
+ *
+ * Every other parameter is preserved verbatim and in place: the dashboard is
+ * one component on somebody's page, and rewriting an address it does not own
+ * would drop whatever else is in it.
+ */
+export function searchWithTab(search, tab) {
+    const params = new URLSearchParams(search);
+    params.set(MY_LISTINGS_TAB_PARAM, tab);
+    const next = params.toString();
+    return next.length > 0 ? `?${next}` : "";
+}
+/** An address that carries nothing and remembers nothing — SSR, and a host
+ * that opts out. */
+export const NO_ADDRESS = {
+    search: "",
+    setTab: () => undefined,
+};
+/**
+ * The browser's own address, or {@link NO_ADDRESS} where there is no document.
+ *
+ * Read fresh on every call rather than captured: the host's router may have
+ * navigated since this component mounted, and a stale copy would write back
+ * an address that is no longer on screen.
+ */
+export function browserAddress() {
+    if (typeof window === "undefined" || typeof window.history === "undefined") {
+        return NO_ADDRESS;
+    }
+    return {
+        search: window.location.search,
+        setTab: (tab) => {
+            const next = searchWithTab(window.location.search, tab);
+            window.history.replaceState(window.history.state, "", `${window.location.pathname}${next}${window.location.hash}`);
+        },
+    };
+}
+//# sourceMappingURL=tabAddress.js.map

package/dist/model/tabAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabAddress.js","sourceRoot":"","sources":["../../src/model/tabAddress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACrE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,GAAkB;IAC9D,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAaD;oBACoB;AACpB,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAC3E,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,YAAY,CACzB,MAAM,CAAC,OAAO,CAAC,KAAK,EACpB,EAAE,EACF,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAC5D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/llms.txt

@@ -1,4 +1,4 @@
-# @stapel/listings-react 0.25.1
+# @stapel/listings-react 0.25.2
 
 Headless React flow pair for stapel-listings (contract >=0.21 <0.22) — 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.25.1",
+  "version": "0.25.2",
   "backend": {
     "module": "stapel-listings",
     "contract": ">=0.21 <0.22"
@@ -1182,15 +1182,18 @@
       "ListingsRuntimeContext",
       "MODERATION_STATUSES",
       "MY_LISTINGS_TABS",
+      "MY_LISTINGS_TAB_PARAM",
       "MY_LISTINGS_TAB_STATUSES",
       "MY_LISTINGS_UNTABBED_STATUSES",
       "MyListings",
+      "NO_ADDRESS",
       "OWNER_TRANSITIONS",
       "PRICE_FIELD",
       "TITLE_FIELD",
       "asFeatureDaoList",
       "badgePresentation",
       "badgeValueText",
+      "browserAddress",
       "canDelete",
       "canTransition",
       "cardBadgeText",
@@ -1239,7 +1242,9 @@
       "publishRefusal",
       "registerListingsI18n",
       "retainKnownFeatureValues",
+      "searchWithTab",
       "showsDraft",
+      "tabFromSearch",
       "tabOf",
       "unreadableFeatureCount",
       "useArchiveListing",
@@ -1335,6 +1340,7 @@
       "ModerationNotice",
       "MyCounters",
       "MyListingCard",
+      "MyListingsAddress",
       "MyListingsBag",
       "MyListingsParams",
       "MyListingsSource",

package/nav-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/listings-react",
-  "version": "0.25.1",
+  "version": "0.25.2",
   "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": {
@@ -102,13 +102,13 @@
     "size-limit": "^11.2.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@stapel/attributes-react": "^0.16.0",
-    "@stapel/core": "^0.25.1",
+    "@stapel/attributes-react": "^0.16.1",
+    "@stapel/core": "^0.25.2",
     "@stapel/currencies-react": "^0.4.0",
-    "@stapel/showcase": "^0.3.0",
     "@stapel/image": "^0.4.2",
-    "@stapel/tokens": "^0.7.0",
-    "@stapel/tokens-antd": "^0.17.0"
+    "@stapel/showcase": "^0.3.0",
+    "@stapel/tokens": "^0.8.0",
+    "@stapel/tokens-antd": "^0.17.1"
   },
   "engines": {
     "node": ">=22"

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.25.1",
+  "version": "0.25.2",
   "defined": [],
   "flows": []
 }

package/src/default/ListingSerpCard.tsx

@@ -73,6 +73,7 @@
  * has to be re-laid-out the day the projection grows the field. The seam is
  * the honest half; the missing data is written down rather than faked.
  */
+import { Fragment } from "react";
 import type { CSSProperties, ReactElement, ReactNode } from "react";
 import { Card, Flex, Typography, theme as antdTheme } from "antd";
 import { SkinTheme } from "@stapel/tokens-antd/skin";
@@ -141,6 +142,22 @@ export interface ListingSerpCardBaseProps
   /** The seller's name and rating. See the file header for the per-card fetch
    * caveat a container has to avoid. */
   readonly sellerSlot?: ReactNode;
+  /**
+   * Where the seller line sits relative to the place: `"above"` (the default,
+   * and what this card has always drawn) or `"below"`.
+   *
+   * The reference classified — and the host measured against it — reads the
+   * bottom of a card as one descending line of PROVENANCE: what it is, then
+   * where it is, then who is selling it. This card put the seller between the
+   * specs and the place, which reads as part of the description rather than as
+   * the answer to "who am I buying from".
+   *
+   * A prop and not a change, because the order is a surface's decision and
+   * some surfaces genuinely want the seller first — a seller's own page, where
+   * every card has the same one, keeps it out of the way at the bottom, and a
+   * cross-seller feed leads with it. Both stay one line of composition.
+   */
+  readonly sellerSlotPosition?: "above" | "below";
   /** The vertical action column at the trailing edge — call, write. The
    * favourite heart is added at its end by this component. */
   readonly actionsRail?: ReactNode;
@@ -353,18 +370,28 @@ export function ListingSerpCard(props: ListingSerpCardProps): ReactElement {
 
                   {/* Outside the anchor, both of them: a seller line usually holds
                       a link to the seller, and the place is the last thing read
-                      rather than part of what the card is called. */}
-                  {props.sellerSlot ?? null}
+                      rather than part of what the card is called.
 
-                  {listing.location_label !== undefined &&
-                  listing.location_label.length > 0 ? (
-                    <Typography.Text
-                      type="secondary"
-                      data-testid="listings-serp-location"
-                    >
-                      {listing.location_label}
-                    </Typography.Text>
-                  ) : null}
+                      Their ORDER is the surface's — see
+                      `sellerSlotPosition`. Rendered from one array so the two
+                      arms cannot drift into two different pairs of nodes. */}
+                  {(props.sellerSlotPosition === "below"
+                    ? ["location", "seller"]
+                    : ["seller", "location"]
+                  ).map((part) =>
+                    part === "seller" ? (
+                      <Fragment key="seller">{props.sellerSlot ?? null}</Fragment>
+                    ) : listing.location_label !== undefined &&
+                      listing.location_label.length > 0 ? (
+                      <Typography.Text
+                        key="location"
+                        type="secondary"
+                        data-testid="listings-serp-location"
+                      >
+                        {listing.location_label}
+                      </Typography.Text>
+                    ) : null
+                  )}
                 </Flex>
 
                 {rail}

package/src/default/MyListingsPane.tsx

@@ -63,6 +63,7 @@ import { useListingActions } from "../headless/ListingActions.js";
 import { myListingTitle, neverSubmitted } from "../model/mine.js";
 import { listingStatusView } from "../model/status.js";
 import type { MyListingsTab } from "../model/status.js";
+import type { MyListingsAddress } from "../model/tabAddress.js";
 import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
 import { ListingPhoto } from "./ListingPhoto.js";
 import { SignInLink } from "./SignInLink.js";
@@ -358,6 +359,17 @@ export interface MyListingsPaneProps extends ThemeModeProp, SignInCtaProp {
   /** How the host gets the caller's own rows. Absent: the contract's own
    * `GET my/listings/`, which is what a storefront wants. */
   readonly source?: MyListingsSource;
+  /**
+   * Which tab to open when the ADDRESS names none — `?tab=drafts` wins over
+   * it. See `model/tabAddress.ts`.
+   */
+  readonly initialTab?: MyListingsTab;
+  /**
+   * Where the open tab is kept. Default: the browser's own `?tab=`, so
+   * `/account/listings?tab=drafts` opens drafts and a reload keeps it. A host
+   * with a router passes its own binding; `NO_ADDRESS` opts out.
+   */
+  readonly address?: MyListingsAddress;
   /**
    * Open the composer on one of these listings. ABSENT IS A REAL ANSWER: the
    * Edit button then states that this app has no editing screen instead of
@@ -392,9 +404,11 @@ export interface MyListingsPaneProps extends ThemeModeProp, SignInCtaProp {
 export function MyListingsPane(props: MyListingsPaneProps): ReactElement {
   const t = useT();
   const tPlural = useTPlural();
-  const bag = useMyListings(
-    props.source !== undefined ? { source: props.source } : {}
-  );
+  const bag = useMyListings({
+    ...(props.source !== undefined ? { source: props.source } : {}),
+    ...(props.initialTab !== undefined ? { initialTab: props.initialTab } : {}),
+    ...(props.address !== undefined ? { address: props.address } : {}),
+  });
   // ONE confirmation for the whole list, keyed by the row that asked — not one
   // mounted dialog per row.
   const [removingId, setRemovingId] = useState<number | null>(null);
@@ -483,7 +497,7 @@ export function MyListingsPane(props: MyListingsPaneProps): ReactElement {
             label: (
               <>
                 {t(TAB_LABEL[tab])}
-                {matchLoad(bag.counters, {
+                {matchLoad(bag.tabCounts, {
                   loading: () => null,
                   // A count we could not fetch is not zero. The number is
                   // simply absent and the failure is stated once, below.
@@ -492,12 +506,16 @@ export function MyListingsPane(props: MyListingsPaneProps): ReactElement {
                   // danger token and "Active 2" is not a warning. It also
                   // keeps the tab short enough that three of them fit on a
                   // phone instead of collapsing into an overflow menu.
-                  ready: (counters) => (
+                  //
+                  // `tabCounts`, not `counters`: the badge is never allowed to
+                  // read lower than the rows underneath it (D407 — a
+                  // moderator-rejected listing sat in Drafts under a `0`).
+                  ready: (counts) => (
                     <Typography.Text
                       type="secondary"
                       data-testid={`listings-mine-count-${tab}`}
                     >
-                      {` ${String(counters[tab])}`}
+                      {` ${String(counts[tab])}`}
                     </Typography.Text>
                   ),
                 })}

package/src/headless/MyListings.tsx

@@ -22,6 +22,8 @@ import { useMyCounters } from "../model/queries.js";
 import { listingsQueryKeys, pageKey } from "../model/queryKeys.js";
 import { MY_LISTINGS_TABS, MY_LISTINGS_UNTABBED_STATUSES } from "../model/status.js";
 import type { MyListingsTab } from "../model/status.js";
+import { browserAddress, tabFromSearch } from "../model/tabAddress.js";
+import type { MyListingsAddress } from "../model/tabAddress.js";
 import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
 import { useMandateGate } from "./useMandateGate.js";
 
@@ -47,8 +49,26 @@ export interface MyListingsBag {
   readonly tab: MyListingsTab;
   readonly tabs: readonly MyListingsTab[];
   setTab(tab: MyListingsTab): void;
-  /** The three real counts. */
+  /** The three real counts, as the server reports them. */
   readonly counters: LoadState<MyCounters>;
+  /**
+   * The number to DRAW on each tab — the server's counter, raised to what is
+   * actually on screen.
+   *
+   * D407: a moderator-rejected listing was on the Drafts tab under a badge
+   * reading `0`. The two sets are grouped in two places — `my/counters`
+   * aggregates server-side, `MY_LISTINGS_TAB_STATUSES` decides which statuses
+   * a tab ASKS for — and any disagreement between them (a deployment running
+   * an older counter, a status added upstream, a grouping changed on one side)
+   * lands as a badge contradicting the rows underneath it.
+   *
+   * A count smaller than what a person can see is not a count, so the loaded
+   * rows are treated as evidence: for the OPEN tab the number is never below
+   * `rows.length`. It is a floor and not a replacement — the rows are one
+   * keyset page and the counter is the whole set, so the counter still wins
+   * whenever it is the larger of the two.
+   */
+  readonly tabCounts: LoadState<Readonly<Record<MyListingsTab, number>>>;
   /** The rows for the current tab. */
   readonly rows: LoadState<readonly MyListingCard[]>;
   /**
@@ -72,8 +92,23 @@ export interface UseMyListingsOptions {
   /** Replace the contract's own `my/listings` read — a deployment that keeps
    * its sellers' rows somewhere else. Absent: {@link defaultMyListingsSource}. */
   readonly source?: MyListingsSource;
+  /**
+   * Which tab to open when the ADDRESS names none. `?tab=drafts` wins over it
+   * — an address is a person's own statement about what they want to see, and
+   * a default cannot outrank one.
+   */
   readonly initialTab?: MyListingsTab;
   readonly limit?: number;
+  /**
+   * Where the open tab is kept. Default: the browser's own query string
+   * (`?tab=`), which is what makes `/account/listings?tab=drafts` open drafts
+   * and survive a reload — see `model/tabAddress.ts`.
+   *
+   * A host with a router passes its own binding. `NO_ADDRESS` opts out
+   * entirely, for a surface that mounts this hook somewhere the address is not
+   * about it (two dashboards on one page, a preview inside a modal).
+   */
+  readonly address?: MyListingsAddress;
 }
 
 export function useMyListings(
@@ -81,8 +116,13 @@ export function useMyListings(
 ): MyListingsBag {
   const gate = useMandateGate();
   const sessionReady = useActiveSessionReady();
+  // The address is read ONCE, at mount, and written on every change: this is
+  // the initial value of a control the person then operates, not a controlled
+  // input fed by the URL. (A host that navigates its own router to a different
+  // `?tab=` remounts the pane, which is the same thing.)
+  const address = options.address ?? browserAddress();
   const [tab, setTabState] = useState<MyListingsTab>(
-    options.initialTab ?? "active"
+    () => tabFromSearch(address.search) ?? options.initialTab ?? "active"
   );
   const [page, setPage] = useState<MyListingsParams>(
     options.limit !== undefined ? { limit: options.limit } : {}
@@ -130,6 +170,24 @@ export function useMyListings(
 
   const envelope = rowsQuery.data;
 
+  // D407, the floor: never a number smaller than the rows on screen. See
+  // `MyListingsBag.tabCounts`.
+  const tabCounts: LoadState<Readonly<Record<MyListingsTab, number>>> =
+    useMemo(() => {
+      if (counters.status === "error") return loadFailed(counters.error);
+      if (counters.data === undefined) return loadLoading();
+      const server = counters.data;
+      const visible = rows.status === "ready" ? rows.data.length : 0;
+      return loadReady(
+        Object.fromEntries(
+          MY_LISTINGS_TABS.map((one) => [
+            one,
+            one === tab ? Math.max(server[one], visible) : server[one],
+          ])
+        ) as Readonly<Record<MyListingsTab, number>>
+      );
+    }, [counters.status, counters.error, counters.data, rows, tab]);
+
   return {
     tab,
     tabs: MY_LISTINGS_TABS,
@@ -140,6 +198,9 @@ export function useMyListings(
       // down for its own keyset state.
       setPage(options.limit !== undefined ? { limit: options.limit } : {});
       setTabState(next);
+      // …and the address says which list is on screen, so a reload, a
+      // bookmark and a shared link all land on it.
+      (options.address ?? browserAddress()).setTab(next);
     },
     counters:
       counters.status === "error"
@@ -147,6 +208,7 @@ export function useMyListings(
         : counters.data !== undefined
           ? loadReady(counters.data)
           : loadLoading(),
+    tabCounts,
     rows,
     blockedRows,
     page,

package/src/index.ts

@@ -132,6 +132,14 @@ export {
 // ── model: the owner's own rows ──────────────────────────────────────────────
 export { defaultMyListingsSource } from "./model/mineSource.js";
 export type { MyListingsSource } from "./model/mineSource.js";
+export {
+  MY_LISTINGS_TAB_PARAM,
+  NO_ADDRESS,
+  browserAddress,
+  searchWithTab,
+  tabFromSearch,
+} from "./model/tabAddress.js";
+export type { MyListingsAddress } from "./model/tabAddress.js";
 export {
   myListingImages,
   myListingPrice,

package/src/model/tabAddress.ts

@@ -0,0 +1,103 @@
+/**
+ * The dashboard's open tab, IN THE ADDRESS.
+ *
+ * `<MyListingsPane>` kept its tab in component state, which is the same as
+ * keeping it nowhere: `/account/listings?tab=drafts` opened Active, a reload
+ * threw the tab away, and a seller who wanted to send somebody (or themselves,
+ * tomorrow) to their drafts had no address that meant "drafts". "Which of my
+ * three lists am I looking at" is exactly the kind of state a URL is for —
+ * `@stapel/search-react` says the same thing at length about its filters.
+ *
+ * ── Why this module and not a router ─────────────────────────────────────
+ *
+ * This pair carries no router and must not grow one: a package that reached
+ * for `react-router` would be unusable in a Next.js app and vice versa. So the
+ * address is read and written through the two DOM APIs every browser has, and
+ * the whole of that contact is here — three pure functions plus one guarded
+ * read/write pair, so a test can exercise the rules without a window and a
+ * host with its own router can pass {@link MyListingsAddress} instead.
+ *
+ * ── replace, not push ────────────────────────────────────────────────────
+ *
+ * Switching tab is a READ of your own dashboard, not a step in a flow. A
+ * `pushState` per tab would make Back walk Archive → Drafts → Active before it
+ * left the dashboard at all, which is the history churn `@stapel/search-react`
+ * documents for its own "a filter is a read" decision. `replaceState` keeps
+ * the address shareable and reloadable, which is the whole point, and leaves
+ * Back meaning "the page before this one".
+ */
+import { MY_LISTINGS_TABS } from "./status.js";
+import type { MyListingsTab } from "./status.js";
+
+/** The query parameter the tab lives in. */
+export const MY_LISTINGS_TAB_PARAM = "tab";
+
+/**
+ * The tab a query string names, or `undefined`.
+ *
+ * An unknown value is `undefined` and NOT an error: a link written by hand, a
+ * tab this build has dropped, or a `?tab=` some other component on the page
+ * owns must all fall back to the host's `initialTab` rather than throwing or
+ * opening an empty list.
+ */
+export function tabFromSearch(search: string): MyListingsTab | undefined {
+  const value = new URLSearchParams(search).get(MY_LISTINGS_TAB_PARAM);
+  if (value === null) return undefined;
+  return MY_LISTINGS_TABS.find((tab) => tab === value);
+}
+
+/**
+ * The same query string with the tab written into it.
+ *
+ * Every other parameter is preserved verbatim and in place: the dashboard is
+ * one component on somebody's page, and rewriting an address it does not own
+ * would drop whatever else is in it.
+ */
+export function searchWithTab(search: string, tab: MyListingsTab): string {
+  const params = new URLSearchParams(search);
+  params.set(MY_LISTINGS_TAB_PARAM, tab);
+  const next = params.toString();
+  return next.length > 0 ? `?${next}` : "";
+}
+
+/**
+ * The address binding. A host with a router passes its own; absent, the
+ * browser's is used and a non-DOM environment gets one that does nothing.
+ */
+export interface MyListingsAddress {
+  /** The current query string, `?`-prefixed or not — both parse. */
+  readonly search: string;
+  /** Write the tab. See the module note for why this replaces. */
+  setTab(tab: MyListingsTab): void;
+}
+
+/** An address that carries nothing and remembers nothing — SSR, and a host
+ * that opts out. */
+export const NO_ADDRESS: MyListingsAddress = {
+  search: "",
+  setTab: () => undefined,
+};
+
+/**
+ * The browser's own address, or {@link NO_ADDRESS} where there is no document.
+ *
+ * Read fresh on every call rather than captured: the host's router may have
+ * navigated since this component mounted, and a stale copy would write back
+ * an address that is no longer on screen.
+ */
+export function browserAddress(): MyListingsAddress {
+  if (typeof window === "undefined" || typeof window.history === "undefined") {
+    return NO_ADDRESS;
+  }
+  return {
+    search: window.location.search,
+    setTab: (tab) => {
+      const next = searchWithTab(window.location.search, tab);
+      window.history.replaceState(
+        window.history.state,
+        "",
+        `${window.location.pathname}${next}${window.location.hash}`
+      );
+    },
+  };
+}