@tabres/react 1.0.52 → 1.0.53

package/dist/utils/models/index.d.ts

@@ -11,6 +11,7 @@ export * from "../modules/table/models";
 export * from "../modules/user/models";
 export * from "../modules/category/models";
 export * from "../modules/menu/models";
+export * from "../modules/localization/models";
 export * from "../modules/video/models";
 export * from "../modules/pos/models";
 export * from "../components/PublicMenu/ProductsGridItem/ProductsGridItem.types";

package/dist/utils/modules/addon/models.d.ts

@@ -1,3 +1,4 @@
+import { LocalizedText } from "src/modules/localization/models";
 export declare enum MenuAddonSelectType {
     SINGLE = "SINGLE",
     MULTIPLE = "MULTIPLE"
@@ -12,7 +13,7 @@ export interface MenuAddonOption {
      * supplied (e.g. addon detached from a branch tax setup).
      */
     listingPrice: number;
-    title: Record<string, string>;
+    title: LocalizedText;
     remove?: boolean;
 }
 export interface MenuAddon {
@@ -20,5 +21,5 @@ export interface MenuAddon {
     selectType: MenuAddonSelectType;
     options: MenuAddonOption[];
     businessId?: number;
-    title: Record<string, string>;
+    title: LocalizedText;
 }

package/dist/utils/modules/addon/utils.d.ts

@@ -1,5 +1,10 @@
 import { MenuAddon, MenuAddonOption } from "./models";
-export declare const getAddonTranslation: (addon: MenuAddon, language: string) => string;
-export declare const getAddonOptionTranslation: (option: MenuAddonOption, language: string) => string;
+/**
+ * An addon's title, or one of its options'.
+ *
+ * Both sides of an addon carry the same `LocalizedText` shape and fall back the
+ * same way, so one resolver serves the group heading ("Size") and the choices
+ * under it ("Small", "Large") alike.
+ */
+export declare const getAddonTitle: (addon: MenuAddon | MenuAddonOption | null | undefined, language: string) => string;
 export declare const getOptionTitles: (options: MenuAddonOption[], optionIds: number | number[], language: string) => string;
-export declare const getAddonTitle: (addon: MenuAddon, language: string) => string;

package/dist/utils/modules/branch/models.d.ts

@@ -1,3 +1,4 @@
+import { LocalizedText } from "src/modules/localization/models";
 export type BranchWorkHour = {
     openAt: string;
     closeAt: string;
@@ -76,7 +77,7 @@ export type BranchTax = {
     businessId: number;
     branchId: number;
     taxClassId?: number;
-    name: Record<string, string>;
+    name: LocalizedText;
     rate: number;
     type: BranchTaxType;
     isActive: boolean;

package/dist/utils/modules/category/models.d.ts

@@ -1,3 +1,4 @@
+import { LocalizedText } from "src/modules/localization/models";
 export interface Category {
     id: number;
     businessId: number;
@@ -5,7 +6,7 @@ export interface Category {
      * Category name keyed by language code, e.g. { en: "Drinks", az: "İçkilər" }.
      * Mirrors the `name` JSONB column returned by the API
      */
-    name: Record<string, string>;
+    name: LocalizedText;
     /** Display order within the business; lower comes first. */
     position: number;
 }

package/dist/utils/modules/localization/models.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A field the business authors once per language, keyed by language code —
+ * e.g. `{ en: "Drinks", az: "İçkilər" }`. Category names, addon titles, tax
+ * labels and product copy all arrive in this shape.
+ *
+ * The map travels whole rather than pre-resolved because the public menu is
+ * served from one language-agnostic cached payload: the guest switches
+ * language locally and every row has to relabel without a refetch.
+ */
+export type LocalizedText = Record<string, string>;

package/dist/utils/modules/localization/utils.d.ts

@@ -0,0 +1,22 @@
+import { LocalizedText } from "./models";
+/**
+ * `source` in `language`, falling back when the business left that language
+ * blank.
+ *
+ * A menu is authored language by language and is rarely finished in all of
+ * them — a dish gets its Azerbaijani name today and its English one next week.
+ * A name in the wrong language still tells the guest what they are looking at,
+ * which an empty row does not, so a missing, null or empty value falls through
+ * to the next best language instead of rendering nothing.
+ */
+export declare const getLocalizedText: (source: LocalizedText | null | undefined, language?: string) => string;
+/**
+ * `source` in `language`, resolved field by field.
+ *
+ * Product copy arrives as a record per language — `{ name, description }` — and
+ * the fields are filled in independently: a dish is named in Turkish long
+ * before anyone writes its Turkish description. Falling back on the record as a
+ * whole would throw away the translated name the moment the description was
+ * blank, so each field falls back on its own.
+ */
+export declare const getLocalizedContent: <T extends object>(source: Record<string, T> | null | undefined, language?: string) => T;

package/dist/utils/modules/menu/models.d.ts

@@ -4,6 +4,7 @@ import * as categoryModels from "src/modules/category/models";
 import * as businessModels from "src/modules/business/models";
 import * as tableModels from "src/modules/table/models";
 import * as videoModels from "src/modules/video/models";
+import { LocalizedText } from "src/modules/localization/models";
 export interface CategoryProductMap extends categoryModels.Category {
     products: productModels.Product[];
 }
@@ -30,8 +31,8 @@ export interface MenuDesign {
     menuPageTextColor: string;
     createdAt?: string;
     updatedAt?: string;
-    headerText?: Record<string, string>;
-    footerText?: Record<string, string>;
+    headerText?: LocalizedText;
+    footerText?: LocalizedText;
 }
 export interface PublicMenuData {
     business: businessModels.Business;

package/dist/utils/modules/order/models.d.ts

@@ -1,5 +1,6 @@
 import * as customerModels from "../customer/models";
 import * as productModels from "../product/models";
+import { LocalizedText } from "src/modules/localization/models";
 export declare enum OrderType {
     DINE_IN = "DINE_IN",
     PICK_UP = "PICK_UP",
@@ -178,7 +179,7 @@ export interface CalculatePreviewRequest {
 }
 export interface CalculatePreviewTax {
     branchTaxId: number;
-    name: Record<string, string>;
+    name: LocalizedText;
     rate: number;
     type: "percentage" | "fixed";
     addToListingPrice: boolean;

package/dist/utils/modules/product/models.d.ts

@@ -1,4 +1,5 @@
 import { MenuAddon } from "../addon/models";
+import { LocalizedText } from "src/modules/localization/models";
 export interface LocalizedContent {
     name: string;
     description: string;
@@ -13,7 +14,7 @@ export interface ProductVariant {
      */
     listingPrice: number;
     /** Title keyed by language code, e.g. { en: "Large", az: "Böyük" }. */
-    title: Record<string, string>;
+    title: LocalizedText;
     productId?: number;
     remove?: boolean;
 }
@@ -65,7 +66,7 @@ export interface Product {
 export interface AllergenDetail {
     code: AllergenCode;
     /** Label keyed by language code, e.g. `{ en: "Gluten", az: "Qlüten" }`. */
-    translations: Record<string, string>;
+    translations: LocalizedText;
 }
 /**
  * An allergen code as it comes off the wire. Deliberately open: the API owns

package/dist/utils/modules/product/utils.d.ts

@@ -1,5 +1,5 @@
-import { AllergenCode, LocalizedContent, Product, ProductVariant, SellUnitType } from "./models";
 import { MenuAddon } from "src/modules/addon/models";
+import { AllergenCode, LocalizedContent, Product, ProductVariant, SellUnitType } from "./models";
 export declare const getProductTranslation: (product: Pick<Product, "translations">, language: string) => LocalizedContent;
 export declare const getProductVariant: (product: Pick<Product, "variants">, variantId: number) => ProductVariant;
 export declare const getProductVariantTranslation: (variant: ProductVariant, language: string) => string;

package/dist/utils/utils/index.d.ts

@@ -6,5 +6,6 @@ export * from "../modules/feature/utils";
 export * from "../modules/view/utils";
 export * from "../modules/category/utils";
 export * from "../modules/menu/utils";
+export * from "../modules/localization/utils";
 export * from "../modules/user/utils";
 export * from "../modules/pos/utils";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tabres/react",
-	"version": "1.0.52",
+	"version": "1.0.53",
 	"description": "React Library by tabres.com",
 	"main": "dist/index.js",
 	"module": "dist/index.esm.js",