@mohasinac/appkit 4.69.1 → 4.71.0

package/dist/ui/components/SiteLogo.js

@@ -1,12 +1,23 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
- * LetItRip site logo — SVG wordmark "LetItRip" + small ".in" superscript.
+ * Site logo — an SVG wordmark with an optional TLD badge.
+ *
+ * 🛑 The glyphs are the CONSUMER's. This header used to read "SVG wordmark
+ * LetItRip + small .in superscript", and that was an accurate description: the
+ * text was baked into the SVG where no prop could reach it, so every install of
+ * appkit rendered one Indian marketplace's name in its own header. Both are
+ * props now (`wordmark`, `tld`), threaded from `appkit.config.js` through
+ * `AppLayoutShell` -> `TitleBarLayout`.
  *
  * Single source of truth for the site brand mark. The wordmark gradient
  * follows the active theme via `var(--appkit-gradient-logo)`, so a custom
  * admin theme automatically restyles the logo without forking the SVG.
  *
+ * 🛑 The 214-unit viewBox was drawn around an eight-glyph wordmark. A much
+ * longer name will overflow it — pass `src` and use a real logo image rather
+ * than expecting the SVG to re-letter itself.
+ *
  * Sizes are responsive presets — the variant catalogue forbids consumer-side
  * className overrides on primitive components.
  */
@@ -38,18 +49,29 @@ function resolveFill(tone, gradientId) {
             return `url(#${gradientId})`;
     }
 }
-export function SiteLogo({ size = "md", tone = "brand", title = "LetItRip.in", src, }) {
+export function SiteLogo({ size = "md", tone = "brand", 
+/*
+ * 🛑 No brand default. This read `title = "LetItRip.in"`, which put one
+ * consumer's name in a library primitive — and the SVG below ignored it
+ * anyway, drawing the literal `LetItRip` that no prop could reach.
+ *
+ * `"Site"` is deliberately bland: an unconfigured install should look
+ * obviously unconfigured rather than silently wear someone else's brand.
+ */
+title, wordmark, tld, src, }) {
+    const text = wordmark ?? title ?? "Site";
+    const accessibleTitle = title ?? (tld ? `${text}.${tld}` : text);
     const uid = useId();
     const gradientId = `${GRADIENT_ID_PREFIX}-${uid.replace(/:/g, "")}`;
     const heightCls = SIZE_HEIGHTS[size];
     if (src) {
-        return (_jsx(MediaImage, { src: src, alt: title, size: "thumbnail", objectFit: "contain", 
+        return (_jsx(MediaImage, { src: src, alt: accessibleTitle, size: "thumbnail", objectFit: "contain", 
             // backed by the catalogued `size` enum; no consumer-provided overrides.
             className: `block w-auto ${heightCls}` }));
     }
     const fill = resolveFill(tone, gradientId);
     const isGradient = tone === "brand";
-    return (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 214 56", role: "img", "aria-label": title, "data-testid": "site-logo", 
+    return (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 214 56", role: "img", "aria-label": accessibleTitle, "data-testid": "site-logo", 
         // backed by the catalogued `size` enum; no consumer-provided overrides.
-        className: `block w-auto ${heightCls}`, children: [_jsx("title", { children: title }), isGradient && (_jsx("defs", { children: _jsxs("linearGradient", { id: gradientId, x1: "0%", y1: "0%", x2: "100%", y2: "0%", children: [_jsx("stop", { offset: "0%", style: { stopColor: "var(--appkit-logo-stop-from)" } }), _jsx("stop", { offset: "55%", style: { stopColor: "var(--appkit-logo-stop-mid)" } }), _jsx("stop", { offset: "100%", style: { stopColor: "var(--appkit-logo-stop-to)" } })] }) })), _jsx("text", { x: "0", y: "44", fontFamily: "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", fontWeight: "800", fontSize: "44", letterSpacing: "-1.5", fill: fill, children: "LetItRip" }), _jsx("rect", { x: "169", y: "5", width: "43", height: "21", rx: "10.5", fill: fill, opacity: "0.12" }), _jsx("text", { x: "174", y: "21", fontFamily: "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", fontWeight: "700", fontSize: "15", letterSpacing: "0.2", fill: fill, children: ".in" })] }));
+        className: `block w-auto ${heightCls}`, children: [_jsx("title", { children: accessibleTitle }), isGradient && (_jsx("defs", { children: _jsxs("linearGradient", { id: gradientId, x1: "0%", y1: "0%", x2: "100%", y2: "0%", children: [_jsx("stop", { offset: "0%", style: { stopColor: "var(--appkit-logo-stop-from)" } }), _jsx("stop", { offset: "55%", style: { stopColor: "var(--appkit-logo-stop-mid)" } }), _jsx("stop", { offset: "100%", style: { stopColor: "var(--appkit-logo-stop-to)" } })] }) })), _jsx("text", { x: "0", y: "44", fontFamily: "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", fontWeight: "800", fontSize: "44", letterSpacing: "-1.5", fill: fill, children: text }), tld && (_jsxs(_Fragment, { children: [_jsx("rect", { x: "169", y: "5", width: "43", height: "21", rx: "10.5", fill: fill, opacity: "0.12" }), _jsxs("text", { x: "174", y: "21", fontFamily: "ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif", fontWeight: "700", fontSize: "15", letterSpacing: "0.2", fill: fill, children: [".", tld] })] }))] }));
 }

package/dist/ui/components/SiteMark.d.ts

@@ -11,7 +11,7 @@ export interface SiteMarkProps {
      * `"on-primary"` renders the mark in `var(--appkit-color-text)`.
      */
     tone?: SiteMarkTone;
-    /** Accessible title; defaults to "LetItRip.in". */
+    /** Accessible title. Defaults to the configured brand name. */
     title?: string;
     /**
      * Optional admin-uploaded image URL. When present, renders an `<MediaImage>`

package/dist/ui/components/SiteMark.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * LetItRip site mark — the icon glyph (distinct from the `SiteLogo` text
- * wordmark). Sourced from `public/logo.svg`'s path data, recolored to follow
+ * Site mark — the icon glyph (distinct from the `SiteLogo` text wordmark).
+ * Sourced from `public/logo.svg`'s path data, recolored to follow
  * the active theme via the same `--appkit-logo-stop-*` variables `SiteLogo`
  * uses, so a custom admin theme restyles both consistently.
  *
@@ -10,6 +10,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * className overrides on primitive components.
  */
 import { useId } from "react";
+import { getBrandName } from "../../core/brand-resolver.js";
 import { MediaImage } from "../../features/media/MediaImage.js";
 // An SVG <linearGradient> ID prefix, not a class — suffixed with useId()
 // and referenced as fill="url(#…)".
@@ -62,18 +63,32 @@ const MARK_TRANSFORMS = [
     "translate(123,146)",
     "translate(75,187)",
 ];
-export function SiteMark({ size = "md", tone = "brand", title = "LetItRip.in", src, }) {
+export function SiteMark({ size = "md", tone = "brand", 
+/*
+ * 🛑 Was `title = "LetItRip.in"` — one consumer's name as a library default.
+ *
+ * Unlike `SiteLogo`, this is NOT the unreachable-glyph bug: the mark is
+ * geometric paths with no text, so `title` really is only the accessible
+ * name. That makes it the quieter half of the same problem — a screen reader
+ * announced this marketplace on every install, and nothing on screen
+ * disagreed, so there was no way to notice.
+ *
+ * Resolved per render rather than at module load, so it reflects
+ * `configureBrand()` whenever that ran.
+ */
+title, src, }) {
+    const accessibleTitle = title ?? getBrandName();
     const uid = useId();
     const gradientId = `${GRADIENT_ID_PREFIX}-${uid.replace(/:/g, "")}`;
     const heightCls = SIZE_HEIGHTS[size];
     if (src) {
-        return (_jsx(MediaImage, { src: src, alt: title, size: "thumbnail", objectFit: "contain", 
+        return (_jsx(MediaImage, { src: src, alt: accessibleTitle, size: "thumbnail", objectFit: "contain", 
             // backed by the catalogued `size` enum; no consumer-provided overrides.
             className: `block w-auto ${heightCls}` }));
     }
     const fill = resolveFill(tone, gradientId);
     const isGradient = tone === "brand";
-    return (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 236 245", role: "img", "aria-label": title, "data-testid": "site-mark", 
+    return (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 236 245", role: "img", "aria-label": accessibleTitle, "data-testid": "site-mark", 
         // backed by the catalogued `size` enum; no consumer-provided overrides.
-        className: `block w-auto ${heightCls}`, children: [_jsx("title", { children: title }), isGradient && (_jsx("defs", { children: _jsxs("linearGradient", { id: gradientId, x1: "0%", y1: "0%", x2: "100%", y2: "100%", children: [_jsx("stop", { offset: "0%", style: { stopColor: "var(--appkit-logo-stop-from)" } }), _jsx("stop", { offset: "55%", style: { stopColor: "var(--appkit-logo-stop-mid)" } }), _jsx("stop", { offset: "100%", style: { stopColor: "var(--appkit-logo-stop-to)" } })] }) })), MARK_PATHS.map((d, i) => (_jsx("path", { d: d, fill: fill, transform: MARK_TRANSFORMS[i] }, i)))] }));
+        className: `block w-auto ${heightCls}`, children: [_jsx("title", { children: accessibleTitle }), isGradient && (_jsx("defs", { children: _jsxs("linearGradient", { id: gradientId, x1: "0%", y1: "0%", x2: "100%", y2: "100%", children: [_jsx("stop", { offset: "0%", style: { stopColor: "var(--appkit-logo-stop-from)" } }), _jsx("stop", { offset: "55%", style: { stopColor: "var(--appkit-logo-stop-mid)" } }), _jsx("stop", { offset: "100%", style: { stopColor: "var(--appkit-logo-stop-to)" } })] }) })), MARK_PATHS.map((d, i) => (_jsx("path", { d: d, fill: fill, transform: MARK_TRANSFORMS[i] }, i)))] }));
 }

package/dist/ui/components/Tabs.d.ts

@@ -7,6 +7,14 @@ export interface TabsProps {
     children?: React.ReactNode;
 }
 export interface TabsListProps {
+    /**
+     * Never collapse into a dropdown; let the tabs wrap onto a second line.
+     *
+     * For CONTENT tabs inside a section, where a dropdown reads as a stray form
+     * control. Navigation tab bars should leave this `false` — see the note in
+     * `TabsList`.
+     */
+    wrap?: boolean;
     className?: string;
     children?: React.ReactNode;
 }
@@ -30,7 +38,7 @@ export interface TabsContentProps {
     children?: React.ReactNode;
 }
 export declare function Tabs({ defaultValue, value, onChange, className, children, }: TabsProps): React.JSX.Element;
-export declare function TabsList({ className, children }: TabsListProps): React.JSX.Element;
+export declare function TabsList({ className, children, wrap }: TabsListProps): React.JSX.Element;
 export declare function TabsTrigger({ value, disabled, className, children, badge, }: TabsTriggerProps): React.JSX.Element;
 export declare function TabsContent({ value, className, children, }: TabsContentProps): React.JSX.Element | null;
 export default Tabs;

package/dist/ui/components/Tabs.js

@@ -27,7 +27,7 @@ export function Tabs({ defaultValue = "", value, onChange, className = "", child
     }), [active, onChange, value]);
     return (_jsx(TabsContext.Provider, { value: contextValue, children: _jsx("div", { className: className, "data-section": "tabs-div-614", children: children }) }));
 }
-export function TabsList({ className = "", children }) {
+export function TabsList({ className = "", children, wrap = false }) {
     const { active, setActive } = useContext(TabsContext);
     const shellRef = useRef(null);
     const rowRef = useRef(null);
@@ -47,7 +47,24 @@ export function TabsList({ className = "", children }) {
         onSelect: () => setActive(item.props.value),
     }));
     const signature = overflowItems.map((i) => `${i.id}:${i.label}:${i.count ?? ""}`).join("|");
-    const collapsed = useRowCollapse(shellRef, rowRef, signature);
+    const measured = useRowCollapse(shellRef, rowRef, signature);
+    /*
+     * 🛑 `wrap` OPTS OUT OF COLLAPSING ENTIRELY, and it exists because
+     * collapsing is only right for NAVIGATION.
+     *
+     * Owner, 2026-10-27: *"it makes sense for forms or navigations, but no
+     * sense for a homepage section's tabs to be coming down."* That is the
+     * correct distinction. A nav bar that collapses hides destinations behind
+     * one more tap, which is a fair trade on a phone. A content filter inside a
+     * section — the homepage FAQ's category tabs — collapses into a dropdown
+     * that looks like a form control sitting in the middle of a page, and the
+     * visitor cannot see at a glance what the section even contains.
+     *
+     * Wrapping is the right failure mode here: the tabs take a second line and
+     * stay visible. Default stays `false`, so every existing nav tab bar is
+     * untouched.
+     */
+    const collapsed = wrap ? false : measured;
     /*
      * Collapsed renders `OverflowRow` in its already-collapsed state rather than
      * the old `TabsNavSelect`, which was a native `<select>` — so the collapsed
@@ -62,7 +79,7 @@ export function TabsList({ className = "", children }) {
     if (collapsed) {
         return (_jsx("div", { ref: shellRef, className: className, children: _jsx(OverflowRow, { items: overflowItems, ariaLabel: "Tabs", activeId: active, alwaysCollapsed: true, searchPlaceholder: "Search tabs\u2026" }) }));
     }
-    return (_jsx("div", { ref: shellRef, children: _jsx(TabBarShell, { className: className, ariaLabel: "Tabs", activeKey: active, listRef: rowRef, children: children }) }));
+    return (_jsx("div", { ref: shellRef, children: _jsx(TabBarShell, { className: [className, wrap ? "appkit-tabs-list--wrap" : ""].filter(Boolean).join(" "), ariaLabel: "Tabs", activeKey: active, listRef: rowRef, children: children }) }));
 }
 export function TabsTrigger({ value, disabled, className = "", children, badge, }) {
     const { active, setActive } = useContext(TabsContext);

package/dist/ui/components/Tabs.style.css

@@ -290,3 +290,23 @@
   border-color: transparent;
   color: var(--appkit-tabs-ink-active);
 }
+
+/*
+ * Wrapping tab bar — `<TabsList wrap>`.
+ *
+ * 🛑 For CONTENT tabs inside a page section, never for navigation. The
+ * default list scrolls horizontally and collapses into a dropdown once it
+ * overflows, which is right for a nav bar on a phone and wrong in the middle
+ * of a homepage section: there it renders as a stray form control, and the
+ * visitor cannot see what the section contains without opening it.
+ *
+ * Wrapping keeps every tab visible on a second line. `overflow: visible` is
+ * required alongside `flex-wrap` — the base rule's `overflow-x: auto` would
+ * otherwise still clip the wrapped rows and reintroduce a scrollbar.
+ */
+.appkit-tabs-list--wrap {
+  flex-wrap: wrap;
+  overflow-x: visible;
+  overflow-y: visible;
+  scrollbar-width: auto;
+}

package/dist/ui/rich-text/RichText.d.ts

@@ -39,16 +39,4 @@ export interface RichTextProps {
      */
     charts?: boolean;
 }
-/**
- * RichText renders sanitised HTML from a CMS / ProseMirror output.
- *
- * Security: client-side DOM-based sanitiser strips disallowed tags/attrs.
- * For defence-in-depth, also sanitise on the server before storing.
- *
- * Usage:
- * ```tsx
- * <RichText html={blogPost.body} className="max-w-2xl" />
- * <RichText html={desc} copyableCode />
- * ```
- */
 export declare function RichText({ html, className, proseClass, copyableCode, highlightCode, charts, }: RichTextProps): import("react").JSX.Element;

package/dist/ui/rich-text/RichText.js

@@ -3,6 +3,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from "react";
 import { Div } from "../components/Div.js";
 import { normalizeRichTextHtml } from "../../utils/string.formatter.js";
+import { useSiteSettings } from "../../core/hooks/useSiteSettings.js";
 import { splitChartBlocks } from "./chart-blocks.js";
 import { ChartFromJson } from "../components/Chart.js";
 // --- Allowed HTML tags (safe subset — no script/object; iframe allowed for YouTube only) -------
@@ -182,9 +183,59 @@ function attachCopyButtons(container) {
  * <RichText html={desc} copyableCode />
  * ```
  */
+/**
+ * Unwrap every `<a>` whose destination the site has closed, keeping its text.
+ *
+ * 🛑 THIS IS WHERE THE LAST DEAD LINKS WERE, and why six page-level sweeps
+ * kept reporting "clean". Stored rich text is authored content that no page
+ * template owns: a crawl of the live site on 2026-10-27 found `/scams`,
+ * `/tools/authenticity` and `/blog` linked from the HOMEPAGE, and every one
+ * of them was inside an FAQ ANSWER. Grepping a page for marketplace words
+ * cannot see an href, and gating a section cannot see inside its prose.
+ *
+ * `RichText` is the single renderer for every stored HTML field on the site —
+ * FAQ answers, legal pages, blog bodies, product descriptions — so one filter
+ * here covers all of them.
+ *
+ * 🛑 UNWRAPPED, NOT DELETED. The sentence still reads: "the scam registry is
+ * the place to report it" keeps its words and loses its link. Removing the
+ * whole anchor would leave a gap mid-sentence, and removing the paragraph
+ * would silently delete an admin's copy.
+ *
+ * Prefix-matched on a `/`-delimited boundary, the same rule as every other
+ * gate — `/store` must not match `/stores`.
+ */
+function unwrapClosedLinks(html, closed) {
+    if (closed.length === 0 || typeof document === "undefined")
+        return html;
+    const container = document.createElement("div");
+    container.innerHTML = html;
+    let changed = false;
+    for (const a of Array.from(container.querySelectorAll("a[href]"))) {
+        const raw = a.getAttribute("href") ?? "";
+        if (!raw.startsWith("/"))
+            continue;
+        const path = raw.split(/[?#]/)[0].replace(/\/+$/, "") || "/";
+        // `/en/blog` -> `/blog`: an admin pasting out of the address bar stores
+        // the locale-prefixed form, which a raw comparison would miss.
+        const bare = path.replace(/^\/[a-z]{2}(?=\/)/, "");
+        const hit = closed.some((p) => bare === p || bare.startsWith(`${p}/`) || path === p || path.startsWith(`${p}/`));
+        if (!hit)
+            continue;
+        a.replaceWith(...Array.from(a.childNodes));
+        changed = true;
+    }
+    return changed ? container.innerHTML : html;
+}
 export function RichText({ html, className = "", proseClass = "prose max-w-none dark:prose-invert", copyableCode = false, highlightCode, charts = true, }) {
+    /*
+     * Fails OPEN: no settings yet, or a failed fetch, leaves every link intact.
+     * A transient error must not strip working links out of an admin's copy.
+     */
+    const { data: settings } = useSiteSettings();
+    const closedPrefixes = settings?.hiddenSurfacePrefixes ?? [];
     const safe = useMemo(() => {
-        const sanitized = sanitiseHtml(normalizeRichTextHtml(html));
+        const sanitized = unwrapClosedLinks(sanitiseHtml(normalizeRichTextHtml(html)), closedPrefixes);
         if (!highlightCode || typeof document === "undefined")
             return sanitized;
         const container = document.createElement("div");

package/dist/utils/date.formatter.d.ts

@@ -20,3 +20,23 @@ export declare function isSameMonth(a: Date | number, b: Date | number): boolean
 export declare function currentYear(): string;
 export declare function nowISO(): string;
 export declare function formatCustomDate(date: Date | string, format?: "short" | "medium" | "long" | "full"): string;
+/**
+ * Render a `YYYY-MM` period as "October 2026".
+ *
+ * Lifted from the consumer's `src/lib/format/inr.ts` (A7), where five
+ * ad-booking surfaces shared it.
+ *
+ * 🛑 `timeZone: "UTC"` is load-bearing and is NOT a default worth overriding.
+ * The period is a calendar month with no time in it, so constructing it as UTC
+ * midnight and formatting in the viewer's zone renders the PREVIOUS month for
+ * anyone west of UTC. India is UTC+5:30, so the bug is invisible to everyone
+ * testing it there — which is why the original carried this same note.
+ *
+ * 🛑 The locale was a hardcoded `"en-IN"` in the consumer copy. It now comes
+ * from the market profile, which is the one thing about that helper that was
+ * genuinely consumer-specific.
+ *
+ * Returns the input unchanged when it is not a parseable `YYYY-MM`, rather than
+ * rendering "Invalid Date" into a billing table.
+ */
+export declare function formatMonthLabel(period: string, locale?: string): string;

package/dist/utils/date.formatter.js

@@ -192,3 +192,28 @@ export function formatCustomDate(date, format = "medium") {
     const options = formatOptions[format] || formatOptions.medium;
     return dateObj.toLocaleDateString(getDefaultLocale(), options);
 }
+/**
+ * Render a `YYYY-MM` period as "October 2026".
+ *
+ * Lifted from the consumer's `src/lib/format/inr.ts` (A7), where five
+ * ad-booking surfaces shared it.
+ *
+ * 🛑 `timeZone: "UTC"` is load-bearing and is NOT a default worth overriding.
+ * The period is a calendar month with no time in it, so constructing it as UTC
+ * midnight and formatting in the viewer's zone renders the PREVIOUS month for
+ * anyone west of UTC. India is UTC+5:30, so the bug is invisible to everyone
+ * testing it there — which is why the original carried this same note.
+ *
+ * 🛑 The locale was a hardcoded `"en-IN"` in the consumer copy. It now comes
+ * from the market profile, which is the one thing about that helper that was
+ * genuinely consumer-specific.
+ *
+ * Returns the input unchanged when it is not a parseable `YYYY-MM`, rather than
+ * rendering "Invalid Date" into a billing table.
+ */
+export function formatMonthLabel(period, locale) {
+    const [y, m] = period.split("-").map(Number);
+    if (!Number.isFinite(y) || !Number.isFinite(m) || m < 1 || m > 12)
+        return period;
+    return new Date(Date.UTC(y, m - 1, 1)).toLocaleDateString(locale ?? getDefaultLocale(), { month: "long", year: "numeric", timeZone: "UTC" });
+}

package/dist/utils/number.formatter.d.ts

@@ -1,6 +1,31 @@
 /**
  * Number Formatting Utilities
  */
+/**
+ * Money for PROSE — notification bodies, error messages, log lines, chips.
+ *
+ * ## Why this exists beside `formatCurrency`
+ *
+ * 71 call sites interpolated a hardcoded symbol next to a bare number —
+ * `` `Minimum offer is ₹${bounds.min}` `` — which is wrong three ways at once:
+ * the symbol is baked in, the grouping is absent (`₹1000`, not `₹1,000`), and
+ * ~20 more files reached for `toLocaleString("en-IN")` with the locale
+ * hardcoded too. All three read from the market profile now, which the consumer
+ * already configures via `configureMarketDefaults()`.
+ *
+ * ## 🛑 Why not just use `formatCurrency`
+ *
+ * `Intl.NumberFormat` with `style: "currency"` forces the currency's standard
+ * fraction digits, so every whole amount becomes `₹1,000.00`. Rewriting 71
+ * strings to add `.00` to prices, offers and refunds that are whole amounts is
+ * a user-visible copy change dressed up as a refactor. This shows the
+ * fractional part only when there is one: `₹1,000` and `₹1,000.50`.
+ *
+ * `formatCurrency` keeps its job — the ISO-correct, locale-placed rendering for
+ * tabular and formal surfaces (invoices, statements). Use that where the form
+ * matters and this where the sentence does.
+ */
+export declare function formatMoney(amount: number, locale?: string): string;
 export declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
 export declare function formatNumber(num: number, locale?: string, options?: {
     decimals?: number;
@@ -13,3 +38,25 @@ export declare function formatCompactNumber(num: number): string;
 export declare function formatDecimal(num: number, decimals?: number): string;
 export declare function formatOrdinal(num: number): string;
 export declare function parseFormattedNumber(str: string): number;
+/**
+ * Whole currency units — no fractional digits — with locale grouping.
+ *
+ * `₹1,500` for 1499.50. Lifted from the consumer's `src/lib/format/inr.ts`
+ * (A5b/A7), where six `/user/*` and ad-booking pages had carried byte-identical
+ * private copies before it was consolidated there.
+ *
+ * ## 🛑 This is NOT `formatMoney`, and must not be collapsed into it
+ *
+ * `maximumFractionDigits: 0` is the whole point: this ROUNDS, so 1499.50
+ * renders `₹1,500`. `formatMoney` keeps the fractional part when there is one.
+ * Both are
+ * correct for their own surfaces — this one is for figures where the fraction
+ * is noise (a monthly ad spend, an order total in a summary row), and the
+ * surfaces using it show booking and order totals, so a change in rounding is
+ * a change in a number a buyer reads.
+ *
+ * Converging the two is a product decision about displayed money, not a
+ * de-duplication. The consumer's copy carried that warning for exactly this
+ * reason and it travels with the function.
+ */
+export declare function formatWholeMoney(amount: number, locale?: string): string;

package/dist/utils/number.formatter.js

@@ -1,7 +1,57 @@
 /**
  * Number Formatting Utilities
  */
-import { getDefaultCurrency, getDefaultLocale, } from "../core/baseline-resolver.js";
+import { getDefaultCurrency, getDefaultCurrencySymbol, getDefaultLocale, } from "../core/baseline-resolver.js";
+/**
+ * Money for PROSE — notification bodies, error messages, log lines, chips.
+ *
+ * ## Why this exists beside `formatCurrency`
+ *
+ * 71 call sites interpolated a hardcoded symbol next to a bare number —
+ * `` `Minimum offer is ₹${bounds.min}` `` — which is wrong three ways at once:
+ * the symbol is baked in, the grouping is absent (`₹1000`, not `₹1,000`), and
+ * ~20 more files reached for `toLocaleString("en-IN")` with the locale
+ * hardcoded too. All three read from the market profile now, which the consumer
+ * already configures via `configureMarketDefaults()`.
+ *
+ * ## 🛑 Why not just use `formatCurrency`
+ *
+ * `Intl.NumberFormat` with `style: "currency"` forces the currency's standard
+ * fraction digits, so every whole amount becomes `₹1,000.00`. Rewriting 71
+ * strings to add `.00` to prices, offers and refunds that are whole amounts is
+ * a user-visible copy change dressed up as a refactor. This shows the
+ * fractional part only when there is one: `₹1,000` and `₹1,000.50`.
+ *
+ * `formatCurrency` keeps its job — the ISO-correct, locale-placed rendering for
+ * tabular and formal surfaces (invoices, statements). Use that where the form
+ * matters and this where the sentence does.
+ */
+export function formatMoney(amount, locale) {
+    const resolvedLocale = locale ?? getDefaultLocale();
+    /*
+     * 🛑 0 decimals if integral, otherwise exactly 2 — NOT `min: 0, max: 2`.
+     *
+     * That first draft was wrong and `published-values.ts` caught it: with a
+     * floor of 0, `1499.5` renders "₹1,499.5", a money figure with one decimal
+     * place. The rule money actually wants is "no trailing .00 on a whole
+     * amount, but always both places when there is a fractional part" — exactly
+     * what the `formatRupees` this replaced encoded as
+     * `minimumFractionDigits: Number.isInteger(amount) ? 0 : 2`, and what its own
+     * docstring stated as `₹10`, `₹1,499.50`.
+     */
+    const fractionDigits = Number.isInteger(amount) ? 0 : 2;
+    const grouped = new Intl.NumberFormat(resolvedLocale, {
+        minimumFractionDigits: fractionDigits,
+        maximumFractionDigits: fractionDigits,
+    }).format(amount);
+    /*
+     * Symbol then number, not `Intl`'s currency placement. These strings are
+     * assembled into sentences that already read "₹500" in copy the team wrote,
+     * and a locale whose convention is "1 000,00 ₹" would reorder mid-sentence.
+     * A market that needs the symbol elsewhere overrides `currencySymbol`.
+     */
+    return `${getDefaultCurrencySymbol()}${grouped}`;
+}
 export function formatCurrency(amount, currency, locale) {
     const resolvedCurrency = currency ?? getDefaultCurrency();
     const resolvedLocale = locale ?? getDefaultLocale();
@@ -107,3 +157,31 @@ export function parseFormattedNumber(str) {
     const num = parseFloat(result);
     return isNegative ? -Math.abs(num) : num;
 }
+/**
+ * Whole currency units — no fractional digits — with locale grouping.
+ *
+ * `₹1,500` for 1499.50. Lifted from the consumer's `src/lib/format/inr.ts`
+ * (A5b/A7), where six `/user/*` and ad-booking pages had carried byte-identical
+ * private copies before it was consolidated there.
+ *
+ * ## 🛑 This is NOT `formatMoney`, and must not be collapsed into it
+ *
+ * `maximumFractionDigits: 0` is the whole point: this ROUNDS, so 1499.50
+ * renders `₹1,500`. `formatMoney` keeps the fractional part when there is one.
+ * Both are
+ * correct for their own surfaces — this one is for figures where the fraction
+ * is noise (a monthly ad spend, an order total in a summary row), and the
+ * surfaces using it show booking and order totals, so a change in rounding is
+ * a change in a number a buyer reads.
+ *
+ * Converging the two is a product decision about displayed money, not a
+ * de-duplication. The consumer's copy carried that warning for exactly this
+ * reason and it travels with the function.
+ */
+export function formatWholeMoney(amount, locale) {
+    return new Intl.NumberFormat(locale ?? getDefaultLocale(), {
+        style: "currency",
+        currency: getDefaultCurrency(),
+        maximumFractionDigits: 0,
+    }).format(amount);
+}

package/dist/validation/phone.validator.d.ts

@@ -6,4 +6,3 @@ export declare function normalizePhone(phone: string): string;
 export declare function formatPhone(phone: string, countryCode?: string): string;
 export declare function extractCountryCode(phone: string): string | null;
 export declare function isValidMobile(phone: string, phonePrefix?: string): boolean;
-export declare function isValidIndianPincode(pincode: string): boolean;

package/dist/validation/phone.validator.js

@@ -36,6 +36,20 @@ export function isValidMobile(phone, phonePrefix) {
     // Generic: 10-15 digit number
     return cleaned.length >= 10 && cleaned.length <= 15;
 }
-export function isValidIndianPincode(pincode) {
-    return /^\d{6}$/.test(pincode.trim());
-}
+/*
+ * 🛑 `isValidIndianPincode` was REMOVED in A6c. It hardcoded `/^\d{6}$/` — one
+ * country's postcode shape in a library meant to be jurisdiction-neutral — and
+ * had **zero callers**: the only reference anywhere was its own re-export from
+ * `index.ts`, so it was dead code on appkit's public surface.
+ *
+ * `constants/geo/countries.ts` is the live answer and a better one: 26 countries
+ * as DATA (`postalPattern`, `postalLabel`, `hasStates`, `dialCode`) behind
+ * `isValidPostalCode` / `postalPatternFor` / `postalLabelFor`, with 17 reader
+ * files. Its own header records the bug this function's shape causes —
+ * "a Canadian address was being held to `/^\d{6}$/`".
+ *
+ * That table is also why A6's proposed `IAddressValidationProvider` was not
+ * built: the AK2 row describing appkit as doing "pincode-only India validation"
+ * predates `countries.ts` and is stale. Postcode rules are a 26-row table, not
+ * 26 provider implementations.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohasinac/appkit",
-  "version": "4.69.1",
+  "version": "4.71.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -67,7 +67,12 @@
       "types": "./dist/contracts/registry.d.ts",
       "import": "./dist/contracts/registry.js"
     },
-    "./core/baseline-resolver": {
+    "./cli": {
+   "types": "./dist/cli/index.d.ts",
+   "import": "./dist/cli/index.js",
+   "require": "./dist/cli/index.js"
+  },
+  "./core/baseline-resolver": {
       "types": "./dist/core/baseline-resolver.d.ts",
       "import": "./dist/core/baseline-resolver.js"
     },
@@ -83,7 +88,15 @@
       "types": "./dist/providers/email-resend/index.d.ts",
       "import": "./dist/providers/email-resend/index.js"
     },
-    "./providers/storage-firebase": {
+    "./providers/tax-india-gst": {
+   "types": "./dist/providers/tax-india-gst/index.d.ts",
+   "import": "./dist/providers/tax-india-gst/index.js"
+  },
+  "./providers/shipping-shiprocket": {
+   "types": "./dist/providers/shipping-shiprocket/index.d.ts",
+   "import": "./dist/providers/shipping-shiprocket/index.js"
+  },
+  "./providers/storage-firebase": {
       "types": "./dist/providers/storage-firebase/index.d.ts",
       "import": "./dist/providers/storage-firebase/index.js"
     },
@@ -317,6 +330,7 @@
   },
   "files": [
     "dist",
+    "PROVIDERS.md",
     "tsconfig.base.json",
     "scripts/sieve-audit.mjs",
     "scripts/audit-violations.mjs",

package/dist/features/about/components/AboutView.d.ts

@@ -1,30 +0,0 @@
-import React from "react";
-import type { AboutHowItem, AboutValueItem, AboutMilestone, AboutTeamMember } from "../schemas/firestore";
-export type { AboutHowItem, AboutValueItem, AboutMilestone, AboutTeamMember } from "../schemas/firestore";
-export interface AboutViewProps {
-    labels?: {
-        title?: string;
-        subtitle?: string;
-        missionTitle?: string;
-        missionText?: string;
-        howItWorksTitle?: string;
-        valuesTitle?: string;
-        valuesSubtitle?: string;
-        /** When set, renders a link from the values section through to `/ethics`. */
-        valuesLinkLabel?: string;
-        milestonesTitle?: string;
-        teamTitle?: string;
-        teamSubtitle?: string;
-        ctaTitle?: string;
-        ctaSell?: string;
-        ctaShop?: string;
-    };
-    howItems?: AboutHowItem[];
-    valueItems?: AboutValueItem[];
-    milestones?: AboutMilestone[];
-    teamMembers?: AboutTeamMember[];
-    ctaBannerClass?: string;
-    /** Render the CTA action buttons  */
-    renderCtaButtons?: () => React.ReactNode;
-}
-export declare function AboutView({ labels, howItems, valueItems, milestones, teamMembers, ctaBannerClass, renderCtaButtons, }: AboutViewProps): React.JSX.Element;