@mohasinac/appkit 4.66.0 → 4.67.0

package/dist/react/hooks/useListingSurfaceVisibility.d.ts

@@ -0,0 +1,44 @@
+import type { ListingType } from "../../features/products/types/index";
+/**
+ * Which public browse surfaces should be LINKED — the admin flag, minus the
+ * ones measured as having nothing in them.
+ *
+ * ## 🛑 Why this is not a change to `useListingTypeFlags`
+ *
+ * That hook answers a different question — *"does this marketplace sell X?"* —
+ * and its main consumer is the seller's type dropdown. A seller must still be
+ * able to list the first spare part when there are zero spares, so folding
+ * emptiness into it would make the catalogue unfillable the moment it emptied:
+ * the only control that could add stock would disappear for want of stock.
+ * Same split as `enabledListingTypes` vs `visibleListingTypes`.
+ *
+ * So: `useListingTypeFlags` for anything AUTHORING, this for anything
+ * BROWSING.
+ *
+ * ## 🛑 Defaults to VISIBLE while settings load
+ *
+ * Same reasoning as `useBrowsePageFlags`, and it bites harder here. This hook
+ * decides whether a nav entry renders, and `surfaceCounts` is absent from the
+ * payload until the rollup has run at least once — so a restrictive default
+ * would blank most of the navbar on every cold load, and would blank it
+ * permanently on an install whose job has never run.
+ *
+ * `isListingSurfaceVisible` encodes the rule (absent count → visible); this
+ * hook only supplies it with data. Do not re-derive the comparison here.
+ */
+export type ListingSurfaceVisibility = Record<ListingType, boolean> & {
+    /** True when the type's browse surface should be linked. */
+    isVisible: (type: ListingType) => boolean;
+    /**
+     * True when a non-listing-type surface (`"reviews"`) should be linked.
+     * Absent measurement → true.
+     */
+    isSurfaceVisible: (surface: string) => boolean;
+    /**
+     * True when a link may be shown — it points at no listing-type surface, or
+     * at one that is visible. Pass an href straight from a nav/footer constant,
+     * together with the href→types map the caller owns.
+     */
+    allowsTypes: (types: readonly ListingType[] | undefined) => boolean;
+};
+export declare function useListingSurfaceVisibility(): ListingSurfaceVisibility;

package/dist/react/hooks/useListingSurfaceVisibility.js

@@ -0,0 +1,20 @@
+"use client";
+import { useSiteSettings } from "../../core/hooks/useSiteSettings.js";
+import { ALL_LISTING_TYPES, isListingSurfaceVisible, isCountedSurfaceVisible, } from "../../_internal/shared/listing-types/feature-flags.js";
+export function useListingSurfaceVisibility() {
+    const { data } = useSiteSettings();
+    const settings = { listings: { listingTypes: data?.listings?.listingTypes } };
+    const counts = data?.surfaceCounts;
+    const flags = Object.fromEntries(ALL_LISTING_TYPES.map((t) => [t, isListingSurfaceVisible(t, settings, counts)]));
+    return {
+        ...flags,
+        isVisible: (type) => flags[type],
+        isSurfaceVisible: (surface) => isCountedSurfaceVisible(surface, counts),
+        /*
+         * ANY of the types, not every — matching the existing footer rule, whose
+         * comment states it: "/art stays reachable when stickers are off and art
+         * is on." A shared page is empty only when every type it spans is.
+         */
+        allowsTypes: (types) => !types || types.length === 0 || types.some((t) => flags[t]),
+    };
+}

package/dist/server.d.ts

@@ -662,3 +662,5 @@ export { AD_BOOKING_COLLECTION, AD_BOOKING_PAYMENT_STATES, AD_MODERATION_STATES,
 export type { AdBookingDocument, AdBookingCreative, AdBookingPaymentState, AdModerationState, AdPeriod, } from "./features/ads/schemas/firestore";
 export { getDashboardHubData } from "./_internal/server/features/dashboard/data";
 export type { DashboardHubData } from "./_internal/server/features/dashboard/data";
+export { getSurfaceCounts } from "./_internal/server/features/products/surface-counts";
+export type { PublicSurfaceCounts } from "./_internal/server/features/products/surface-counts";

package/dist/server.js

@@ -1872,3 +1872,15 @@ export { AD_BOOKING_COLLECTION, AD_BOOKING_PAYMENT_STATES, AD_MODERATION_STATES,
  * above reaches a consumer route.
  */
 export { getDashboardHubData } from "./_internal/server/features/dashboard/data.js";
+// Auto-hide: the measured "does this browse surface hold anything" document.
+// Server-only (firebase-admin via getAdminDb); the PREDICATE that reads it is
+// client-safe and lives in client.ts/index.ts beside the other visibility gates.
+export { getSurfaceCounts } from "./_internal/server/features/products/surface-counts.js";
+/*
+ * 🛑 `runSurfaceCountsRollup` / `computeSurfaceCounts` are deliberately NOT
+ * exported. They live under `_internal/server/jobs/core/` and their only
+ * caller is `countersReconcileHandler`, which imports them directly — so a
+ * barrel entry would leak an `_internal/` symbol for no consumer, which
+ * `audit-appkit-reexports` correctly blocks. Add one only if a consumer
+ * genuinely needs to trigger a rollup from outside appkit.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "4.66.0",
+  "version": "4.67.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -23,6 +23,18 @@
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js"
     },
+    "./client/*": {
+      "types": "./dist/client/*.d.ts",
+      "import": "./dist/client/*.js"
+    },
+    "./hand-mode": {
+      "types": "./dist/hand-mode/index.d.ts",
+      "import": "./dist/hand-mode/index.js"
+    },
+    "./theme": {
+      "types": "./dist/theme/index.d.ts",
+      "import": "./dist/theme/index.js"
+    },
     "./next": {
       "types": "./dist/next/index.d.ts",
       "import": "./dist/next/index.js"
@@ -281,6 +293,26 @@
     "./views/tour-provider": {
       "types": "./dist/_internal/client/features/tour/TourProvider.d.ts",
       "import": "./dist/_internal/client/features/tour/TourProvider.js"
+    },
+    "./shipping/quote": {
+      "types": "./dist/_internal/shared/shipping/quote.d.ts",
+      "import": "./dist/_internal/shared/shipping/quote.js"
+    },
+    "./fees/calculator": {
+      "types": "./dist/_internal/shared/fees/calculator.d.ts",
+      "import": "./dist/_internal/shared/fees/calculator.js"
+    },
+    "./emi/choice": {
+      "types": "./dist/_internal/shared/features/emi/choice.d.ts",
+      "import": "./dist/_internal/shared/features/emi/choice.js"
+    },
+    "./layout/nav-portal": {
+      "types": "./dist/_internal/shared/features/layout/types.d.ts",
+      "import": "./dist/_internal/shared/features/layout/types.js"
+    },
+    "./views/digital-content-pool": {
+      "types": "./dist/_internal/client/features/digital-code/DigitalContentPoolManager.d.ts",
+      "import": "./dist/_internal/client/features/digital-code/DigitalContentPoolManager.js"
     }
   },
   "files": [