@stapel/listings-react 0.23.0 → 0.25.0

package/dist/model/cardBadges.d.ts

@@ -0,0 +1,134 @@
+/**
+ * The CARD BADGE CONTRACT — what a badge on a result card is allowed to say.
+ *
+ * ── What was on screen ────────────────────────────────────────────────────
+ *
+ * A live card's badge line read "Brick · 3 · 9". Three true facts about a
+ * flat, and two of them unreadable: 3 what, 9 what. The projection carried
+ * the VALUES and the display half printed them, because that is all a stored
+ * `features_badges` row could offer — a number with no unit and no question
+ * beside it.
+ *
+ * stapel-listings 0.21.3 adds the missing half to each element:
+ *
+ *   `value`         the raw answer
+ *   `label`         its resolved copy, where the answer is an option
+ *   `unit`          what the number is measured in
+ *   `name`          the question — the feature's own display name
+ *   `presentation`  which of those to print, decided by the SERVER
+ *
+ * `presentation` is the load-bearing key, and it is the server's decision
+ * rather than a rule guessed here, because the right badge for a value
+ * depends on the CATEGORY: "3 rooms" wants its name, "Brick" is a
+ * boolean whose name IS the badge, "20 000 km" wants its unit and no name at
+ * all, and no client-side heuristic gets all three right for every catalogue
+ * in the fleet.
+ *
+ * ── The four presentations ───────────────────────────────────────────────
+ *
+ *   `value`       the value alone      — "Brick" (an option label)
+ *   `value_unit`  value and unit       — "20 000 km"
+ *   `name_value`  name and value       — "Floor 3": a SPACE and never a colon,
+ *                                        because a card is a caption and not a
+ *                                        form. The unit is kept when the
+ *                                        element carries one — a named row
+ *                                        that dropped it reads "Mileage 20 000"
+ *   `name`        the name alone       — a TRUE boolean, whose whole content
+ *                                        is that the flat is brick. A FALSE
+ *                                        one renders nothing: "not brick" is
+ *                                        not a selling point, and a card is a
+ *                                        summary rather than a form.
+ *
+ * ── Why a local type extension and not a regenerated schema ───────────────
+ *
+ * The generated `FeatureDao` union is already unusable on this side (the
+ * discriminator defect, `api/types.ts`), `features_badges` is a `JSONField`
+ * on the serializer, and this pair reads the row through
+ * {@link ListingFeatureDao} — a hand-written mirror of the runtime shape —
+ * for exactly that reason. The contract is an additive extension of the same
+ * mirror, so a regeneration cannot take it away and an older backend that
+ * sends none of the five keys is simply a row where
+ * {@link hasCardBadgeContract} is false.
+ *
+ * ── The fallback is the whole compatibility story ─────────────────────────
+ *
+ * A row with no `presentation` is a row from a server that predates the
+ * contract, and it is rendered exactly as it is rendered today — through
+ * `@stapel/attributes-react`'s `<FeatureBadges>`, off the stored DAO's own
+ * config. Nothing about this module is required for a card to draw.
+ */
+import type { ListingCardBadgeElement, ListingFeatureDao } from "../api/types.js";
+/**
+ * Which parts of a badge element the server asked to be printed.
+ *
+ * Read off the GENERATED element rather than spelled again here: the four
+ * readings are the server's enum, and a fifth added upstream must turn this
+ * build red instead of falling through {@link badgePresentation}'s default in
+ * silence.
+ */
+export type CardBadgePresentation = ListingCardBadgeElement["presentation"];
+/**
+ * The keys stapel-listings 0.21.3 adds to a `features_badges` /
+ * `features_title` element.
+ *
+ * The NAMES and their types come from the generated element; the optionality
+ * is this pair's own, and is the whole compatibility story — the contract
+ * makes them required, and a server that predates it sends none of them. Same
+ * argument as {@link ListingEngagementFields}, one file over: a generated type
+ * is a promise about the contract, not about the bytes a deployment sends.
+ */
+export type CardBadgeContract = {
+    /** The raw answer. Absent on a redacted row, which is why the renderers
+     * below all tolerate it, and `unknown` because the DAO union types it per
+     * feature type and a badge prints whatever it was given. */
+    readonly value?: unknown;
+} & {
+    readonly [K in "label" | "unit" | "name"]?: ListingCardBadgeElement[K] | null;
+} & {
+    /** Widened back to `string` on purpose: {@link badgePresentation} exists to
+     * REFUSE a reading it does not know, and a field typed as the four would
+     * make that refusal unreachable — and untestable — while a server is still
+     * free to send a fifth. */
+    readonly presentation?: string | null;
+};
+/** A stored badge row, with the contract's keys where the server sends them. */
+export type CardBadgeRow = ListingFeatureDao & CardBadgeContract;
+/**
+ * `presentation` as one of the four, or `undefined`.
+ *
+ * An unrecognised spelling is `undefined` rather than a guess: the whole
+ * point of the key is that the SERVER decided, and a client that invented a
+ * fifth reading would print one category's rule on another category's card.
+ */
+export declare function badgePresentation(row: CardBadgeRow): CardBadgePresentation | undefined;
+/**
+ * Does this projection speak the contract at all?
+ *
+ * ONE row declaring a `presentation` is enough: the server writes the whole
+ * list in one pass, so a mixed list means a row the server deliberately left
+ * plain, and that row still renders (as its value alone) rather than
+ * dragging the other four back to the old path.
+ */
+export declare function hasCardBadgeContract(rows: readonly CardBadgeRow[]): boolean;
+/**
+ * The element's answer, as a person reads it: the server's `label` when there
+ * is one, the value with its digits grouped when it is a number, the value
+ * verbatim otherwise.
+ */
+export declare function badgeValueText(row: CardBadgeRow, locale?: string): string;
+/**
+ * One badge element → the text a card prints, or `undefined` for an element
+ * that has nothing to say (a false boolean, a blank value).
+ *
+ * The one place the four presentations are read. Every card surface calls
+ * this and none of them re-derives it, for the same reason `CardTarget`
+ * exists: three cards each re-deciding what a badge says is three places for
+ * "Brick · 3 · 9" to come back.
+ */
+export declare function cardBadgeText(row: CardBadgeRow, locale?: string): string | undefined;
+/** Every element that has something to say, in the server's order. */
+export declare function cardBadgeTexts(rows: readonly CardBadgeRow[], locale?: string): readonly {
+    readonly slug: string;
+    readonly text: string;
+}[];
+//# sourceMappingURL=cardBadges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cardBadges.d.ts","sourceRoot":"","sources":["../../src/model/cardBadges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAElF;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;gEAE4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,IAAI;CAC9E,GAAG;IACF;;;+BAG2B;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,qBAAqB,GAAG,SAAS,CAYtF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAE3E;AAqBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBzE;AAOD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BpF;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAS7D"}

package/dist/model/cardBadges.js

@@ -0,0 +1,131 @@
+/**
+ * `presentation` as one of the four, or `undefined`.
+ *
+ * An unrecognised spelling is `undefined` rather than a guess: the whole
+ * point of the key is that the SERVER decided, and a client that invented a
+ * fifth reading would print one category's rule on another category's card.
+ */
+export function badgePresentation(row) {
+    const raw = row.presentation;
+    if (typeof raw !== "string")
+        return undefined;
+    switch (raw) {
+        case "value":
+        case "value_unit":
+        case "name_value":
+        case "name":
+            return raw;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Does this projection speak the contract at all?
+ *
+ * ONE row declaring a `presentation` is enough: the server writes the whole
+ * list in one pass, so a mixed list means a row the server deliberately left
+ * plain, and that row still renders (as its value alone) rather than
+ * dragging the other four back to the old path.
+ */
+export function hasCardBadgeContract(rows) {
+    return rows.some((row) => badgePresentation(row) !== undefined);
+}
+/** Trimmed copy, or `""` — `null` is the shape the wire uses for absent. */
+function text(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+/**
+ * How many decimals the wire actually stated.
+ *
+ * A card badge must not invent precision and must not lose it: the server
+ * sends "2.0" for an engine volume and `2` for a number of rooms, and JS
+ * cannot tell `2.0` from `2` once it is a number — so a STRING value keeps
+ * the decimals it was written with and a number keeps its own.
+ */
+function statedDecimals(raw) {
+    const written = typeof raw === "string" ? raw : String(raw);
+    const tail = written.split(".")[1];
+    return tail === undefined ? 0 : tail.replace(/[^0-9]/g, "").length;
+}
+/**
+ * The element's answer, as a person reads it: the server's `label` when there
+ * is one, the value with its digits grouped when it is a number, the value
+ * verbatim otherwise.
+ */
+export function badgeValueText(row, locale) {
+    const label = text(row.label);
+    if (label.length > 0)
+        return label;
+    const raw = row.value;
+    if (raw === null || raw === undefined || raw === "")
+        return "";
+    if (typeof raw === "boolean")
+        return "";
+    const parsed = typeof raw === "number" ? raw : Number(raw);
+    if (typeof raw !== "object" && Number.isFinite(parsed)) {
+        const digits = statedDecimals(raw);
+        try {
+            return new Intl.NumberFormat(locale, {
+                minimumFractionDigits: digits,
+                maximumFractionDigits: digits,
+            }).format(parsed);
+        }
+        catch {
+            return parsed.toFixed(digits);
+        }
+    }
+    return typeof raw === "object" ? "" : String(raw);
+}
+/** Is this element's value the `true` a `name`-presented boolean needs? */
+function isTrue(raw) {
+    return raw === true || raw === 1 || raw === "true";
+}
+/**
+ * One badge element → the text a card prints, or `undefined` for an element
+ * that has nothing to say (a false boolean, a blank value).
+ *
+ * The one place the four presentations are read. Every card surface calls
+ * this and none of them re-derives it, for the same reason `CardTarget`
+ * exists: three cards each re-deciding what a badge says is three places for
+ * "Brick · 3 · 9" to come back.
+ */
+export function cardBadgeText(row, locale) {
+    const presentation = badgePresentation(row);
+    const name = text(row.name);
+    const unit = text(row.unit);
+    if (presentation === "name") {
+        // The name IS the badge, and only while the answer is yes.
+        return isTrue(row.value) && name.length > 0 ? name : undefined;
+    }
+    const value = badgeValueText(row, locale);
+    if (value.length === 0)
+        return undefined;
+    const withUnit = unit.length > 0 ? `${value} ${unit}` : value;
+    switch (presentation) {
+        case "value_unit":
+            return withUnit;
+        case "name_value":
+            // A SPACE, not a colon. "Floor 3" is a caption; "Floor: 3" is a form
+            // field, and a card is neither a form nor a table — the colon is the
+            // punctuation the spec list uses because a spec list IS the table.
+            // The unit rides along: a named row that dropped it reads "Mileage
+            // 20 000", which is the defect this contract exists to close.
+            return name.length > 0 ? `${name} ${withUnit}` : withUnit;
+        default:
+            // `value`, and an element the server left plain in a list that speaks
+            // the contract. The value alone, never the unit — the server said so.
+            return value;
+    }
+}
+/** Every element that has something to say, in the server's order. */
+export function cardBadgeTexts(rows, locale) {
+    const out = [];
+    for (const row of rows) {
+        const printed = cardBadgeText(row, locale);
+        if (printed !== undefined && typeof row.slug === "string" && row.slug.length > 0) {
+            out.push({ slug: row.slug, text: printed });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=cardBadges.js.map

package/dist/model/cardBadges.js.map

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

package/dist/model/draft.d.ts

@@ -111,15 +111,23 @@ export declare function draftValuesFromDetail(detail: ListingDetail, featuresDto
  */
 export declare function draftPatchFromValues(values: ListingDraftValues, features: readonly FeatureDef[]): ListingDraftPatch;
 /**
- * The body for CREATING a draft: `category_id` and nothing else.
+ * The body for CREATING a draft: the category if there is one, `{}` if there
+ * is not.
  *
  * `perform_create` forces `owner` and `status`, and everything else has a
  * model default, so a create that also carried the form's current contents
  * would be a second write of data the very next `save-draft` sends anyway —
  * and would fail the whole submission on a field the person could still fix.
  * Create the row, then save into it.
+ *
+ * `{}` IS a valid create body since stapel-listings 0.21.4 made `category_id`
+ * nullable on a draft: a draft may exist before its category is chosen, and
+ * `publish` is where the category becomes mandatory (`publish_validation
+ * _failed` naming `category_id`). Not being able to create the row first is
+ * what left an analysis job addressed by the draft id with no id to start
+ * from (D261).
  */
-export declare function createDraftBody(categoryId: string): ListingDraftPatch;
+export declare function createDraftBody(categoryId?: string): ListingDraftPatch;
 /**
  * Switching category: keep the answers whose slug the new schema also
  * declares, drop the rest.

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

@@ -72,7 +72,11 @@ export function draftValuesFromWire(draft, options = {}) {
 export function draftValuesFromDetail(detail, featuresDto, options = {}) {
     const base = emptyDraftValues(options);
     return {
-        categoryId: detail.category_id,
+        // `text()` for the same reason as the draft seed above: 0.21.4 answers
+        // `category_id: null` for a row created before its category was chosen,
+        // and a seed that took it verbatim put `null` where a string is declared
+        // and crashed the first control that measured its length.
+        categoryId: text(detail.category_id),
         title: text(detail.title),
         description: text(detail.description),
         price: text(detail.price),
@@ -125,7 +129,11 @@ function toWireFeatures(features, values) {
  */
 export function draftPatchFromValues(values, features) {
     return {
-        category_id: values.categoryId,
+        // 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
+        // whichever save follows the pick.
+        ...(values.categoryId.length > 0 ? { category_id: values.categoryId } : {}),
         title_draft: values.title,
         description_draft: values.description,
         price_draft: values.price.length > 0 ? values.price : null,
@@ -149,16 +157,26 @@ export function draftPatchFromValues(values, features) {
     };
 }
 /**
- * The body for CREATING a draft: `category_id` and nothing else.
+ * The body for CREATING a draft: the category if there is one, `{}` if there
+ * is not.
  *
  * `perform_create` forces `owner` and `status`, and everything else has a
  * model default, so a create that also carried the form's current contents
  * would be a second write of data the very next `save-draft` sends anyway —
  * and would fail the whole submission on a field the person could still fix.
  * Create the row, then save into it.
+ *
+ * `{}` IS a valid create body since stapel-listings 0.21.4 made `category_id`
+ * nullable on a draft: a draft may exist before its category is chosen, and
+ * `publish` is where the category becomes mandatory (`publish_validation
+ * _failed` naming `category_id`). Not being able to create the row first is
+ * what left an analysis job addressed by the draft id with no id to start
+ * from (D261).
  */
 export function createDraftBody(categoryId) {
-    return { category_id: categoryId };
+    return categoryId !== undefined && categoryId.length > 0
+        ? { category_id: categoryId }
+        : {};
 }
 /**
  * Switching category: keep the answers whose slug the new schema also

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/dist/model/featureText.d.ts

@@ -0,0 +1,85 @@
+/**
+ * A stored feature value as a person READS it — with its unit, and with its
+ * digits grouped the way the reader's locale groups them.
+ *
+ * ── What was on screen ────────────────────────────────────────────────────
+ *
+ * Measured on the live listing page: "Power 173", "Mileage 20000", "Engine
+ * volume 2.0". Three defects in three rows:
+ *
+ *  - **no unit.** 173 what. 20000 what. A spec row whose value is a bare
+ *    number is a row a buyer has to guess at, and mileage is the single
+ *    number a used-car buyer decides on;
+ *  - **no digit grouping.** `20000` is read digit by digit; "20 000" is read
+ *    at a glance. `formatFeatureValue`'s integer branch is `String(value)`
+ *    (attributes-react `src/format.ts:196`), deliberately — it mirrors the
+ *    engine's own `str(value)` — and the engine renders for a machine-read
+ *    API, not for a spec table;
+ *  - **the wrong decimal mark.** `2.0` in a Russian storefront. The engine
+ *    writes `toFixed`, which is invariant by construction.
+ *
+ * ── Where the unit comes from ─────────────────────────────────────────────
+ *
+ * There is NO generic `unit` key anywhere in this fleet's feature contract —
+ * not on `FeatureDef` (`stapel-attributes/base.py:154-208`), not on
+ * `IntConfig`/`FloatConfig` (`attributes-react/src/generated/featureDef.ts:163`),
+ * not on the stored DAO. The unit of an `int`/`float` IS its `postfix`, free
+ * text on the type's config, with `postfix1000` as the abbreviated unit the
+ * engine switches to at a thousand. `convertible_unit` is the one type with
+ * real unit semantics (`unitType`/`unit_m`/`unit_i`), and its own formatter
+ * already appends the resolved code — so this module leaves it alone.
+ *
+ * So "render the unit from the definition" means: read `postfix`. It reaches
+ * a display surface two ways, and `model/features.ts` now tries both — the
+ * stored row's own config first (`dto_to_dao` copies `postfix` at write
+ * time), then the CATEGORY's definition of the same slug, which is the path
+ * that repairs every listing published before a catalogue gained its units.
+ *
+ * ── Why the whole formatter is not delegated ──────────────────────────────
+ *
+ * `formatFeatureValue` is the fleet's one formatter and stays it: every type
+ * but `int` and `float` goes straight through it, untouched. The two numeric
+ * types are intercepted because the change is not a different ANSWER, it is
+ * the same answer typeset — same value, same precision rule, same
+ * `postfix1000` switch at a thousand, same translated unit, with the digits
+ * run through `Intl.NumberFormat` instead of `String()`.
+ *
+ * ── Which numbers are grouped, and which are not (D307) ────────────────────
+ *
+ * Grouping every number is how a card came to read "2 024" for a model year.
+ * A year is not a quantity: it is an identifier spelled in digits, and so is
+ * a house number, a floor, a room count. Grouping them is not a nicety
+ * applied too widely, it is the wrong reading.
+ *
+ * The rule is the one fact the catalogue already states, plus a magnitude no
+ * identifier reaches:
+ *
+ *  - a feature that carries a UNIT (`prefix`, `postfix`, `postfix1000`) is a
+ *    measurement — "20 000 km", "173 hp", "42 m²" — and is grouped;
+ *  - a unitless value is grouped only from 10 000 up. A year is four digits
+ *    for the next eight thousand of them and a count of doors is one, so the
+ *    threshold sorts years from counts WITHOUT a "does this slug look like a
+ *    year" heuristic — which is guesswork the moment a deployment names the
+ *    slug in its own language.
+ *
+ * Grouping is switched off through `Intl` rather than around it, so a unitless
+ * float still gets the reader's DECIMAL MARK ("2,5", not "2.5"): the two are
+ * separate defects and only one of them is being repaired here.
+ */
+import type { FeatureDef, FeatureValueDto, FormatOptions } from "@stapel/attributes-react";
+/**
+ * The unit a numeric feature is measured in, as the reader sees it — or `""`.
+ *
+ * `postfix1000` when the engine's own thousand switch applies, `postfix`
+ * otherwise, so the unit and the number can never disagree about scale.
+ */
+export declare function featureUnit(feature: FeatureDef, dto: FeatureValueDto | undefined, options?: FormatOptions): string;
+/**
+ * A stored value as a spec row prints it: `formatFeatureValue` for every type
+ * but the two numeric ones, which are typeset here instead.
+ *
+ * Signature-compatible with `formatFeatureValue` on purpose — a surface
+ * swaps one for the other and nothing else changes.
+ */
+export declare function formatSpecValue(feature: FeatureDef, dto: FeatureValueDto | undefined, options?: FormatOptions): string | undefined;
+//# sourceMappingURL=featureText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"featureText.d.ts","sourceRoot":"","sources":["../../src/model/featureText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+B3F;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAOR;AAoHD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,GAAG,SAAS,CAOpB"}

package/dist/model/featureText.js

@@ -0,0 +1,153 @@
+import { featureConfig, featureType, formatFeatureValue } from "@stapel/attributes-react";
+/** The engine's own defaults (`types/int/type.py`, `types/float/type.py`). */
+const DEFAULT_DIGITS = {
+    int: 1,
+    float: 2,
+};
+function str(value) {
+    return typeof value === "string" ? value : "";
+}
+/**
+ * A config string the engine declares to be a translation key, resolved.
+ *
+ * `prefix`/`postfix`/`postfix1000` are collected by upstream's
+ * `get_translation_keys` unconditionally, so they go through the host's
+ * catalogue exactly as `formatFeatureValue` sends them — a Russian storefront
+ * was reading "L" and "each" off its own spec table before that landed, and
+ * this path must not reintroduce it.
+ */
+function translated(options, raw) {
+    const text = str(raw);
+    if (text.length === 0)
+        return "";
+    const t = options?.t;
+    if (t === undefined)
+        return text;
+    const resolved = t(text);
+    return resolved.length > 0 ? resolved : text;
+}
+/**
+ * The unit a numeric feature is measured in, as the reader sees it — or `""`.
+ *
+ * `postfix1000` when the engine's own thousand switch applies, `postfix`
+ * otherwise, so the unit and the number can never disagree about scale.
+ */
+export function featureUnit(feature, dto, options) {
+    const type = featureType(feature);
+    if (type !== "int" && type !== "float")
+        return "";
+    const config = featureConfig(feature);
+    const parsed = Number(dto?.value);
+    const big = str(config["postfix1000"]).length > 0 && Number.isFinite(parsed) && Math.abs(parsed) >= 1000;
+    return translated(options, config[big ? "postfix1000" : "postfix"]);
+}
+/**
+ * `Intl.NumberFormat` for one value, or `undefined` when the runtime has no
+ * `Intl` for this locale to offer.
+ *
+ * A bad BCP-47 tag throws `RangeError`, and a spec table that renders nothing
+ * because a host passed `"en_US"` would be a worse outcome than an ungrouped
+ * number — so the caller falls back rather than the page failing.
+ */
+function localized(value, digits, locale, useGrouping) {
+    try {
+        return new Intl.NumberFormat(locale, {
+            minimumFractionDigits: digits,
+            maximumFractionDigits: digits,
+            useGrouping,
+        }).format(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Digits below which a unitless number is an identifier rather than a
+ * quantity — see the module header. */
+const GROUPING_FLOOR = 10_000;
+/**
+ * Does this feature measure something?
+ *
+ * The RAW config, not the translated unit: whether a value is a measurement
+ * is a fact about the catalogue, and it must not change because a host's
+ * message catalogue happens to resolve a unit key to an empty string.
+ */
+function hasUnit(config) {
+    return (str(config["prefix"]).length > 0 ||
+        str(config["postfix"]).length > 0 ||
+        str(config["postfix1000"]).length > 0);
+}
+/**
+ * The one numeric row, typeset — see the module header for what each piece
+ * is repairing.
+ *
+ * Returns `undefined` for a value that is not a number, so the caller falls
+ * back to the shared formatter and an unreadable row keeps saying so.
+ */
+function formatNumeric(feature, dto, kind, options) {
+    // `Number(null)` is 0 and `Number("")` is 0, so a blank row would render as
+    // a confident zero. The shared formatter's own `isBlank` gate is upstream of
+    // this branch and must be restated here rather than assumed.
+    const raw = dto.value;
+    if (raw === null || raw === undefined || raw === "")
+        return undefined;
+    const parsed = typeof raw === "number" ? raw : Number(raw);
+    if (!Number.isFinite(parsed))
+        return undefined;
+    const config = featureConfig(feature);
+    const precision = config["precision"];
+    const digits = typeof precision === "number" && precision >= 0 ? precision : DEFAULT_DIGITS[kind];
+    const prefix = translated(options, config["prefix"]);
+    const postfix1000 = str(config["postfix1000"]);
+    // The engine switches unit AND scale at exactly a thousand
+    // (`format_value`: `value / 1000`, trailing zeros stripped, `postfix1000`
+    // as the unit). Grouping a scaled number is harmless and keeps one code
+    // path; the trailing-zero strip is the engine's, done on the plain digits
+    // before the locale ever sees them, because "1.50" and "1,5" are the same
+    // decision made in two places.
+    if (postfix1000.length > 0 && Math.abs(parsed) >= 1000) {
+        const scaled = Number((parsed / 1000).toFixed(digits));
+        const body = localized(scaled, decimalsOf(scaled, digits), options?.locale, true) ??
+            String(scaled);
+        return join(prefix, body, translated(options, postfix1000));
+    }
+    // `precision` drives ONLY the scaled branch of an int — the engine's plain
+    // branch is `str(value)`, and an integer never grows a decimal tail
+    // whatever the config says (D26: a live category shipped `precision: 1` on
+    // a year field and the card read "2024.0").
+    const value = kind === "int" ? Math.trunc(parsed) : parsed;
+    const fraction = kind === "int" ? 0 : digits;
+    // A measurement is grouped; a unitless number is an identifier until it is
+    // too big to be one (D307 — the card read "2 024" for a model year).
+    const group = hasUnit(config) || Math.abs(value) >= GROUPING_FLOOR;
+    const body = localized(value, fraction, options?.locale, group) ?? value.toFixed(fraction);
+    return join(prefix, body, translated(options, config["postfix"]));
+}
+/** How many decimals a scaled value actually has, capped at the configured
+ * precision — the engine's `.rstrip('0').rstrip('.')`, expressed as a count
+ * so `Intl` can do the rendering. */
+function decimalsOf(value, cap) {
+    const tail = value.toFixed(cap).split(".")[1] ?? "";
+    return tail.replace(/0+$/, "").length;
+}
+/** `prefix` + body + unit, with the single space the engine puts between a
+ * number and its unit and no space at all where there is no unit. */
+function join(prefix, body, unit) {
+    return unit.length > 0 ? `${prefix}${body} ${unit}` : `${prefix}${body}`;
+}
+/**
+ * A stored value as a spec row prints it: `formatFeatureValue` for every type
+ * but the two numeric ones, which are typeset here instead.
+ *
+ * Signature-compatible with `formatFeatureValue` on purpose — a surface
+ * swaps one for the other and nothing else changes.
+ */
+export function formatSpecValue(feature, dto, options) {
+    const type = featureType(feature);
+    if (dto !== undefined && (type === "int" || type === "float")) {
+        const typeset = formatNumeric(feature, dto, type, options);
+        if (typeset !== undefined)
+            return typeset;
+    }
+    return formatFeatureValue(feature, dto, options);
+}
+//# sourceMappingURL=featureText.js.map