@stapel/listings-react 0.1.0

package/dist/headless/ListingComposer.d.ts

@@ -0,0 +1,133 @@
+import type { ReactElement, ReactNode } from "react";
+import type { ActionAvailability, FlowError, LoadState } from "@stapel/core";
+import type { FeatureDef } from "@stapel/attributes-react";
+import type { ListingDetail as ListingDetailData, ListingDraft, PublishResponse } from "../api/types.js";
+import type { ListingDraftValues, ListingLocation } from "../model/draft.js";
+import type { PublishRefusal } from "../model/validation.js";
+/**
+ * The submission flow — the pair's long pole, and the place four contracts
+ * meet: the draft twin (listings), the value editors (attributes), the upload
+ * queue (cdn) and the category schema (categories).
+ *
+ * ── The steps, and why they are not a `@flow_step` funnel ──────────────────
+ *
+ *     pick a category → create the draft row → save into it → publish
+ *
+ * The server does not sequence these (see `flows/registry.ts`). What DOES
+ * sequence them is here, and its stages are named so analytics can follow the
+ * funnel without the backend having declared one.
+ *
+ * ── The three seams, and why none of them is an import ─────────────────────
+ *
+ * `@stapel/listings-react`, `@stapel/cdn-react` and `@stapel/categories-react`
+ * are all L2 pairs, and L2 pairs never import each other (the monorepo README
+ * states the direction). So:
+ *
+ *  - **the category schema** arrives as `features` — a plain
+ *    `readonly FeatureDef[]`. The container gets it from
+ *    `@stapel/categories-react`'s `useCategoryFeatures`;
+ *  - **the gallery** arrives as {@link ListingImagesBag} — two members,
+ *    satisfied STRUCTURALLY by `useUploadQueue()`'s bag from
+ *    `@stapel/cdn-react`. `bag.refs` IS the value of `images_draft` (same
+ *    order, first tile is the cover) and `bag.settled` is the submit gate
+ *    that stops a publish while photos are in flight. That pair wrote its bag
+ *    to this contract on purpose (its §13.6 note 9);
+ *  - **the value editors** come from `@stapel/attributes-react`, which is L0
+ *    and therefore a legitimate dependency. Only `editorTypes` crosses back:
+ *    the headless half must judge renderability without importing a skin, so
+ *    the skin's `BUILTIN_VALUE_EDITOR_TYPES` is passed IN.
+ *
+ * ── Reopening a draft is NOT possible on stapel-listings 0.6.0 ─────────────
+ *
+ * No read returns the `*_draft` twin: `GET /{pk}/` serializes the PUBLISHED
+ * fields (`ListingDetailSerializer`), and `ListingDraftSerializer` appears
+ * only as the RESPONSE of create / save-draft. So editing a live listing
+ * works completely — the composer seeds from the published half, which is
+ * exactly what the person sees on the page — while a draft abandoned and
+ * reopened later comes back empty. The composer says so
+ * (`draftNotReadable`) instead of showing a blank form as if nothing had been
+ * typed. Upstream ask, recorded in MODULE.md: put the draft twin on the
+ * retrieve, or add `GET /{pk}/draft/`.
+ */
+/** The two members of `@stapel/cdn-react`'s upload bag this composer needs.
+ * Declared structurally so the dependency stays a wiring decision. */
+export interface ListingImagesBag {
+    /** Settled CDN references in display order — the value of `images_draft`. */
+    readonly refs: readonly string[];
+    /** Available when every pick has a reference; blocked WITH the reason
+     * (still uploading / one failed) otherwise. */
+    readonly settled: ActionAvailability;
+}
+/** Where the submission has got to. Named so a funnel can be measured. */
+export type ComposeStage = "choosing_category" | "editing" | "saving" | "publishing" | "published";
+/** What a successful publish turned out to be — the 0.5.0 distinction, taken
+ * from the server's own answer rather than guessed from what we sent. */
+export type PublishOutcome = "submitted_for_review" | "live_edit_under_review";
+export interface UseListingComposerOptions {
+    /** An existing listing to edit. Absent: a new one, whose row is created on
+     * the first save. */
+    readonly listingId?: number;
+    /** The chosen category's features. Empty while none is chosen. */
+    readonly features: readonly FeatureDef[];
+    /** The schema read is in flight. Blocks the submit with its own reason —
+     * publishing against a half-known schema is how a mandatory attribute gets
+     * skipped. */
+    readonly featuresLoading?: boolean;
+    /** The schema read failed. Same block, different sentence. */
+    readonly featuresError?: unknown;
+    /** Value types the rendering half can draw — pass
+     * `BUILTIN_VALUE_EDITOR_TYPES` from `@stapel/attributes-react/default`. */
+    readonly editorTypes?: readonly string[];
+    /** The upload queue. Absent: no gallery, and `images` is set through
+     * `setValue` by whatever the host uses instead. */
+    readonly images?: ListingImagesBag;
+    /** Seed for a brand-new draft (a category preselected from the URL, say). */
+    readonly initialValues?: Partial<ListingDraftValues>;
+    onDraftCreated?: (draft: ListingDraft) => void;
+    onPublished?: (response: PublishResponse, outcome: PublishOutcome) => void;
+}
+export interface ListingComposerBag {
+    readonly stage: ComposeStage;
+    readonly listingId: number | undefined;
+    readonly values: ListingDraftValues;
+    /** The listing being edited, when there is one. `loading` until it lands —
+    a composer must not let someone publish over a listing it has not read. */
+    readonly listingState: LoadState<ListingDetailData> | undefined;
+    /** Editing something already PUBLISHED: the submit becomes "send changes",
+     * and the listing stays visible throughout. */
+    readonly isLiveEdit: boolean;
+    /** The reopened draft came back empty because no read returns the draft
+     * twin — see this module's header. */
+    readonly draftNotReadable: boolean;
+    setValue<K extends keyof ListingDraftValues>(key: K, value: ListingDraftValues[K]): void;
+    setLocation(location: ListingLocation): void;
+    setFeature(slug: string, value: unknown): void;
+    /** Changing category keeps the answers the new schema also asks for. */
+    setCategory(categoryId: string): void;
+    /** Slugs cleared by the last category change — named, not silently lost. */
+    readonly droppedOnCategoryChange: readonly string[];
+    /** The client mirror, always current. */
+    readonly mirror: Readonly<Record<string, FlowError>>;
+    /** What a control should actually show: the mirror once the person has
+     * tried to submit, overlaid by the server's verdict when there is one. */
+    readonly fieldErrors: Readonly<Record<string, FlowError>>;
+    /** The server's last publish refusal, unrouted, for a summary line. */
+    readonly refusal: PublishRefusal | undefined;
+    /** Value types this build cannot draw — the fact, from attributes-react. */
+    readonly unsupported: readonly string[];
+    readonly saveGate: ActionAvailability;
+    readonly publishGate: ActionAvailability;
+    save(): void;
+    publish(): void;
+    readonly saving: boolean;
+    readonly publishing: boolean;
+    readonly saved: boolean;
+    readonly saveError: unknown;
+    readonly outcome: PublishOutcome | undefined;
+}
+export declare function useListingComposer(options: UseListingComposerOptions): ListingComposerBag;
+/** Renderless: the bag, handed to a render prop. */
+export declare function ListingComposer(props: UseListingComposerOptions & {
+    children: (bag: ListingComposerBag) => ReactNode;
+}): ReactElement;
+//# sourceMappingURL=ListingComposer.d.ts.map

package/dist/headless/ListingComposer.d.ts.map

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

package/dist/headless/ListingComposer.js

@@ -0,0 +1,246 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { actionAvailable, actionBlocked, firstBlock, loadFailed, loadLoading, loadReady, } from "@stapel/core";
+import { toFeaturesDto, unsupportedTypes } from "@stapel/attributes-react";
+import { useListingsRuntime } from "../model/context.js";
+import { useListing } from "../model/queries.js";
+import { useCreateDraft, usePublishListing, useSaveDraft, } from "../model/mutations.js";
+import { createDraftBody, draftPatchFromValues, draftValuesFromDetail, droppedFeatureSlugs, emptyDraftValues, retainKnownFeatureValues, } from "../model/draft.js";
+import { asFeatureDaoList } from "../model/features.js";
+import { featuresDtoFromDaoList } from "../model/features.js";
+import { mirrorDraft, publishRefusal } from "../model/validation.js";
+import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
+import { useMandateGate } from "./useMandateGate.js";
+export function useListingComposer(options) {
+    const runtime = useListingsRuntime();
+    const mandate = useMandateGate();
+    const [listingId, setListingId] = useState(options.listingId);
+    const [values, setValues] = useState(() => ({
+        ...emptyDraftValues({ currency: runtime.currency }),
+        ...options.initialValues,
+    }));
+    const [showErrors, setShowErrors] = useState(false);
+    const [dropped, setDropped] = useState([]);
+    const [refusal, setRefusal] = useState(undefined);
+    const [outcome, setOutcome] = useState(undefined);
+    const [saved, setSaved] = useState(false);
+    const existing = useListing(options.listingId);
+    const createDraft = useCreateDraft();
+    const saveDraft = useSaveDraft();
+    const publishListing = usePublishListing();
+    // Seed once from the listing being edited. `seeded` is a ref rather than a
+    // dependency guard because re-seeding on a refetch would throw away
+    // everything typed since — a background invalidation must never rewrite a
+    // form somebody is in the middle of.
+    const seeded = useRef(false);
+    useEffect(() => {
+        if (seeded.current)
+            return;
+        const detail = existing.data;
+        if (detail === undefined)
+            return;
+        seeded.current = true;
+        setListingId(detail.id);
+        setValues(draftValuesFromDetail(detail, featuresDtoFromDaoList(asFeatureDaoList(detail.features)), { currency: runtime.currency }));
+    }, [existing.data, runtime.currency]);
+    // Pruning runs on the SCHEMA arriving, one render after the category
+    // changed: `setCategory` cannot prune against features it has not been
+    // handed. Gated on the schema being settled, because pruning against a
+    // half-loaded (or previous) category's features would delete answers that
+    // are perfectly valid for the one now chosen.
+    const schemaSettled = options.featuresLoading !== true && options.featuresError === undefined;
+    const { features } = options;
+    useEffect(() => {
+        if (!schemaSettled || features.length === 0)
+            return;
+        setValues((current) => {
+            const gone = droppedFeatureSlugs(current.features, features);
+            if (gone.length === 0)
+                return current;
+            setDropped(gone);
+            return {
+                ...current,
+                features: retainKnownFeatureValues(current.features, features),
+            };
+        });
+    }, [schemaSettled, features]);
+    // The gallery is the upload bag's, whenever there is one: two sources of
+    // truth for the same list is how a publish sends photos the person removed.
+    const images = options.images?.refs ?? values.images;
+    const effectiveValues = useMemo(() => ({ ...values, images }), [values, images]);
+    const featuresDto = useMemo(() => toFeaturesDto(options.features, effectiveValues.features), [options.features, effectiveValues.features]);
+    const mirror = useMemo(() => mirrorDraft(effectiveValues, options.features, featuresDto, runtime.limits), [effectiveValues, options.features, featuresDto, runtime.limits]);
+    const unsupported = useMemo(() => unsupportedTypes(options.features, options.editorTypes ?? []), [options.features, options.editorTypes]);
+    const isLiveEdit = existing.data?.status === "published";
+    const draftNotReadable = existing.data !== undefined &&
+        existing.data.status !== "published" &&
+        (existing.data.title ?? "").length === 0 &&
+        (existing.data.description ?? "").length === 0;
+    const fieldErrors = useMemo(() => {
+        const shown = showErrors ? mirror : {};
+        return refusal?.kind === "invalid_draft"
+            ? { ...shown, ...refusal.fieldErrors }
+            : shown;
+    }, [showErrors, mirror, refusal]);
+    const listingState = options.listingId === undefined
+        ? undefined
+        : existing.status === "error"
+            ? loadFailed(existing.error)
+            : existing.data !== undefined
+                ? loadReady(existing.data)
+                : loadLoading();
+    const busy = createDraft.isPending || saveDraft.isPending;
+    const schemaGate = options.featuresError !== undefined
+        ? actionBlocked(LISTINGS_I18N_KEYS.composeBlockedDetailsUnavailable)
+        : options.featuresLoading === true
+            ? actionBlocked(LISTINGS_I18N_KEYS.composeDetailsLoading)
+            : actionAvailable();
+    const categoryGate = effectiveValues.categoryId.length > 0
+        ? actionAvailable()
+        : actionBlocked(LISTINGS_I18N_KEYS.composeBlockedNoCategory);
+    const busyGate = busy
+        ? actionBlocked(LISTINGS_I18N_KEYS.composeBlockedBusy)
+        : actionAvailable();
+    const saveGate = firstBlock(mandate, categoryGate, busyGate);
+    // The publish gate is the save gate PLUS everything that must be true for a
+    // submission to be complete. Order is the order a person would be told:
+    // may you act at all → is the form even answerable → are the photos in →
+    // is the form itself clean.
+    const publishGate = firstBlock(mandate, categoryGate, schemaGate, unsupported.length > 0
+        ? actionBlocked(LISTINGS_I18N_KEYS.composeBlockedUnsupportedType, {
+            types: unsupported.join(", "),
+        })
+        : actionAvailable(), options.images?.settled ?? actionAvailable(), busyGate, publishListing.isPending
+        ? actionBlocked(LISTINGS_I18N_KEYS.composeBlockedBusy)
+        : actionAvailable(), Object.keys(mirror).length > 0
+        ? actionBlocked(LISTINGS_I18N_KEYS.composeBlockedMirror)
+        : actionAvailable());
+    /** Create the row on demand: the id is what every other write needs. */
+    const ensureListingId = useCallback(async () => {
+        if (listingId !== undefined && listingId > 0)
+            return listingId;
+        if (effectiveValues.categoryId.length === 0)
+            return undefined;
+        const draft = await createDraft.mutateAsync(createDraftBody(effectiveValues.categoryId));
+        setListingId(draft.id);
+        options.onDraftCreated?.(draft);
+        return draft.id;
+    }, [listingId, effectiveValues.categoryId, createDraft, options]);
+    const persist = useCallback(async () => {
+        const id = await ensureListingId();
+        if (id === undefined)
+            return undefined;
+        // The id comes from `ensureListingId`, not from this closure's render:
+        // creating the row and saving into it happen in ONE gesture, and the
+        // state update that records the new id has not committed yet.
+        await saveDraft.mutateAsync({
+            id,
+            body: draftPatchFromValues(effectiveValues, options.features),
+        });
+        setSaved(true);
+        return id;
+    }, [ensureListingId, saveDraft, effectiveValues, options.features]);
+    const save = useCallback(() => {
+        setShowErrors(true);
+        if (!saveGate.available)
+            return;
+        setRefusal(undefined);
+        void persist().catch(() => {
+            // The mutation's own `error` carries it; swallowing the rejection here
+            // only stops an unhandled-rejection warning for a failure the bag
+            // already reports.
+        });
+    }, [saveGate.available, persist]);
+    const publish = useCallback(() => {
+        setShowErrors(true);
+        if (!publishGate.available)
+            return;
+        setRefusal(undefined);
+        void (async () => {
+            try {
+                // Always save first: publish reads the STORED draft, so publishing
+                // without saving would promote whatever was there before the last
+                // keystroke — and the person would be told their listing is fine
+                // while a field they just fixed is still wrong on the server.
+                const id = await persist();
+                if (id === undefined)
+                    return;
+                const response = await publishListing.mutateAsync(id);
+                const result = response.status === "published"
+                    ? "live_edit_under_review"
+                    : "submitted_for_review";
+                setOutcome(result);
+                options.onPublished?.(response, result);
+            }
+            catch (thrown) {
+                setRefusal(publishRefusal(thrown));
+            }
+        })();
+    }, [publishGate.available, persist, publishListing, options]);
+    const stage = outcome !== undefined
+        ? "published"
+        : publishListing.isPending
+            ? "publishing"
+            : busy
+                ? "saving"
+                : effectiveValues.categoryId.length === 0
+                    ? "choosing_category"
+                    : "editing";
+    return {
+        stage,
+        listingId,
+        values: effectiveValues,
+        listingState,
+        isLiveEdit,
+        draftNotReadable,
+        setValue: (key, value) => {
+            setSaved(false);
+            setValues((current) => ({ ...current, [key]: value }));
+        },
+        setLocation: (location) => {
+            setSaved(false);
+            setValues((current) => ({ ...current, location }));
+        },
+        setFeature: (slug, value) => {
+            setSaved(false);
+            setValues((current) => ({
+                ...current,
+                features: { ...current.features, [slug]: value },
+            }));
+        },
+        setCategory: (categoryId) => {
+            setSaved(false);
+            setValues((current) => {
+                if (current.categoryId === categoryId)
+                    return current;
+                // The features of the NEW category are not known yet (the container's
+                // schema read has not run), so nothing is pruned here — pruning
+                // happens in the effect below, once they arrive. Recording the
+                // intent, not guessing the outcome.
+                return { ...current, categoryId };
+            });
+            setDropped([]);
+            setRefusal(undefined);
+        },
+        droppedOnCategoryChange: dropped,
+        mirror,
+        fieldErrors,
+        refusal,
+        unsupported,
+        saveGate,
+        publishGate,
+        save,
+        publish,
+        saving: busy,
+        publishing: publishListing.isPending,
+        saved,
+        saveError: saveDraft.error ?? createDraft.error,
+        outcome,
+    };
+}
+/** Renderless: the bag, handed to a render prop. */
+export function ListingComposer(props) {
+    const bag = useListingComposer(props);
+    return _jsx(_Fragment, { children: props.children(bag) });
+}
+//# sourceMappingURL=ListingComposer.js.map

package/dist/headless/ListingComposer.js.map

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

package/dist/headless/ListingDetail.d.ts

@@ -0,0 +1,81 @@
+import type { ReactElement, ReactNode } from "react";
+import type { ActionAvailability, LoadState } from "@stapel/core";
+import type { ListingDetail as ListingDetailData, ListingFeatureView, ListingStatusInfo } from "../api/types.js";
+import type { ListingStatusView } from "../model/status.js";
+/**
+ * Everything a listing page renders, with the two absences it must be able to
+ * tell apart.
+ *
+ * ── Why a second read runs beside the detail ───────────────────────────────
+ *
+ * `GET /listings/{pk}/` reads `Listing.objects`, which excludes soft-deleted
+ * rows: a removed listing answers 404, and a 404 is also what a made-up id
+ * answers. `GET /listings/{pk}/status/` reads `Listing.all_objects` and is
+ * `AllowAny`, so it still answers for the removed one. Running both is what
+ * turns "there is no listing at this address" and "this listing was removed"
+ * into two different sentences — and the second is the one a person following
+ * a stale link actually needs.
+ *
+ * The probe is not a fallback fired after a failure: it runs in parallel, so
+ * the page resolves in one round trip rather than two sequential ones.
+ *
+ * ── Visibility is reported, not assumed ────────────────────────────────────
+ *
+ * The detail endpoint has NO `published()` filter on its queryset, so a draft
+ * and a taken-down listing both answer 200 to anyone holding the id. The bag
+ * therefore carries `publiclyVisible` (computed from `status`, the one field
+ * that decides it) and `viewerIsOwner`, and a skin says which of the two
+ * situations it is in. Rendering a draft as a live shop page would be the
+ * pair repeating the server's omission instead of covering it.
+ */
+export interface ListingDetailBag {
+    readonly id: number;
+    readonly state: LoadState<ListingDetailData>;
+    /** The status probe, which answers for rows the detail cannot see. */
+    readonly statusState: LoadState<ListingStatusInfo>;
+    /** True when the detail 404s AND the probe says the row is soft-deleted —
+     * i.e. it existed and is gone, rather than never having existed. */
+    readonly removed: boolean;
+    /** The detail 404s and the probe finds nothing either. */
+    readonly notFound: boolean;
+    /** Both axes plus the sentence that comes out of the pair of them. */
+    readonly status: ListingStatusView | undefined;
+    readonly publiclyVisible: boolean;
+    /** Whether the person reading this is the owner, when both the probe and
+     * the viewer's id are known. `undefined` means "we did not ask" — a public
+     * page has no reason to. */
+    readonly viewerIsOwner: boolean | undefined;
+    /** The ordered specs table. */
+    readonly features: readonly ListingFeatureView[];
+    /** The `show_at_title` subset — what a heading appends. */
+    readonly titleFeatures: readonly ListingFeatureView[];
+    /** The `show_as_badge` subset — what a card shows. */
+    readonly badgeFeatures: readonly ListingFeatureView[];
+    /** Stored rows this build could not key. Reported, never rounded to zero. */
+    readonly unreadableFeatures: number;
+    /** Ordered CDN references. Resolving one to an image is the runtime's job
+     * (`resolveImage`), because no contract in this fleet resolves a
+     * stranger's reference — see `model/runtime.ts`. */
+    readonly images: readonly string[];
+    readonly isFavorited: boolean | undefined;
+    /** Saving a favourite needs a mandate; the block says which of the four
+     * reasons applies. */
+    readonly favoriteGate: ActionAvailability;
+    toggleFavorite(): void;
+    readonly favoriteInFlight: boolean;
+    refetch(): void;
+}
+export interface UseListingDetailOptions {
+    /** The reader's own id, when the host knows it — enables `viewerIsOwner`.
+     * A uuid string, matching `ListingDetail.owner` / `ListingStatus.owner_id`. */
+    readonly viewerId?: string;
+}
+export declare function useListingDetail(id: number, options?: UseListingDetailOptions): ListingDetailBag;
+/** Renderless: the bag, handed to a render prop. Bring your own visuals, or
+ * import `<ListingDetailPane>` from `./default`. */
+export declare function ListingDetail(props: {
+    id: number;
+    viewerId?: string;
+    children: (bag: ListingDetailBag) => ReactNode;
+}): ReactElement;
+//# sourceMappingURL=ListingDetail.d.ts.map

package/dist/headless/ListingDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListingDetail.d.ts","sourceRoot":"","sources":["../../src/headless/ListingDetail.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EACV,aAAa,IAAI,iBAAiB,EAClC,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAc5D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC7C,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACnD;wEACoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC;;gCAE4B;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtD,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtD,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;wDAEoD;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C;0BACsB;IACtB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,cAAc,IAAI,IAAI,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC;mFAC+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CA4GlB;AAED;oDACoD;AACpD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,SAAS,CAAC;CAChD,GAAG,YAAY,CAMf"}

package/dist/headless/ListingDetail.js

@@ -0,0 +1,101 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { actionAvailable, actionBlocked, errorStatus, firstBlock, loadFailed, loadLoading, loadReady, } from "@stapel/core";
+import { useListing, useListingStatus } from "../model/queries.js";
+import { useFavoriteListing } from "../model/mutations.js";
+import { asFeatureDaoList, featuresFromDaoList, unreadableFeatureCount } from "../model/features.js";
+import { listingStatusView } from "../model/status.js";
+import { LISTINGS_I18N_KEYS } from "../i18n/keys.js";
+import { useMandateGate } from "./useMandateGate.js";
+/**
+ * `images` is `string[] | NULL` on the wire, and the null is the SERVER
+ * saying "this listing has no photos" — not this pair saying "we do not
+ * know". Whether the read landed at all is carried by `state`, one field
+ * over, so collapsing the null here loses nothing: a named constant makes
+ * that argument visible where a bare `?? []` would look like the flattening
+ * `no-flattened-load-state` bans.
+ */
+const NO_IMAGES = [];
+export function useListingDetail(id, options = {}) {
+    const detail = useListing(id);
+    const probe = useListingStatus(id);
+    const favorite = useFavoriteListing();
+    const mandate = useMandateGate();
+    const state = detail.status === "error"
+        ? loadFailed(detail.error)
+        : detail.data !== undefined
+            ? loadReady(detail.data)
+            : loadLoading();
+    const statusState = probe.status === "error"
+        ? loadFailed(probe.error)
+        : probe.data !== undefined
+            ? loadReady(probe.data)
+            : loadLoading();
+    const detailIs404 = detail.status === "error" && errorStatus(detail.error) === 404;
+    const removed = detailIs404 && probe.data?.is_deleted === true;
+    const notFound = detailIs404 && !removed && probe.status === "error";
+    const status = useMemo(() => {
+        if (detail.data !== undefined) {
+            return listingStatusView(detail.data.status ?? "draft", detail.data.moderation_status ?? "pending");
+        }
+        // The probe still knows both axes for a row the detail cannot return —
+        // `moderation_status` arrives as a bare string there, so it is narrowed
+        // by the same table rather than trusted.
+        if (probe.data !== undefined) {
+            const moderation = probe.data.moderation_status;
+            return listingStatusView(probe.data.status, moderation === "approved" ||
+                moderation === "rejected" ||
+                moderation === "needs_review"
+                ? moderation
+                : "pending");
+        }
+        return undefined;
+    }, [detail.data, probe.data]);
+    const owner = detail.data?.owner ?? probe.data?.owner_id;
+    const viewerIsOwner = options.viewerId === undefined || owner === undefined
+        ? undefined
+        : owner === options.viewerId;
+    const features = useMemo(() => featuresFromDaoList(asFeatureDaoList(detail.data?.features)), [detail.data]);
+    const titleFeatures = useMemo(() => featuresFromDaoList(asFeatureDaoList(detail.data?.features_title)), [detail.data]);
+    const badgeFeatures = useMemo(() => featuresFromDaoList(asFeatureDaoList(detail.data?.features_badges)), [detail.data]);
+    const isFavorited = detail.data?.is_favorited ?? undefined;
+    const favoriteGate = firstBlock(mandate, favorite.isPending
+        ? actionBlocked(LISTINGS_I18N_KEYS.blockedInFlight)
+        : actionAvailable(), detail.data === undefined
+        ? actionBlocked(LISTINGS_I18N_KEYS.detailLoading)
+        : actionAvailable());
+    return {
+        id,
+        state,
+        statusState,
+        removed,
+        notFound,
+        status,
+        publiclyVisible: status?.lifecycle.publiclyVisible ?? false,
+        viewerIsOwner,
+        features,
+        titleFeatures,
+        badgeFeatures,
+        unreadableFeatures: unreadableFeatureCount(asFeatureDaoList(detail.data?.features)),
+        images: detail.data?.images ?? NO_IMAGES,
+        isFavorited,
+        favoriteGate,
+        toggleFavorite: () => {
+            if (!favoriteGate.available)
+                return;
+            favorite.mutate({ id, favorited: isFavorited !== true });
+        },
+        favoriteInFlight: favorite.isPending,
+        refetch: () => {
+            void detail.refetch();
+            void probe.refetch();
+        },
+    };
+}
+/** Renderless: the bag, handed to a render prop. Bring your own visuals, or
+ * import `<ListingDetailPane>` from `./default`. */
+export function ListingDetail(props) {
+    const bag = useListingDetail(props.id, props.viewerId !== undefined ? { viewerId: props.viewerId } : {});
+    return _jsx(_Fragment, { children: props.children(bag) });
+}
+//# sourceMappingURL=ListingDetail.js.map

package/dist/headless/ListingDetail.js.map

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

package/dist/headless/ListingsProvider.d.ts

@@ -0,0 +1,17 @@
+import type { ReactElement, ReactNode } from "react";
+import type { ListingsRuntime } from "../model/runtime.js";
+/**
+ * Renderless provider — puts one wired {@link ListingsRuntime} in context for
+ * every hook and headless component in the pair. Bring your own visual shell.
+ *
+ * ```tsx
+ * <ListingsProvider runtime={createListingsRuntime({ baseUrl: "/listings/api/v1/" })}>
+ *   <YourShopWindow />
+ * </ListingsProvider>
+ * ```
+ */
+export declare function ListingsProvider(props: {
+    runtime: ListingsRuntime;
+    children: ReactNode;
+}): ReactElement;
+//# sourceMappingURL=ListingsProvider.d.ts.map

package/dist/headless/ListingsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListingsProvider.d.ts","sourceRoot":"","sources":["../../src/headless/ListingsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAEf"}

package/dist/headless/ListingsProvider.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ModuleProvider } from "../model/context.js";
+/**
+ * Renderless provider — puts one wired {@link ListingsRuntime} in context for
+ * every hook and headless component in the pair. Bring your own visual shell.
+ *
+ * ```tsx
+ * <ListingsProvider runtime={createListingsRuntime({ baseUrl: "/listings/api/v1/" })}>
+ *   <YourShopWindow />
+ * </ListingsProvider>
+ * ```
+ */
+export function ListingsProvider(props) {
+    return _jsx(ModuleProvider, { runtime: props.runtime, children: props.children });
+}
+//# sourceMappingURL=ListingsProvider.js.map

package/dist/headless/ListingsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListingsProvider.js","sourceRoot":"","sources":["../../src/headless/ListingsProvider.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAGhC;IACC,OAAO,KAAC,cAAc,IAAC,OAAO,EAAE,KAAK,CAAC,OAAO,YAAG,KAAK,CAAC,QAAQ,GAAkB,CAAC;AACnF,CAAC"}