@mohasinac/appkit 2.4.11 → 2.5.0

package/dist/ui/rich-text/RichText.style.css

@@ -7,37 +7,37 @@
  * these rules act as a reliable fallback with the same values.
  * -------------------------------------------------------------------------- */
 .appkit-rich-text-editor {
-  background: var(--appkit-color-surface, #ffffff);
-  border: 1px solid var(--appkit-color-border, #e4e4e7);
+  background: var(--appkit-color-surface);
+  border: 1px solid var(--appkit-color-border);
   border-radius: 0.5rem;
 }
 
 .dark .appkit-rich-text-editor {
-  background: #0f172a;    /* slate-900 = --appkit-color-surface dark */
-  border-color: #334155;  /* slate-700 = --appkit-color-border dark */
+  background: var(--appkit-color-surface);
+  border-color: var(--appkit-color-border);
 }
 
 .appkit-rich-text-editor__toolbar {
-  border-bottom: 1px solid var(--appkit-color-border, #e4e4e7);
+  border-bottom: 1px solid var(--appkit-color-border);
 }
 
 .dark .appkit-rich-text-editor__toolbar {
-  border-bottom-color: #334155;
+  border-bottom-color: var(--appkit-color-border);
 }
 
 .appkit-rich-text-editor__btn {
-  border: 1px solid #e4e4e7;
-  color: #3f3f46;
+  border: 1px solid var(--appkit-color-border);
+  color: var(--appkit-color-zinc-700);
   border-radius: 0.375rem;
 }
 
 .dark .appkit-rich-text-editor__btn {
-  border-color: #475569;
-  color: #e2e8f0;
+  border-color: var(--appkit-color-slate-600);
+  color: var(--appkit-color-slate-200);
 }
 
 .dark .appkit-rich-text-editor__btn:hover {
-  background-color: #1e293b;
+  background-color: var(--appkit-color-slate-800);
 }
 
 
@@ -73,14 +73,14 @@
   padding: 1rem 1.25rem;
   overflow-x: auto;
   font-size: 0.875em;
-  line-height: 1.7;
-  background-color: #1e293b;                     /* slate-800 — always dark */
-  color: #e2e8f0;                                /* slate-200 */
+  line-height: var(--appkit-leading-relaxed);
+  background-color: var(--appkit-color-slate-800);  /* always dark */
+  color: var(--appkit-color-slate-200);
   border: 1px solid rgba(51, 65, 85, 0.6);
 }
 
 .dark .appkit-rich-text pre {
-  background-color: #0f172a;                     /* slate-900 */
+  background-color: var(--appkit-color-surface);
   border-color: rgba(30, 41, 59, 0.8);
 }
 
@@ -91,14 +91,14 @@
   margin: 1.25rem 0;
   border-radius: 0 0.375rem 0.375rem 0;
   background-color: rgba(53, 112, 252, 0.06);
-  color: #3f3f46;                                /* zinc-700 */
+  color: var(--appkit-color-zinc-700);
   font-style: italic;
 }
 
 .dark .appkit-rich-text blockquote {
   border-left-color: #f063b9;                    /* secondary-400 */
   background-color: rgba(240, 99, 185, 0.06);
-  color: #a1a1aa;                                /* zinc-400 */
+  color: var(--appkit-color-text-faint);
 }
 
 /* --- Mark / Highlight ----------------------------------------------------- */
@@ -111,7 +111,7 @@
 
 .dark .appkit-rich-text mark {
   background-color: rgba(101, 196, 8, 0.35);
-  color: #f4f4f5;                               /* zinc-100 */
+  color: var(--appkit-color-zinc-100);
 }
 
 /* --- Horizontal rule ------------------------------------------------------ */
@@ -157,37 +157,37 @@
   font-size: 0.9em;
   overflow: hidden;
   border-radius: 0.5rem;
-  border: 1px solid #e4e4e7;                    /* zinc-200 */
+  border: 1px solid var(--appkit-color-border);
 }
 
 .dark .appkit-rich-text table {
-  border-color: #334155;                        /* slate-700 */
+  border-color: var(--appkit-color-border);
 }
 
 .appkit-rich-text th {
-  background-color: #f4f4f5;                    /* zinc-100 */
-  color: #18181b;                               /* zinc-900 */
+  background-color: var(--appkit-color-zinc-100);
+  color: var(--appkit-color-text);
   font-weight: 600;
   padding: 0.6rem 0.875rem;
   text-align: left;
-  border-bottom: 1px solid #e4e4e7;
+  border-bottom: 1px solid var(--appkit-color-border);
 }
 
 .dark .appkit-rich-text th {
-  background-color: #1e293b;                    /* slate-800 */
-  color: #f4f4f5;                               /* zinc-100 */
-  border-bottom-color: #334155;
+  background-color: var(--appkit-color-slate-800);
+  color: var(--appkit-color-zinc-100);
+  border-bottom-color: var(--appkit-color-border);
 }
 
 .appkit-rich-text td {
   padding: 0.55rem 0.875rem;
-  border-bottom: 1px solid #f4f4f5;            /* zinc-100 */
-  color: #3f3f46;                               /* zinc-700 */
+  border-bottom: 1px solid var(--appkit-color-zinc-100);
+  color: var(--appkit-color-zinc-700);
 }
 
 .dark .appkit-rich-text td {
-  border-bottom-color: #1e293b;                 /* slate-800 */
-  color: #a1a1aa;                               /* zinc-400 */
+  border-bottom-color: var(--appkit-color-slate-800);
+  color: var(--appkit-color-text-faint);
 }
 
 .appkit-rich-text tr:last-child td {
@@ -210,13 +210,13 @@
 .appkit-rich-text figcaption {
   margin-top: 0.5rem;
   font-size: 0.8em;
-  color: #71717a;                               /* zinc-500 */
+  color: var(--appkit-color-zinc-500);
   text-align: center;
   font-style: italic;
 }
 
 .dark .appkit-rich-text figcaption {
-  color: #71717a;                               /* zinc-500 */
+  color: var(--appkit-color-zinc-500);
 }
 
 /* --- Images --------------------------------------------------------------- */
@@ -233,7 +233,7 @@
 .appkit-rich-text h4,
 .appkit-rich-text h5,
 .appkit-rich-text h6 {
-  color: #18181b;                               /* zinc-900 */
+  color: var(--appkit-color-text);
   font-weight: 700;
   line-height: 1.25;
   margin-top: 1.5em;
@@ -246,28 +246,28 @@
 .dark .appkit-rich-text h4,
 .dark .appkit-rich-text h5,
 .dark .appkit-rich-text h6 {
-  color: #fafafa;                               /* zinc-50 */
+  color: var(--appkit-color-text);
 }
 
 /* --- Body text fallback when not inside a prose wrapper ------------------- */
 .appkit-rich-text p {
-  color: #3f3f46;                               /* zinc-700 */
+  color: var(--appkit-color-zinc-700);
 }
 
 .dark .appkit-rich-text p {
-  color: #a1a1aa;                               /* zinc-400 */
+  color: var(--appkit-color-text-faint);
 }
 
 /* --- Lists ---------------------------------------------------------------- */
 .appkit-rich-text ul,
 .appkit-rich-text ol {
   padding-left: 1.5rem;
-  color: #3f3f46;
+  color: var(--appkit-color-zinc-700);
 }
 
 .dark .appkit-rich-text ul,
 .dark .appkit-rich-text ol {
-  color: #a1a1aa;
+  color: var(--appkit-color-text-faint);
 }
 
 /* --- Ins / Del ------------------------------------------------------------ */
@@ -283,10 +283,10 @@
 
 .appkit-rich-text del {
   text-decoration: line-through;
-  color: #71717a;
+  color: var(--appkit-color-zinc-500);
   opacity: 0.75;
 }
 
 .dark .appkit-rich-text del {
-  color: #52525b;
+  color: var(--appkit-color-zinc-600);
 }

package/dist/utils/index.d.ts

@@ -14,4 +14,5 @@ export * from "./animation.helper";
 export * from "./color.helper";
 export * from "./business-day";
 export * from "./schema-ui";
+export * from "./listing-params";
 export { splitCartIntoOrderGroups, type OrderType, type OrderGroup, } from "../features/orders/utils/order-splitter";

package/dist/utils/index.js

@@ -14,5 +14,6 @@ export * from "./animation.helper";
 export * from "./color.helper";
 export * from "./business-day";
 export * from "./schema-ui";
+export * from "./listing-params";
 // Re-export order utilities for checkout flows
 export { splitCartIntoOrderGroups, } from "../features/orders/utils/order-splitter";

package/dist/utils/listing-params.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Standardised listing-API param reader (Q2 — S12).
+ *
+ * All public listing routes (/api/products, /api/pre-orders, /api/stores,
+ * /api/auctions, and the per-store nested variants) accept short canonical
+ * names:
+ *
+ *   f      — filters (Sieve filter string)
+ *   s      — sort  (Sieve sort string, e.g. "-createdAt")
+ *   p      — page  (1-based)
+ *   ps     — pageSize
+ *   q      — full-text search query
+ *   cursor — opaque pagination cursor (S13 / listingProcessor)
+ *
+ * Old verbose names (`filters`, `sorts`/`sort`, `page`, `pageSize`, `q`,
+ * `cursor`) remain accepted for backwards compatibility. When both forms are
+ * present the SHORT form wins (clients should migrate to the short form).
+ *
+ * The reader does NOT enforce any defaults — callers pass their own (e.g.
+ * default sort, page size) so this helper stays a pure URL → values map.
+ */
+export declare const LISTING_PARAM_NAMES: {
+    /** Filters (Sieve-formatted): `field==value,otherField>=value` */
+    readonly filters: {
+        readonly short: "f";
+        readonly long: "filters";
+    };
+    /** Sort string: `-createdAt`, `price`, etc. */
+    readonly sorts: {
+        readonly short: "s";
+        readonly long: "sorts";
+        readonly legacy: "sort";
+    };
+    /** Page number, 1-based. */
+    readonly page: {
+        readonly short: "p";
+        readonly long: "page";
+    };
+    /** Page size. */
+    readonly pageSize: {
+        readonly short: "ps";
+        readonly long: "pageSize";
+    };
+    /** Full-text search query. */
+    readonly q: {
+        readonly short: "q";
+        readonly long: "q";
+    };
+    /** Opaque pagination cursor (S13). */
+    readonly cursor: {
+        readonly short: "cursor";
+        readonly long: "cursor";
+    };
+};
+export interface ListingParams {
+    /** Sieve filter string, or null when neither short nor long form is set. */
+    filters: string | null;
+    /** Sort string (short `s` > long `sorts` > legacy `sort`). */
+    sorts: string | null;
+    /** Page number, or null when not set. Caller picks the default. */
+    page: number | null;
+    /** Page size, or null when not set. */
+    pageSize: number | null;
+    /** Full-text search query. */
+    q: string | null;
+    /** Opaque pagination cursor. */
+    cursor: string | null;
+}
+/**
+ * Same precedence as parseListingParams but reads from a Next.js
+ * Server-Component `searchParams` object (`Record<string, string | string[]>`).
+ * Convenience wrapper so SSR listing pages don't have to construct a URL.
+ */
+export declare function parseListingSearchParams(searchParams: Record<string, string | string[] | undefined> | undefined): ListingParams;
+/**
+ * Parse a URL into the standard listing params bag. Returns nulls for keys
+ * absent in the URL — callers apply their own defaults.
+ */
+export declare function parseListingParams(url: URL): ListingParams;
+/**
+ * Build a query string using the short canonical names. Mirrors
+ * `parseListingParams` so a round-trip through URL never loses precedence.
+ *
+ * Pass `undefined`/`null`/empty-string for any key you don't want serialised.
+ */
+export declare function serializeListingParams(params: Partial<ListingParams>, extra?: Record<string, string | number | undefined | null>): string;

package/dist/utils/listing-params.js

@@ -0,0 +1,121 @@
+/**
+ * Standardised listing-API param reader (Q2 — S12).
+ *
+ * All public listing routes (/api/products, /api/pre-orders, /api/stores,
+ * /api/auctions, and the per-store nested variants) accept short canonical
+ * names:
+ *
+ *   f      — filters (Sieve filter string)
+ *   s      — sort  (Sieve sort string, e.g. "-createdAt")
+ *   p      — page  (1-based)
+ *   ps     — pageSize
+ *   q      — full-text search query
+ *   cursor — opaque pagination cursor (S13 / listingProcessor)
+ *
+ * Old verbose names (`filters`, `sorts`/`sort`, `page`, `pageSize`, `q`,
+ * `cursor`) remain accepted for backwards compatibility. When both forms are
+ * present the SHORT form wins (clients should migrate to the short form).
+ *
+ * The reader does NOT enforce any defaults — callers pass their own (e.g.
+ * default sort, page size) so this helper stays a pure URL → values map.
+ */
+export const LISTING_PARAM_NAMES = {
+    /** Filters (Sieve-formatted): `field==value,otherField>=value` */
+    filters: { short: "f", long: "filters" },
+    /** Sort string: `-createdAt`, `price`, etc. */
+    sorts: { short: "s", long: "sorts", legacy: "sort" },
+    /** Page number, 1-based. */
+    page: { short: "p", long: "page" },
+    /** Page size. */
+    pageSize: { short: "ps", long: "pageSize" },
+    /** Full-text search query. */
+    q: { short: "q", long: "q" },
+    /** Opaque pagination cursor (S13). */
+    cursor: { short: "cursor", long: "cursor" },
+};
+function readShortFirst(url, short, long, legacy) {
+    return (url.searchParams.get(short) ??
+        url.searchParams.get(long) ??
+        (legacy ? url.searchParams.get(legacy) : null));
+}
+function readNumber(value) {
+    if (value == null)
+        return null;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Same precedence as parseListingParams but reads from a Next.js
+ * Server-Component `searchParams` object (`Record<string, string | string[]>`).
+ * Convenience wrapper so SSR listing pages don't have to construct a URL.
+ */
+export function parseListingSearchParams(searchParams) {
+    const sp = searchParams ?? {};
+    function get(key) {
+        const v = sp[key];
+        if (v == null)
+            return null;
+        return Array.isArray(v) ? v[0] ?? null : v;
+    }
+    function firstOf(...keys) {
+        for (const k of keys) {
+            if (!k)
+                continue;
+            const v = get(k);
+            if (v != null)
+                return v;
+        }
+        return null;
+    }
+    return {
+        filters: firstOf(LISTING_PARAM_NAMES.filters.short, LISTING_PARAM_NAMES.filters.long),
+        sorts: firstOf(LISTING_PARAM_NAMES.sorts.short, LISTING_PARAM_NAMES.sorts.long, LISTING_PARAM_NAMES.sorts.legacy),
+        page: readNumber(firstOf(LISTING_PARAM_NAMES.page.short, LISTING_PARAM_NAMES.page.long)),
+        pageSize: readNumber(firstOf(LISTING_PARAM_NAMES.pageSize.short, LISTING_PARAM_NAMES.pageSize.long)),
+        q: firstOf(LISTING_PARAM_NAMES.q.short, LISTING_PARAM_NAMES.q.long),
+        cursor: firstOf(LISTING_PARAM_NAMES.cursor.short, LISTING_PARAM_NAMES.cursor.long),
+    };
+}
+/**
+ * Parse a URL into the standard listing params bag. Returns nulls for keys
+ * absent in the URL — callers apply their own defaults.
+ */
+export function parseListingParams(url) {
+    return {
+        filters: readShortFirst(url, LISTING_PARAM_NAMES.filters.short, LISTING_PARAM_NAMES.filters.long),
+        sorts: readShortFirst(url, LISTING_PARAM_NAMES.sorts.short, LISTING_PARAM_NAMES.sorts.long, LISTING_PARAM_NAMES.sorts.legacy),
+        page: readNumber(readShortFirst(url, LISTING_PARAM_NAMES.page.short, LISTING_PARAM_NAMES.page.long)),
+        pageSize: readNumber(readShortFirst(url, LISTING_PARAM_NAMES.pageSize.short, LISTING_PARAM_NAMES.pageSize.long)),
+        q: readShortFirst(url, LISTING_PARAM_NAMES.q.short, LISTING_PARAM_NAMES.q.long),
+        cursor: readShortFirst(url, LISTING_PARAM_NAMES.cursor.short, LISTING_PARAM_NAMES.cursor.long),
+    };
+}
+/**
+ * Build a query string using the short canonical names. Mirrors
+ * `parseListingParams` so a round-trip through URL never loses precedence.
+ *
+ * Pass `undefined`/`null`/empty-string for any key you don't want serialised.
+ */
+export function serializeListingParams(params, extra) {
+    const usp = new URLSearchParams();
+    if (params.filters)
+        usp.set(LISTING_PARAM_NAMES.filters.short, params.filters);
+    if (params.sorts)
+        usp.set(LISTING_PARAM_NAMES.sorts.short, params.sorts);
+    if (params.page != null)
+        usp.set(LISTING_PARAM_NAMES.page.short, String(params.page));
+    if (params.pageSize != null)
+        usp.set(LISTING_PARAM_NAMES.pageSize.short, String(params.pageSize));
+    if (params.q)
+        usp.set(LISTING_PARAM_NAMES.q.short, params.q);
+    if (params.cursor)
+        usp.set(LISTING_PARAM_NAMES.cursor.short, params.cursor);
+    if (extra) {
+        for (const [k, v] of Object.entries(extra)) {
+            if (v == null || v === "")
+                continue;
+            usp.set(k, String(v));
+        }
+    }
+    return usp.toString();
+}

package/dist/validation/schemas.d.ts

@@ -6,15 +6,15 @@ export declare const paginationQuerySchema: z.ZodObject<{
     sortOrder: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
     search: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    sortOrder: "asc" | "desc";
     page: number;
-    sortOrder: "desc" | "asc";
     limit: number;
     search?: string | undefined;
     sortBy?: string | undefined;
 }, {
+    sortOrder?: "asc" | "desc" | undefined;
     search?: string | undefined;
     page?: number | undefined;
-    sortOrder?: "desc" | "asc" | undefined;
     limit?: number | undefined;
     sortBy?: string | undefined;
 }>;
@@ -34,17 +34,17 @@ export declare const addressSchema: z.ZodObject<{
     pincode: z.ZodEffects<z.ZodString, string, string>;
     country: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    state: string;
     country: string;
+    state: string;
+    street: string;
     city: string;
     pincode: string;
-    street: string;
 }, {
-    state: string;
     country: string;
+    state: string;
+    street: string;
     city: string;
     pincode: string;
-    street: string;
 }>;
 export declare const resetPasswordSchema: z.ZodObject<{
     token: z.ZodString;
@@ -117,106 +117,106 @@ export declare const cropDataSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.Zo
     minWidth: z.ZodOptional<z.ZodNumber>;
     minHeight: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }>, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }>, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }>, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;
 }, {
-    height: number;
     width: number;
+    height: number;
     x: number;
     y: number;
     sourceUrl: string;
+    minHeight?: number | undefined;
     rotation?: number | undefined;
     minWidth?: number | undefined;
     quality?: number | undefined;
-    minHeight?: number | undefined;
     aspectRatio?: string | undefined;
     outputFolder?: string | undefined;
     outputFormat?: "webp" | "jpeg" | "png" | undefined;