@stapel/attributes-react 0.1.0

package/README.md

@@ -0,0 +1,123 @@
+# @stapel/attributes-react
+
+The React value layer for `stapel-attributes`' dynamic feature types: draw an
+attribute, check it, submit it, display it.
+
+## The axis — `config.type`, not `FormField.kind`
+
+`stapel-attributes` has **two** field vocabularies, and mixing them up is the
+one mistake this package exists to prevent:
+
+| | vocabulary | who reads it |
+|---|---|---|
+| `FormField.kind` | the field kinds of the **admin form that configures a type** (`config_form.py`; `GET /forms/api/v1/field-kinds`) | [`@stapel/forms-react`](../forms-react) |
+| `config["type"]` | the **value type** — `string`, `int`, `float`, `bool`, `select`, `date`, `header`, `hex_color`, `hierarchical_select`, `convertible_unit` | **this package** |
+
+A person filling in a listing edits the second one. A useful consequence: a
+storefront needs **no catalogue endpoint** for these types — the type arrives
+in the data, on every feature that
+`GET /categories/api/v1/categories/{id}/features/` returns.
+
+## What kind of package this is
+
+**L0, not a pair** — modelled on [`@stapel/image`](../image): no client, no
+queries, no generated `schema.ts`. Its backend counterpart is an L1 library
+with no HTTP surface at all (no models, no views, no urls), so there is no
+`/attributes/api/v1/` to pair with and nothing for `pnpm gen:api` to read.
+Feature definitions and validation verdicts reach a browser inside the
+responses of the modules that own them (categories, listings), and those pairs
+depend on this one to draw and check what they carry.
+
+The builtin type set and the `ValidationErrorCode` vocabulary are pinned
+against the engine's own generated corpora
+(`stapel-attributes/tests/golden/{declarations,error_codes}.json`) by
+`test/contract.test.ts` — always against the committed fixture, and
+additionally against the live checkout when one is present.
+
+## The ladder
+
+```
+explicit registerValueEditor(type, …)   ← a host's, always wins
+→ BUILTIN_VALUE_EDITORS                 ← /default's antd editors, ten types
+→ <UnsupportedValueEditor/>             ← loud, never a skipped field
+```
+
+…and, while an undrawable feature is on screen, `unsupportedTypeGate` blocks
+the submit **with the reason named**. That last rung is the point: a category
+can legally carry a type this build has no editor for, and drawing nothing
+would silently drop a feature that may be MANDATORY — the person would submit
+a listing they could not complete and be told, by the server, that an
+attribute they never saw is missing.
+
+```tsx
+import {
+  featureErrorsBySlug, mirrorValidate, toFeaturesDto, unsupportedTypeGate,
+} from "@stapel/attributes-react";
+import { BUILTIN_VALUE_EDITOR_TYPES, FeatureFields } from "@stapel/attributes-react/default";
+
+const gate = unsupportedTypeGate(features, BUILTIN_VALUE_EDITOR_TYPES);
+const errors = featureErrorsBySlug(mirrorValidate(features, toFeaturesDto(features, values)));
+
+<FeatureFields features={features} values={values} onChange={setValue} errors={errors} />;
+<Button disabled={!gate.available}>…</Button>
+```
+
+Adding a type your backend registered through `EXTRA_TYPES` takes one line at
+startup:
+
+```tsx
+registerValueEditor("size_grid", SizeGridEditor);
+```
+
+## The mirror
+
+`mirrorValidate(features, dto)` returns the server's own
+`ValidationBatchResult` shape, built from the same rules and reporting the
+same `error.400.feature_*` keys — so a "too long" caught locally and one
+caught by the server render the same sentence. It is feedback, never a
+verdict: `POST /categories/{pk}/validate-dto/` and
+`POST /listings/{pk}/publish/` decide.
+
+Two contract details it gets right on purpose, both from
+`stapel-attributes/MODULE.md` §"Pattern contract":
+
+- `pattern` matches the **whole** value (`re.fullmatch`), not a prefix.
+- string length is counted in Unicode **code points** on both sides — five
+  emoji are five characters, not ten.
+
+And two places it deliberately stands down, because a mirror that refuses what
+the server accepts blocks a valid submit:
+
+- a value type it does not know (it may be a perfectly good `EXTRA_TYPES`
+  registration whose rules live only in Python) — it still checks
+  mandatory/empty, which is type-independent;
+- `convertible_unit`'s range, whose `min`/`max` are in the unit family's base
+  unit and whose conversion table is server-side. The number and the unit code
+  ARE checked.
+
+## Value shapes that are not what you would guess
+
+Three of the ten types do not carry a bare scalar, and every one of them is a
+submit that fails silently if you assume otherwise:
+
+| type | wire value |
+|---|---|
+| `select` | **always a list**, even when `maxSelected: 1` |
+| `date` | a **Unix timestamp (integer)**, not an ISO string |
+| `hex_color` | an **object** `{simple, hex?, label?}` where `simple` is required and drawn from eighteen colour categories |
+| `convertible_unit` | an **object** `{value, unit}` — the number as typed, tagged with the unit; the server converts |
+
+`toFeaturesDto` builds the `{slug: {type, value}}` envelope from a plain
+`{slug: value}` map, tagging each entry from the FEATURE's config (never from
+the editor — the engine overrides a client-sent `type` anyway) and dropping
+headers, untyped rows and blanks.
+
+## Display
+
+`formatFeatureValue` is React-free and lives in the main entry, so a result
+card can format a value without pulling antd in. `/default` adds
+`<FeatureBadges/>` (the `show_as_badge` values as tags) and
+`<FeatureValueList/>` (the whole spec table). Both keep the two absences
+apart: "not specified" for a value nobody entered, and a named notice for a
+type this build cannot read — an empty cell would claim the first when it
+means the second.

package/dist/default/FeatureBadges.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The DISPLAY half — `<FeatureBadges/>` for a card, `<FeatureValueList/>` for
+ * a detail page. Both are renderers over `formatFeatureValue`; neither
+ * re-implements a single type's formatting.
+ *
+ * Two rules they hold that a naive spec table does not:
+ *
+ *  - **An unreadable value says so.** A type this build cannot format renders
+ *    a named notice, not an empty cell — the display twin of the unsupported
+ *    editor. A blank cell where a spec line belongs reads as "this listing
+ *    has no engine size", which is a different and false statement.
+ *  - **`show_as_badge` / `show_at_title` are the CATEGORY's decision**, made
+ *    by whoever configured the feature, and this component honours it instead
+ *    of picking its own first three values.
+ */
+import type { ReactElement } from "react";
+import type { FeatureDef, FeaturesDto } from "../types.js";
+export interface FeatureDisplayProps {
+    readonly features: readonly FeatureDef[];
+    /** The stored values, in the same `{slug: {type, value}}` envelope the
+     * composer submitted. */
+    readonly values: FeaturesDto;
+}
+/**
+ * The `show_as_badge` values, as antd `Tag`s — what a result card shows under
+ * a title. Features with no value are omitted here (a card is a summary, and
+ * "not specified" is not a selling point); the detail list below says it
+ * explicitly instead.
+ */
+export declare function FeatureBadges(props: FeatureDisplayProps): ReactElement;
+/** Every feature and its value — the spec table of a detail page. */
+export declare function FeatureValueList(props: FeatureDisplayProps): ReactElement;
+//# sourceMappingURL=FeatureBadges.d.ts.map

package/dist/default/FeatureBadges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureBadges.d.ts","sourceRoot":"","sources":["../../src/default/FeatureBadges.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC;6BACyB;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAiDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAgBtE;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAoBzE"}

package/dist/default/FeatureBadges.js

@@ -0,0 +1,56 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { Descriptions, Flex, Tag, Typography } from "antd";
+import { useI18n, useT } from "@stapel/core";
+import { featureName, featureType } from "../types.js";
+import { formatFeatureValue, hexColorSwatch } from "../format.js";
+import { ATTRIBUTES_I18N_KEYS } from "../i18n/keys.js";
+/** Feature + its formatted value, in the order the category declared. */
+function useRows(props, only) {
+    const t = useT();
+    const { locale } = useI18n();
+    return props.features
+        .filter((feature) => featureType(feature) !== "header")
+        .filter((feature) => (only ? only(feature) : true))
+        .map((feature) => {
+        const dto = props.values[feature.slug];
+        return {
+            feature,
+            text: formatFeatureValue(feature, dto, { t, locale }),
+            swatch: featureType(feature) === "hex_color" ? hexColorSwatch(dto) : undefined,
+        };
+    });
+}
+/** A row's value, or the named reason there is none. */
+function ValueText(props) {
+    const t = useT();
+    if (props.text !== undefined)
+        return _jsx(_Fragment, { children: props.text });
+    const type = featureType(props.feature);
+    // Two different absences, said differently: nothing was entered, versus
+    // something was entered that this build cannot read.
+    if (!props.hasValue || type === undefined) {
+        return (_jsx(Typography.Text, { type: "secondary", children: t(ATTRIBUTES_I18N_KEYS.valueNotSet) }));
+    }
+    return (_jsx(Typography.Text, { type: "warning", "data-testid": "attributes-unreadable-value", children: t(ATTRIBUTES_I18N_KEYS.valueUnreadable, { type }) }));
+}
+/**
+ * The `show_as_badge` values, as antd `Tag`s — what a result card shows under
+ * a title. Features with no value are omitted here (a card is a summary, and
+ * "not specified" is not a selling point); the detail list below says it
+ * explicitly instead.
+ */
+export function FeatureBadges(props) {
+    const rows = useRows(props, (feature) => feature.show_as_badge === true);
+    const shown = rows.filter((row) => row.text !== undefined);
+    return (_jsx(Flex, { gap: 4, wrap: true, "data-testid": "attributes-badges", children: shown.map((row) => (_jsx(Tag, { ...(row.swatch ? { color: row.swatch } : {}), "data-testid": `attributes-badge-${row.feature.slug}`, children: row.text }, row.feature.slug))) }));
+}
+/** Every feature and its value — the spec table of a detail page. */
+export function FeatureValueList(props) {
+    const rows = useRows(props);
+    return (_jsx(Descriptions, { column: 1, size: "small", "data-testid": "attributes-value-list", items: rows.map((row) => ({
+            key: row.feature.slug,
+            label: featureName(row.feature),
+            children: (_jsx(ValueText, { feature: row.feature, text: row.text, hasValue: props.values[row.feature.slug] !== undefined })),
+        })) }));
+}
+//# sourceMappingURL=FeatureBadges.js.map

package/dist/default/FeatureBadges.js.map

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

package/dist/default/FeatureFields.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `<FeatureFields/>` — a category's features, drawn as antd form rows, and
+ * the place the three-rung ladder is actually executed.
+ *
+ * It holds no state and owns no submit: values and errors come in, changes go
+ * out. That is what lets the composer that DOES own the submit
+ * (listings-react) keep one source of truth for a draft, and what lets this
+ * component be dropped into any form — a filter panel, an admin preview —
+ * without dragging a mutation along.
+ */
+import type { ReactElement, ReactNode } from "react";
+import type { FlowError } from "@stapel/core";
+import type { FeatureDef } from "../types.js";
+/** Stable per-feature DOM id, so `<label for>` reaches the control. Slugs are
+ * `[a-z0-9_]`-shaped by the engine, so this needs no further escaping. */
+export declare function featureControlId(slug: string): string;
+export interface UnsupportedValueEditorProps {
+    readonly feature: FeatureDef;
+}
+/**
+ * The loud last rung. NOT a skipped field: a category can legally carry a
+ * type this build has no editor for, and drawing nothing would silently drop
+ * a feature that may be mandatory — the person would submit a listing they
+ * could not complete and be told, by the server, that an attribute they never
+ * saw is missing.
+ */
+export declare function UnsupportedValueEditor(props: UnsupportedValueEditorProps): ReactElement;
+export interface FeatureFieldsProps {
+    readonly features: readonly FeatureDef[];
+    /** Current answers keyed by slug. The DTO envelope is built at submit time
+     * with `toFeaturesDto`, not held here. */
+    readonly values: Readonly<Record<string, unknown>>;
+    onChange(slug: string, value: unknown): void;
+    /** Refusals keyed by slug — mirrored or from the server, folded through
+     * `featureErrorsBySlug` either way. */
+    readonly errors?: Readonly<Record<string, FlowError>>;
+    /** True while a submit is in flight — every editor goes read-only. */
+    readonly disabled?: boolean;
+    /** Rendered instead of a default `Form.Item` row, for a host with its own
+     * field chrome. */
+    readonly renderRow?: (row: FeatureRowProps) => ReactNode;
+}
+export interface FeatureRowProps {
+    readonly feature: FeatureDef;
+    readonly controlId: string;
+    readonly control: ReactNode;
+    readonly error: FlowError | undefined;
+    readonly required: boolean;
+}
+/** A category's features as form rows, each drawn by the ladder's winner. */
+export declare function FeatureFields(props: FeatureFieldsProps): ReactElement;
+//# sourceMappingURL=FeatureFields.d.ts.map

package/dist/default/FeatureFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureFields.d.ts","sourceRoot":"","sources":["../../src/default/FeatureFields.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C;0EAC0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,YAAY,CAgBd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC;8CAC0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C;2CACuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;uBACmB;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAsBD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAqCrE"}

package/dist/default/FeatureFields.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Alert, Form } from "antd";
+import { useFormatFlowError, useT } from "@stapel/core";
+import { featureName, featureType } from "../types.js";
+import { resolveValueEditor } from "../registry.js";
+import { BUILTIN_VALUE_EDITORS } from "./editors.js";
+import { ATTRIBUTES_I18N_KEYS } from "../i18n/keys.js";
+/** Stable per-feature DOM id, so `<label for>` reaches the control. Slugs are
+ * `[a-z0-9_]`-shaped by the engine, so this needs no further escaping. */
+export function featureControlId(slug) {
+    return `attributes-field-${slug}`;
+}
+/**
+ * The loud last rung. NOT a skipped field: a category can legally carry a
+ * type this build has no editor for, and drawing nothing would silently drop
+ * a feature that may be mandatory — the person would submit a listing they
+ * could not complete and be told, by the server, that an attribute they never
+ * saw is missing.
+ */
+export function UnsupportedValueEditor(props) {
+    const t = useT();
+    const type = featureType(props.feature);
+    return (_jsx(Alert, { type: "warning", showIcon: true, "data-testid": "attributes-unsupported-type", message: featureName(props.feature), description: type === undefined
+            ? t(ATTRIBUTES_I18N_KEYS.untypedFeature)
+            : t(ATTRIBUTES_I18N_KEYS.unsupportedType, { type }) }));
+}
+function FeatureRow(props) {
+    const format = useFormatFlowError();
+    // A header is a caption: no label, no colon, no required marker — rendering
+    // one inside a labelled Form.Item would make a section heading look like a
+    // question.
+    if (featureType(props.feature) === "header") {
+        return _jsx(Form.Item, { style: { marginBottom: 8 }, children: props.control });
+    }
+    return (_jsx(Form.Item, { label: featureName(props.feature), htmlFor: props.controlId, required: props.required, ...(props.error ? { validateStatus: "error", help: format(props.error) } : {}), children: props.control }));
+}
+/** A category's features as form rows, each drawn by the ladder's winner. */
+export function FeatureFields(props) {
+    const errors = props.errors ?? {};
+    return (_jsx(_Fragment, { children: props.features.map((feature) => {
+            const controlId = featureControlId(feature.slug);
+            const type = featureType(feature);
+            // The ladder: a host's explicit registration outranks the skin's
+            // builtin, and nothing at all is a NOTICE, never an omission.
+            const Editor = (type === undefined ? null : resolveValueEditor(type)) ??
+                (type === undefined ? undefined : BUILTIN_VALUE_EDITORS[type]);
+            const control = Editor === undefined || Editor === null ? (_jsx(UnsupportedValueEditor, { feature: feature })) : (_jsx(Editor, { id: controlId, feature: feature, value: props.values[feature.slug], onChange: (value) => props.onChange(feature.slug, value), error: errors[feature.slug], disabled: props.disabled === true }));
+            const row = {
+                feature,
+                controlId,
+                control,
+                error: errors[feature.slug],
+                required: feature.mandatory === true,
+            };
+            if (props.renderRow)
+                return _jsx("div", { children: props.renderRow(row) }, feature.slug);
+            return _jsx(FeatureRow, { ...row }, feature.slug);
+        }) }));
+}
+//# sourceMappingURL=FeatureFields.js.map

package/dist/default/FeatureFields.js.map

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

package/dist/default/editors.d.ts

@@ -0,0 +1,24 @@
+import type { ValueEditor } from "../registry.js";
+/** Unix seconds → the string a native input of this precision displays,
+ * in the VIEWER's time zone (which is what the person typed it in). */
+export declare function timestampToInputValue(seconds: number, precision: string): string;
+/**
+ * The inverse. Takes no `precision`: a native input's value already says
+ * which shape it is (`2010`, `2010-06`, `2010-06-15`, `2010-06-15T14:30`), so
+ * reading the config here would only create a way for the two to disagree.
+ *
+ * Returns `undefined` for an empty or unparseable input rather than 0 — `0`
+ * is 1970, a real timestamp, and the one value that must never be produced by
+ * "the person cleared the field".
+ */
+export declare function inputValueToTimestamp(text: string): number | undefined;
+/**
+ * The skin's builtin editor per value type — the second rung of the ladder.
+ * A type absent from this table has no default drawing and reaches
+ * `<UnsupportedValueEditor/>`.
+ */
+export declare const BUILTIN_VALUE_EDITORS: Readonly<Record<string, ValueEditor>>;
+/** The types this skin can draw — handed to `unsupportedTypes` so the
+ * headless half can judge renderability without importing the skin. */
+export declare const BUILTIN_VALUE_EDITOR_TYPES: readonly string[];
+//# sourceMappingURL=editors.d.ts.map

package/dist/default/editors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editors.d.ts","sourceRoot":"","sources":["../../src/default/editors.tsx"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AAuNpE;uEACuE;AACvE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CActE;AAmQD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAWvE,CAAC;AAEF;uEACuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EACb,CAAC"}