@ticketmaster/tm-global-address 0.6.0 → 0.8.0

package/dist/i18n/locales/sv-se.json.d.ts

@@ -0,0 +1,159 @@
+declare const _default: {
+  "form": {
+    "firstName": "Förnamn",
+    "lastName": "Efternamn",
+    "address1": "Adressrad 1",
+    "address2": "Adressrad 2",
+    "city": "Stad",
+    "postal": "Postnummer",
+    "stateCode": "Stat / Provins",
+    "country": "Land",
+    "phoneNumber": "Telefonnummer",
+    "dialCode": "Uppringningskod",
+    "defaultAddress": "Gör det här till mitt förvalda kort",
+    "countryPlaceholder": "Please select",
+    "stateCodePlaceholder": "Välj stat eller provins",
+    "phoneNumberPlaceholder": "Ange telefonnummer",
+    "addressHeading": "Faktura och leveransadress",
+    "addNewAddress": "Lägg till ny adress",
+    "confirm": "Bekräfta adress",
+    "cancel": "Avbryt",
+    "editButton": "Redigera",
+    "deleteButton": "Ta bort",
+    "defaultBadge": "Standard",
+    "makeDefault": "Ange som standardadress",
+    "countrySelectPlaceholder": "Välj land"
+  },
+  "validation": {
+    "FIELD_REQUIRED": "{{field}} is required",
+    "FIELD_TOO_LONG": "Får vara {{maxLength}} tecken som längst",
+    "FIELD_TOO_SHORT": "Får vara {{minLength}} tecken som längst",
+    "FIELD_INVALID_FORMAT": "Please enter a valid {{field}}",
+    "FIELD_INVALID_CHARACTERS": "{{field}} contains invalid characters",
+    "POSTAL_CODE_MISMATCH": "Postal code does not match the selected {{stateLabel}}"
+  },
+  "country": {
+    "AT": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "AU": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "Förort",
+      "postal": "Postnummer"
+    },
+    "CA": {
+      "stateCode": "Provins",
+      "stateCodePlaceholder": "Välj provins",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "CZ": {
+      "stateCode": "Region",
+      "stateCodePlaceholder": "Välj region",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "DE": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "DK": {
+      "stateCode": "Region",
+      "stateCodePlaceholder": "Välj region",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "ES": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "FI": {
+      "stateCode": "Region",
+      "stateCodePlaceholder": "Välj region",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "IE": {
+      "stateCode": "County",
+      "stateCodePlaceholder": "Välj county",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "MX": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "City",
+      "postal": "Postnummer"
+    },
+    "NL": {
+      "stateCode": "Provins",
+      "stateCodePlaceholder": "Välj provins",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "NO": {
+      "stateCode": "County",
+      "stateCodePlaceholder": "Välj county",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "NZ": {
+      "stateCode": "Region",
+      "stateCodePlaceholder": "Välj region",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "PL": {
+      "stateCode": "Region / Provins",
+      "stateCodePlaceholder": "Välj region / provins",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "SE": {
+      "stateCode": "Region",
+      "stateCodePlaceholder": "Välj region",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "US": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "ZA": {
+      "stateCode": "Stat",
+      "stateCodePlaceholder": "Välj stat",
+      "city": "Stad",
+      "postal": "Postnummer"
+    },
+    "GB": {
+      "postal": "Postcode"
+    },
+    "JP": {
+      "stateCode": "Prefecture",
+      "stateCodePlaceholder": "Select the prefecture"
+    },
+    "AE": {
+      "stateCode": "Emirate",
+      "stateCodePlaceholder": "Select the emirate"
+    },
+    "IN": {
+      "postal": "PIN Code"
+    },
+    "CH": {
+      "stateCode": "Canton",
+      "stateCodePlaceholder": "Select the canton"
+    }
+  }
+};
+
+export default _default;

package/dist/i18n/locales/sv-se.json.js

@@ -0,0 +1,163 @@
+const t = {
+  firstName: "Förnamn",
+  lastName: "Efternamn",
+  address1: "Adressrad 1",
+  address2: "Adressrad 2",
+  city: "Stad",
+  postal: "Postnummer",
+  stateCode: "Stat / Provins",
+  country: "Land",
+  phoneNumber: "Telefonnummer",
+  dialCode: "Uppringningskod",
+  defaultAddress: "Gör det här till mitt förvalda kort",
+  countryPlaceholder: "Please select",
+  stateCodePlaceholder: "Välj stat eller provins",
+  phoneNumberPlaceholder: "Ange telefonnummer",
+  addressHeading: "Faktura och leveransadress",
+  addNewAddress: "Lägg till ny adress",
+  confirm: "Bekräfta adress",
+  cancel: "Avbryt",
+  editButton: "Redigera",
+  deleteButton: "Ta bort",
+  defaultBadge: "Standard",
+  makeDefault: "Ange som standardadress",
+  countrySelectPlaceholder: "Välj land"
+}, e = {
+  FIELD_REQUIRED: "{{field}} is required",
+  FIELD_TOO_LONG: "Får vara {{maxLength}} tecken som längst",
+  FIELD_TOO_SHORT: "Får vara {{minLength}} tecken som längst",
+  FIELD_INVALID_FORMAT: "Please enter a valid {{field}}",
+  FIELD_INVALID_CHARACTERS: "{{field}} contains invalid characters",
+  POSTAL_CODE_MISMATCH: "Postal code does not match the selected {{stateLabel}}"
+}, a = {
+  AT: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  AU: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "Förort",
+    postal: "Postnummer"
+  },
+  CA: {
+    stateCode: "Provins",
+    stateCodePlaceholder: "Välj provins",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  CZ: {
+    stateCode: "Region",
+    stateCodePlaceholder: "Välj region",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  DE: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  DK: {
+    stateCode: "Region",
+    stateCodePlaceholder: "Välj region",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  ES: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  FI: {
+    stateCode: "Region",
+    stateCodePlaceholder: "Välj region",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  IE: {
+    stateCode: "County",
+    stateCodePlaceholder: "Välj county",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  MX: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "City",
+    postal: "Postnummer"
+  },
+  NL: {
+    stateCode: "Provins",
+    stateCodePlaceholder: "Välj provins",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  NO: {
+    stateCode: "County",
+    stateCodePlaceholder: "Välj county",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  NZ: {
+    stateCode: "Region",
+    stateCodePlaceholder: "Välj region",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  PL: {
+    stateCode: "Region / Provins",
+    stateCodePlaceholder: "Välj region / provins",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  SE: {
+    stateCode: "Region",
+    stateCodePlaceholder: "Välj region",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  US: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  ZA: {
+    stateCode: "Stat",
+    stateCodePlaceholder: "Välj stat",
+    city: "Stad",
+    postal: "Postnummer"
+  },
+  GB: {
+    postal: "Postcode"
+  },
+  JP: {
+    stateCode: "Prefecture",
+    stateCodePlaceholder: "Select the prefecture"
+  },
+  AE: {
+    stateCode: "Emirate",
+    stateCodePlaceholder: "Select the emirate"
+  },
+  IN: {
+    postal: "PIN Code"
+  },
+  CH: {
+    stateCode: "Canton",
+    stateCodePlaceholder: "Select the canton"
+  }
+}, o = {
+  form: t,
+  validation: e,
+  country: a
+};
+export {
+  a as country,
+  o as default,
+  t as form,
+  e as validation
+};

package/dist/i18n/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * i18n types for tm-global-address.
+ *
+ * The library owns its own lightweight label resolution — no i18next or
+ * react-intl at runtime. Consumers pass a `locale` string and the library
+ * resolves labels internally via two-layer lookup:
+ *   1. Country-specific override: `{CC}.{field}` (e.g. "CA.stateCode" → "Province")
+ *   2. Generic form default:      `form.{field}` (e.g. "form.stateCode" → "State / Province")
+ */
+/** All translatable labels for the address form, flat string map */
+export interface FormLabels {
+    firstName: string;
+    lastName: string;
+    address1: string;
+    address2: string;
+    city: string;
+    postal: string;
+    stateCode: string;
+    country: string;
+    phoneNumber: string;
+    dialCode: string;
+    defaultAddress: string;
+    countryPlaceholder: string;
+    stateCodePlaceholder: string;
+    phoneNumberPlaceholder: string;
+    addressHeading: string;
+    addNewAddress: string;
+    confirm: string;
+    cancel: string;
+    editButton: string;
+    deleteButton: string;
+    defaultBadge: string;
+    makeDefault: string;
+    countrySelectPlaceholder: string;
+}
+/** Validation message templates — use {{variable}} interpolation */
+export interface ValidationLabels {
+    FIELD_REQUIRED: string;
+    FIELD_TOO_LONG: string;
+    FIELD_TOO_SHORT: string;
+    FIELD_INVALID_FORMAT: string;
+    FIELD_INVALID_CHARACTERS: string;
+    POSTAL_CODE_MISMATCH: string;
+}
+/** Country-specific label overrides keyed by CC (ISO 3166-1 alpha-2) */
+export type CountryOverrides = Record<string, {
+    stateCode?: string;
+    stateCodePlaceholder?: string;
+    city?: string;
+    postal?: string;
+}>;
+/** A single locale bundle */
+export interface LocaleBundle {
+    form: FormLabels;
+    validation: ValidationLabels;
+    /** Country-code → override labels */
+    country: CountryOverrides;
+}
+/** Labels resolved for a specific locale + country combination */
+export interface ResolvedLabels {
+    form: FormLabels;
+    validation: ValidationLabels;
+    /** Whether this locale requires RTL layout */
+    isRTL: boolean;
+}
+/** Metadata passed to error message interpolation */
+export type InterpolationVars = Record<string, string | number | undefined>;

package/dist/index.d.ts

@@ -24,5 +24,9 @@ export type { ValidationErrorCode, ValidationError, FieldValidationResult, FormV
 export { FIELD_CONSTRAINTS } from './validation/constants';
 export { sanitize, validateTextField, validatePostalCode, validateState, validatePhoneNumber, validateForm, } from './validation/index';
 export type { ValidateFormOptions } from './validation/index';
+export { useLabels, resolveLabels, loadBundle, isRTLLocale, interpolate, SUPPORTED_LOCALES, } from './i18n/index';
+export type { ResolvedLabels, LocaleBundle, FormLabels, ValidationLabels, CountryOverrides, InterpolationVars, SupportedLocale, } from './i18n/index';
+export { useAddressForm, useAddressFormRHF } from './hooks/index';
+export type { UseAddressFormConfig, UseAddressFormReturn, AddressFormValues } from './hooks/index';
 export { HelloWorld } from './components/HelloWorld/HelloWorld';
 export type { HelloWorldProps } from './components/HelloWorld/HelloWorld';

package/dist/index.js

@@ -1,47 +1,59 @@
 import { GlobalAddress as e } from "./components/GlobalAddress/GlobalAddress.js";
 import { AddressForm as m } from "./components/AddressForm/AddressForm.js";
-import { PhoneField as a } from "./components/PhoneField/PhoneField.js";
-import { AddressCard as x, formatAddressSummary as p } from "./components/AddressCard/AddressCard.js";
-import { AddressSummary as S } from "./components/AddressSummary/AddressSummary.js";
-import { AddressList as l } from "./components/AddressList/AddressList.js";
-import { COUNTRIES as T, getCountryByCode as N } from "./data/countries.js";
-import { SUBDIVISIONS as O, getSubdivisions as n } from "./data/states.js";
-import { POSTAL_PATTERNS as P, getPostalPattern as u } from "./data/postalPatterns.js";
-import { STATE_REQUIRED_CODES as R } from "./data/countryConfig.js";
-import { COUNTRY_CONFIGS as v, COUNTRY_OPTIONS as y, getCountryConfig as F, getCountryName as _ } from "./data/countryData.js";
-import { FIELD_CONSTRAINTS as D } from "./validation/constants.js";
-import { HelloWorld as L } from "./components/HelloWorld/HelloWorld.js";
-import { sanitize as B } from "./validation/sanitize.js";
-import { validateForm as Y } from "./validation/validateForm.js";
-import { validatePhoneNumber as H } from "./validation/validatePhoneNumber.js";
-import { validatePostalCode as V } from "./validation/validatePostalCode.js";
-import { validateState as c } from "./validation/validateState.js";
-import { validateTextField as k } from "./validation/validateTextField.js";
+import { PhoneField as s } from "./components/PhoneField/PhoneField.js";
+import { AddressCard as f, formatAddressSummary as p } from "./components/AddressCard/AddressCard.js";
+import { AddressSummary as l } from "./components/AddressSummary/AddressSummary.js";
+import { AddressList as i } from "./components/AddressList/AddressList.js";
+import { COUNTRIES as T, getCountryByCode as A } from "./data/countries.js";
+import { SUBDIVISIONS as n, getSubdivisions as u } from "./data/states.js";
+import { POSTAL_PATTERNS as P, getPostalPattern as R } from "./data/postalPatterns.js";
+import { STATE_REQUIRED_CODES as F } from "./data/countryConfig.js";
+import { COUNTRY_CONFIGS as L, COUNTRY_OPTIONS as v, getCountryConfig as _, getCountryName as g } from "./data/countryData.js";
+import { FIELD_CONSTRAINTS as U } from "./validation/constants.js";
+import { SUPPORTED_LOCALES as D, useLabels as B } from "./i18n/index.js";
+import { HelloWorld as G } from "./components/HelloWorld/HelloWorld.js";
+import { interpolate as Y, isRTLLocale as c, loadBundle as z, resolveLabels as Q } from "./i18n/labelResolver.js";
+import { sanitize as W } from "./validation/sanitize.js";
+import { useAddressForm as k } from "./hooks/useAddressForm.js";
+import { useAddressFormRHF as w } from "./hooks/useAddressFormRHF.js";
+import { validateForm as K } from "./validation/validateForm.js";
+import { validatePhoneNumber as X } from "./validation/validatePhoneNumber.js";
+import { validatePostalCode as $ } from "./validation/validatePostalCode.js";
+import { validateState as or } from "./validation/validateState.js";
+import { validateTextField as tr } from "./validation/validateTextField.js";
 export {
-  x as AddressCard,
+  f as AddressCard,
   m as AddressForm,
-  l as AddressList,
-  S as AddressSummary,
+  i as AddressList,
+  l as AddressSummary,
   T as COUNTRIES,
-  v as COUNTRY_CONFIGS,
-  y as COUNTRY_OPTIONS,
-  D as FIELD_CONSTRAINTS,
+  L as COUNTRY_CONFIGS,
+  v as COUNTRY_OPTIONS,
+  U as FIELD_CONSTRAINTS,
   e as GlobalAddress,
-  L as HelloWorld,
+  G as HelloWorld,
   P as POSTAL_PATTERNS,
-  a as PhoneField,
-  R as STATE_REQUIRED_CODES,
-  O as SUBDIVISIONS,
+  s as PhoneField,
+  F as STATE_REQUIRED_CODES,
+  n as SUBDIVISIONS,
+  D as SUPPORTED_LOCALES,
   p as formatAddressSummary,
-  N as getCountryByCode,
-  F as getCountryConfig,
-  _ as getCountryName,
-  u as getPostalPattern,
-  n as getSubdivisions,
-  B as sanitize,
-  Y as validateForm,
-  H as validatePhoneNumber,
-  V as validatePostalCode,
-  c as validateState,
-  k as validateTextField
+  A as getCountryByCode,
+  _ as getCountryConfig,
+  g as getCountryName,
+  R as getPostalPattern,
+  u as getSubdivisions,
+  Y as interpolate,
+  c as isRTLLocale,
+  z as loadBundle,
+  Q as resolveLabels,
+  W as sanitize,
+  k as useAddressForm,
+  w as useAddressFormRHF,
+  B as useLabels,
+  K as validateForm,
+  X as validatePhoneNumber,
+  $ as validatePostalCode,
+  or as validateState,
+  tr as validateTextField
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticketmaster/tm-global-address",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Shared React UI Library for Global Address Management",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -52,6 +52,7 @@
     "prettier": "3.0.3",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "react-hook-form": "^7.72.1",
     "storybook": "^8.2.4",
     "styled-components": "^6.4.0",
     "tsconfig-paths-webpack-plugin": "^4.1.0",