@stapel/listings-react 0.27.0 → 0.28.0

package/dist/model/draft.d.ts

@@ -98,6 +98,26 @@ export declare function draftValuesFromWire(draft: ListingDraft, options?: Empty
  * is the one place the published values live.
  */
 export declare function draftValuesFromDetail(detail: ListingDetail, featuresDto: FeaturesDto, options?: EmptyDraftOptions): ListingDraftValues;
+/** One field of the `save-draft` body, by the name the wire uses. */
+export type ListingDraftField = keyof ListingDraftPatch;
+/** Options for {@link draftPatchFromValues}. */
+export interface DraftPatchOptions {
+    /**
+     * NAME THE FIELDS THIS SAVE IS WRITING, and the body carries no others.
+     *
+     * `save-draft` REPLACES every field in the body — it does not merge — so a
+     * body is not "the values I have", it is "the fields I am claiming". A save
+     * fired by one control (a photo settling, a blurred title) previously
+     * claimed all fourteen, which is only harmless while every one of them is
+     * loaded and true.
+     *
+     * Given, only these keys are spelled; the omission rules below still apply
+     * inside the selection, so naming `features_draft` without a schema still
+     * writes nothing. Absent, the whole body is sent, which is right for the
+     * composer's own save — it holds every value on the form.
+     */
+    readonly fields?: readonly ListingDraftField[];
+}
 /**
  * The composer's values → the `save-draft` body.
  *
@@ -108,8 +128,29 @@ export declare function draftValuesFromDetail(detail: ListingDetail, featuresDto
  * (`error.400.listing_feature_not_allowed`), which is why
  * {@link retainKnownFeatureValues} prunes on the way in rather than letting
  * the server explain it.
+ *
+ * ── NO SCHEMA IS NOT AN EMPTY ANSWER SHEET ───────────────────────────────
+ *
+ * An absent or empty `features` used to produce `features_draft: {}`, and
+ * `save-draft` REPLACES that map rather than merging into it — so a save that
+ * left before the category's schema arrived DELETED every characteristic the
+ * row was holding, while the form on screen still showed them. Measured by a
+ * live container over two cold loads of one draft: a reopen's own
+ * settled-photo save fires in the first commit, before the row's category has
+ * even been adopted, and the row alternated between the draft's answers and
+ * none of them (a client storefront's README, "Named gaps").
+ *
+ * `{}` is a claim — "this listing has no characteristics" — and a caller with
+ * no schema is in no position to make it. So the key is OMITTED entirely
+ * whenever there is no schema to tag values with, and `save-draft` then
+ * leaves the stored map exactly as it was. A category that genuinely declares
+ * no features writes nothing either, which is the same answer arrived at
+ * honestly: there is nothing to say and the row already says it.
+ *
+ * {@link DraftPatchOptions.fields} is the general form of the same rule — a
+ * save that names what it is writing cannot erase what it is not.
  */
-export declare function draftPatchFromValues(values: ListingDraftValues, features: readonly FeatureDef[]): ListingDraftPatch;
+export declare function draftPatchFromValues(values: ListingDraftValues, features: readonly FeatureDef[] | undefined, options?: DraftPatchOptions): ListingDraftPatch;
 /**
  * The body for CREATING a draft: the category if there is one, `{}` if there
  * is not.

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

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

package/dist/model/draft.js

@@ -126,9 +126,30 @@ function toWireFeatures(features, values) {
  * (`error.400.listing_feature_not_allowed`), which is why
  * {@link retainKnownFeatureValues} prunes on the way in rather than letting
  * the server explain it.
+ *
+ * ── NO SCHEMA IS NOT AN EMPTY ANSWER SHEET ───────────────────────────────
+ *
+ * An absent or empty `features` used to produce `features_draft: {}`, and
+ * `save-draft` REPLACES that map rather than merging into it — so a save that
+ * left before the category's schema arrived DELETED every characteristic the
+ * row was holding, while the form on screen still showed them. Measured by a
+ * live container over two cold loads of one draft: a reopen's own
+ * settled-photo save fires in the first commit, before the row's category has
+ * even been adopted, and the row alternated between the draft's answers and
+ * none of them (a client storefront's README, "Named gaps").
+ *
+ * `{}` is a claim — "this listing has no characteristics" — and a caller with
+ * no schema is in no position to make it. So the key is OMITTED entirely
+ * whenever there is no schema to tag values with, and `save-draft` then
+ * leaves the stored map exactly as it was. A category that genuinely declares
+ * no features writes nothing either, which is the same answer arrived at
+ * honestly: there is nothing to say and the row already says it.
+ *
+ * {@link DraftPatchOptions.fields} is the general form of the same rule — a
+ * save that names what it is writing cannot erase what it is not.
  */
-export function draftPatchFromValues(values, features) {
-    return {
+export function draftPatchFromValues(values, features, options = {}) {
+    const full = {
         // Omitted while unchosen rather than sent as `""`: a draft is allowed to
         // have no category (0.21.4), and `""` is not "no category" on the wire —
         // it is an empty id the serializer refuses. The category is written by
@@ -147,7 +168,11 @@ export function draftPatchFromValues(values, features) {
         // sent here is discarded. Sending one would be a claim the wire ignores.
         lat_draft: values.location.lat,
         lon_draft: values.location.lon,
-        features_draft: toWireFeatures(features, values.features),
+        // Omitted, not emptied, when there is no schema to tag with — see the
+        // doc above. `{}` is a claim about the listing; silence is not.
+        ...(features !== undefined && features.length > 0
+            ? { features_draft: toWireFeatures(features, values.features) }
+            : {}),
         countable: values.countable,
         // The pair mirrors the model's cross-field rule rather than sending a
         // contradiction: a service carries no quantity, and `validate_countable
@@ -155,6 +180,18 @@ export function draftPatchFromValues(values, features) {
         stock_quantity: values.countable ? values.stockQuantity : null,
         auto_republish: values.autoRepublish,
     };
+    const named = options.fields;
+    if (named === undefined)
+        return full;
+    // A selection, not a second body: the field's VALUE is still whatever the
+    // rules above produced, so a named field the rules omit stays omitted.
+    const wanted = new Set(named);
+    const out = {};
+    for (const [key, value] of Object.entries(full)) {
+        if (wanted.has(key))
+            out[key] = value;
+    }
+    return out;
 }
 /**
  * The body for CREATING a draft: the category if there is one, `{}` if there

package/dist/model/draft.js.map

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

package/llms.txt

@@ -1,4 +1,4 @@
-# @stapel/listings-react 0.27.0
+# @stapel/listings-react 0.28.0
 
 Headless React flow pair for stapel-listings (contract >=0.22 <0.23) — 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.27.0",
+  "version": "0.28.0",
   "backend": {
     "module": "stapel-listings",
     "contract": ">=0.22 <0.23"
@@ -1266,6 +1266,7 @@
       "NO_ADDRESS",
       "OWNER_TRANSITIONS",
       "PRICE_FIELD",
+      "SHARE_COARSE_MEDIA",
       "SHARE_COPIED_MS",
       "SHARE_NETWORKS",
       "Share",
@@ -1276,6 +1277,7 @@
       "browserAddress",
       "canDelete",
       "canTransition",
+      "captionName",
       "cardBadgeText",
       "cardBadgeTexts",
       "countedTabOf",
@@ -1301,6 +1303,7 @@
       "flowEndpoints",
       "formatSpecValue",
       "hasCardBadgeContract",
+      "hasCoarsePointer",
       "hasNativeShare",
       "isBatchValid",
       "isListingViewed",
@@ -1321,6 +1324,7 @@
       "navEntries",
       "ownerMoves",
       "pageKey",
+      "preferNativeShare",
       "publishRefusal",
       "registerListingsI18n",
       "resolveShareUrl",
@@ -1373,6 +1377,7 @@
       "ComposeStage",
       "CreateListingsRuntimeOptions",
       "DeleteResponse",
+      "DraftPatchOptions",
       "EmptyDraftOptions",
       "FavoriteInput",
       "FavoriteToggleBag",
@@ -1391,6 +1396,7 @@
       "ListingDetailBag",
       "ListingDetailData",
       "ListingDraft",
+      "ListingDraftField",
       "ListingDraftLimits",
       "ListingDraftPatch",
       "ListingDraftValues",
@@ -1444,6 +1450,7 @@
       "ShareChannel",
       "ShareLink",
       "ShareNetwork",
+      "SharePreference",
       "ShareTarget",
       "UseFavoritesOptions",
       "UseListingActionsOptions",

package/nav-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/listings-react",
-  "version": "0.27.0",
+  "version": "0.28.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": {

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

package/src/default/ListingActions.tsx

@@ -46,7 +46,7 @@ import { Flex, Typography } from "antd";
 import type { SignInCta } from "@stapel/core";
 import { useT } from "@stapel/core";
 import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
-import type { ShareChannel } from "../headless/Share.js";
+import type { ShareChannel, SharePreference } from "../headless/Share.js";
 import { FavoriteHeart } from "./favorite.js";
 import { ShareAction } from "./ShareAction.js";
 import {
@@ -92,6 +92,13 @@ export interface ListingActionsProps {
   readonly shareTitle?: string;
   /** A line under it in the sheet — the price, typically. */
   readonly shareText?: string;
+  /**
+   * Which arm the share control uses — handed straight to
+   * `<ShareAction prefer>`, which is where the reading and its measurement
+   * are written down. Default `"auto"`: the platform sheet on a thumb, this
+   * pair's menu on a mouse.
+   */
+  readonly sharePrefer?: SharePreference;
   readonly onShared?: (channel: ShareChannel) => void;
   /** The container's sign-in door for the heart. */
   readonly signIn?: SignInCta;
@@ -187,6 +194,7 @@ export function ListingActions(props: ListingActionsProps): ReactElement | null
             {...(props.shareUrl !== undefined ? { url: props.shareUrl } : {})}
             {...(props.shareTitle !== undefined ? { title: props.shareTitle } : {})}
             {...(props.shareText !== undefined ? { text: props.shareText } : {})}
+            {...(props.sharePrefer !== undefined ? { prefer: props.sharePrefer } : {})}
             {...(props.onShared !== undefined ? { onShared: props.onShared } : {})}
           />
         ) : null}

package/src/default/ListingDetailPane.tsx

@@ -102,7 +102,7 @@ import { useListingActions } from "../headless/ListingActions.js";
 import { asFeatureDaoList, featureValuesForDisplay } from "../model/features.js";
 import { formatSpecValue } from "../model/featureText.js";
 import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
-import type { ShareChannel } from "../headless/Share.js";
+import type { ShareChannel, SharePreference } from "../headless/Share.js";
 import { GateReasonPopover } from "./GateReasonPopover.js";
 import { ListingActions } from "./ListingActions.js";
 import type { ListingActionsConfig } from "./ListingActions.js";
@@ -271,6 +271,14 @@ export interface ListingDetailPaneProps
    * somebody sends to a friend. See `useShare`.
    */
   readonly shareUrl?: string;
+  /**
+   * Which arm the share control uses — handed to `<ShareAction prefer>`
+   * through the cluster. Default `"auto"`: the platform sheet where the
+   * primary pointer is coarse, this pair's menu on a mouse. See
+   * `SharePreference` for the measurement that made the pointer part of the
+   * question (§25).
+   */
+  readonly sharePrefer?: SharePreference;
   /** Analytics: which channel a completed share went through. */
   readonly onShared?: (channel: ShareChannel) => void;
   /**
@@ -412,6 +420,49 @@ export interface ListingDetailPaneProps
    * Default `3`, byte-compatible for every existing mount.
    */
   readonly headingLevel?: 1 | 2 | 3;
+  /**
+   * WHERE THE BUY COLUMN'S STICKY TOP EDGE IS — the offset of whatever chrome
+   * is pinned above this page (`layout="split"` only; the one-column arm has
+   * no sticky column).
+   *
+   * ```tsx
+   * // the height <PublicShell> publishes, read rather than restated
+   * <ListingDetailPane layout="split" buyTop="var(--stapel-header-height)" />
+   * ```
+   *
+   * The column is `position: sticky; top: 16px` written INLINE, and an inline
+   * declaration is beaten by nothing short of `!important` — so a host with a
+   * pinned header had no way to say "start below it". Measured on the stand
+   * (D456): the storefront's header is sticky and 64px tall, and at any scroll
+   * depth the top of the buy column — the price's own first twenty pixels —
+   * sat UNDER it. Same seam and same argument as `<SearchPage railTop>`, which
+   * this prop is deliberately spelled after.
+   *
+   * A number is pixels; a string is taken as written (a `var()`, a `calc()`,
+   * `"4rem"`). Default `spacing[4]` — 16px, exactly where the column has
+   * always started — so an existing mount is byte-compatible.
+   */
+  readonly buyTop?: number | string;
+  /**
+   * HOW WIDE THE PANE MAY GET — the `max-width` it writes on its own root.
+   *
+   * Default is the constant for the arm on screen: {@link DETAIL_MEASURE}
+   * (60rem) in `"column"`, {@link DETAIL_SPLIT_MEASURE} (75rem) in `"split"`,
+   * so no existing mount changes shape. Anything CSS `max-width` takes is
+   * accepted (`"80rem"`, `1280`, `"100%"`).
+   *
+   * `"none"` removes the cap, and it is the answer for a pane mounted inside
+   * a page frame that already decided the measure. That case is not
+   * hypothetical: measured on the stand at 1440 (D457), the listing page's
+   * content ended at x=1224 with 216px of empty gutter beside it while every
+   * other page of the same site ran to the frame's edge — a second, lower cap
+   * inside a container that already had one. The cap is written INLINE, so
+   * the container could not outrank it without `!important` and reached for
+   * `min-inline-size: 100%` instead (a minimum beats a maximum by the sizing
+   * rules); this prop is that workaround's replacement, and the same seam
+   * `<CategoryPage measure>` already offers.
+   */
+  readonly measure?: number | string;
   readonly footer?: ReactNode;
 }
 
@@ -592,7 +643,7 @@ export function ListingDetailPane(props: ListingDetailPaneProps): ReactElement {
     <SkinTheme
       surface="base"
       style={{
-        maxWidth: split ? DETAIL_SPLIT_MEASURE : DETAIL_MEASURE,
+        maxWidth: props.measure ?? (split ? DETAIL_SPLIT_MEASURE : DETAIL_MEASURE),
         // See `gutter`: a frame that already placed the page edge does not get
         // a second one stacked inside it.
         padding: props.gutter === "shell" ? 0 : spacing[4],
@@ -770,6 +821,9 @@ export function ListingDetailPane(props: ListingDetailPaneProps): ReactElement {
                 {...(listing.title !== undefined && listing.title !== null
                   ? { shareTitle: listing.title }
                   : {})}
+                {...(props.sharePrefer !== undefined
+                  ? { sharePrefer: props.sharePrefer }
+                  : {})}
                 {...(props.onShared !== undefined ? { onShared: props.onShared } : {})}
               />
             );
@@ -1171,7 +1225,7 @@ export function ListingDetailPane(props: ListingDetailPaneProps): ReactElement {
                     data-testid="listings-detail-buy-column"
                     style={{
                       position: "sticky",
-                      top: spacing[4],
+                      top: props.buyTop ?? spacing[4],
                       alignSelf: "start",
                     }}
                   >

package/src/default/ShareAction.tsx

@@ -10,16 +10,22 @@
  *
  * ── One control, two renderings, and the DEVICE picks ─────────────────────
  *
- * Where `navigator.share` exists — which is every phone and almost no desktop
- * — the press opens the PLATFORM's own sheet: the person's own apps, in their
- * own order, including the ones we have never heard of. A library that drew
- * its own list of four networks on a phone would be offering a worse version
- * of something the operating system already does better.
+ * On a device driven with a THUMB the press opens the PLATFORM's own sheet:
+ * the person's own apps, in their own order, including the ones we have never
+ * heard of. A library that drew its own list of four networks on a phone would
+ * be offering a worse version of something the operating system already does
+ * better.
  *
- * Where it does not, the press opens a small menu: copy the link, and the
- * three networks a Russian-speaking marketplace actually receives traffic
- * from. This is the DESKTOP rendering, not a fallback for old browsers, which
- * is why it is built rather than apologised for.
+ * Everywhere else the press opens a small menu: copy the link, and the three
+ * networks a Russian-speaking marketplace actually receives traffic from. This
+ * is the DESKTOP rendering, not a fallback for old browsers, which is why it
+ * is built rather than apologised for.
+ *
+ * The reading that decides is the primary POINTER and not `navigator.share`
+ * alone: desktop Chrome on macOS has the API, so the capability question sent
+ * every desktop share to the OS sheet and left this menu unreachable on the
+ * platform it was written for (§25). {@link ShareActionProps.prefer} is where
+ * a host overrules the reading in either direction.
  *
  * ── The menu is a Popover, and that is an exception with an argument ──────
  *
@@ -60,7 +66,11 @@ import { SkinButton as Button, ErrorAlert } from "@stapel/tokens-antd/skin";
 import { useT } from "@stapel/core";
 import { spacing } from "@stapel/tokens";
 import { useShare } from "../headless/Share.js";
-import type { ShareChannel, ShareNetwork } from "../headless/Share.js";
+import type {
+  ShareChannel,
+  ShareNetwork,
+  SharePreference,
+} from "../headless/Share.js";
 import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
 import {
   LISTING_ACTIONS_STYLE_HREF,
@@ -104,6 +114,21 @@ export interface ShareActionProps {
    * for it.
    */
   readonly shape?: "default" | "circle";
+  /**
+   * WHICH ARM THIS SURFACE WANTS — see {@link SharePreference}.
+   *
+   * Default `"auto"`: the platform sheet where the primary pointer is coarse
+   * AND `navigator.share` exists, this pair's menu everywhere else. The
+   * default changed in this release, and it changed because of a measurement
+   * (§25): desktop Chrome on macOS reports `navigator.share`, so a pair that
+   * asked only the capability opened the OS sheet on the desktop and the
+   * copy-link menu — three networks and a clipboard row, built for exactly
+   * that platform — could not be reached there at all.
+   *
+   * `"native"` restores the capability-only behaviour by name; `"menu"` pins
+   * this pair's menu on every device.
+   */
+  readonly prefer?: SharePreference;
   readonly style?: CSSProperties;
 }
 
@@ -115,6 +140,7 @@ export function ShareAction(props: ShareActionProps): ReactElement {
     url: props.url,
     title: props.title,
     text: props.text,
+    ...(props.prefer !== undefined ? { prefer: props.prefer } : {}),
     ...(props.onShared !== undefined ? { onShared: props.onShared } : {}),
   });
   const label = t(LISTINGS_I18N_KEYS.shareAction);

package/src/default/actionRow.ts

@@ -86,13 +86,62 @@ export const LISTING_ACTION_HIT: number = controls["height-phone"];
  */
 export const LISTING_CARD_ACTION_HIT = 36;
 
+/**
+ * HOW MANY TIMES THE HIT-TARGET CLASS IS REPEATED IN ITS OWN SELECTOR — and
+ * why a repeat rather than a number typed once (D450).
+ *
+ * Measured on the live listing page: the heart and the share glyph were
+ * **32 × 44**, not 44 × 44. The block axis survived and the inline one did
+ * not, because antd's circle shape ships
+ *
+ *   `:where(…).ant-btn.ant-btn-circle.ant-btn{min-width:var(--ant-control-height)}`
+ *
+ * — three classes, specificity (0,3,0), against this sheet's single class
+ * (0,1,0). `:where()` adds nothing, and a media query adds nothing either, so
+ * the only thing that decides is the class count: antd's 32 won and there was
+ * no viewport at which it did not.
+ *
+ * A repeated class is the one way to outrank it without `!important`. Four
+ * repeats — (0,4,0) — clear antd's three with one to spare, and the selector
+ * still matches exactly the same element, so nothing about WHAT the rule
+ * applies to changes. `!important` was refused deliberately: a host that
+ * genuinely wants a different target must be able to say so with a selector,
+ * and this sheet's whole argument (see `movableCluster.tsx`) is that a pair's
+ * geometry should never force one on somebody else.
+ */
+export const LISTING_ACTION_SPECIFICITY = 4;
+
+/** A class name repeated {@link LISTING_ACTION_SPECIFICITY} times — the
+ * selector that beats antd's circle. */
+function outranking(className: string): string {
+  return `.${className}`.repeat(LISTING_ACTION_SPECIFICITY);
+}
+
+/**
+ * The floor, in BOTH spellings of the same axis.
+ *
+ * A browser cascades `min-inline-size` and `min-width` together and keeps the
+ * winner, so in a browser the logical pair alone would be enough once the
+ * selector outranks antd's. The physical pair is written beside it because
+ * the declaration being beaten is spelled physically, and an engine that does
+ * NOT merge the two names (jsdom, where this rule is asserted) would leave
+ * antd's `min-width:32px` standing beside our `min-inline-size:44px` and call
+ * that a pass. Two spellings of one number, and the number has one source.
+ */
+function floor(size: number): string {
+  const px = `${String(size)}px`;
+  return (
+    `min-inline-size:${px};min-block-size:${px};` +
+    `min-width:${px};min-height:${px}`
+  );
+}
+
 export function actionRowCss(): string {
-  const action = `.${LISTING_ACTION_CLASS}`;
-  const cardAction = `.${LISTING_CARD_ACTION_CLASS}`;
+  const action = outranking(LISTING_ACTION_CLASS);
+  const cardAction = outranking(LISTING_CARD_ACTION_CLASS);
   const row = `.${LISTING_ACTIONS_CLASS}`;
   const over = `.${LISTING_ACTIONS_OVERLAY_CLASS}`;
   const label = `.${LISTING_ACTION_LABEL_CLASS}`;
-  const hit = String(LISTING_ACTION_HIT);
   const phone = `(max-width:${String(breakpoints.tablet - 1)}px)`;
   return [
     // The floor. `min-*` rather than `width`/`height`: a share button with a
@@ -100,14 +149,13 @@ export function actionRowCss(): string {
     // `controlHeight` already reaches the height on a phone — this is the
     // guarantee for every OTHER viewport and for a host-registered button
     // that never read the antd token at all.
-    `${action}{min-inline-size:${hit}px;min-block-size:${hit}px;` +
+    `${action}{${floor(LISTING_ACTION_HIT)};` +
       `display:inline-flex;align-items:center;justify-content:center}`,
     // A card's control: one tier smaller where there is a cursor, the same
     // 44px where there is a thumb. See LISTING_CARD_ACTION_HIT.
-    `${cardAction}{min-inline-size:${String(LISTING_CARD_ACTION_HIT)}px;` +
-      `min-block-size:${String(LISTING_CARD_ACTION_HIT)}px;` +
+    `${cardAction}{${floor(LISTING_CARD_ACTION_HIT)};` +
       `display:inline-flex;align-items:center;justify-content:center}`,
-    `@media ${phone}{${cardAction}{min-inline-size:${hit}px;min-block-size:${hit}px}}`,
+    `@media ${phone}{${cardAction}{${floor(LISTING_ACTION_HIT)}}}`,
     // The cluster. `align-items:flex-end` so a blocked heart's reason — the
     // one thing here that can be two lines — stacks against the same edge
     // instead of pushing the controls inwards (the arrangement

package/src/default/index.ts

@@ -155,6 +155,7 @@ export {
   LISTING_ACTION_CLASS,
   LISTING_ACTION_HIT,
   LISTING_ACTION_LABEL_CLASS,
+  LISTING_ACTION_SPECIFICITY,
   LISTING_CARD_ACTION_CLASS,
   LISTING_CARD_ACTION_HIT,
   actionRowCss,