@wix/headless-localization-utils 1.0.0

package/build/index.cjs

@@ -0,0 +1,134 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getLocalizationData: () => getLocalizationData
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/localeUtils.ts
+var buildLocaleString = (locale) => {
+  if (!locale) {
+    return;
+  }
+  if (locale.languageCode?.includes("-")) {
+    return locale.languageCode;
+  }
+  const localeParts = [locale.languageCode, locale.country].filter(Boolean);
+  if (localeParts.length === 0) {
+    return;
+  }
+  return localeParts.join("-");
+};
+
+// src/urlUtils.ts
+var getLanguageFromQueryParam = (url) => url.searchParams.get("lang") ?? void 0;
+var getLanguageFromSubfolder = (url) => url.pathname.split("/")[1];
+var getLanguageFromSubdomain = (url) => url.hostname.split(".")[0];
+var extractLanguageFromUrlAndValidate = (url, availableLocales) => {
+  const localeFromQueryParams = extractFromQueryParamsAndValidate(
+    url,
+    availableLocales
+  );
+  if (localeFromQueryParams?.resolutionMethod === "QUERY_PARAM") {
+    return localeFromQueryParams;
+  }
+  const localeFromSubfolder = extractFromSubfolderAndValidate(
+    url,
+    availableLocales
+  );
+  if (localeFromSubfolder?.resolutionMethod === "SUBDIRECTORY") {
+    return localeFromSubfolder;
+  }
+  const localeFromSubdomain = extractFromSubdomainAndValidate(
+    url,
+    availableLocales
+  );
+  if (localeFromSubdomain?.resolutionMethod === "SUBDOMAIN") {
+    return localeFromSubdomain;
+  }
+  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;
+};
+var clearLanguageFromUrl = (urlString, languageCodes) => {
+  const url = new URL(urlString);
+  url.searchParams.delete("lang");
+  const subfolderLanguage = url.pathname.split("/")[1]?.toLowerCase();
+  if (languageCodes.includes(subfolderLanguage ?? "")) {
+    const segments = url.pathname.split("/");
+    segments.splice(1, 1);
+    url.pathname = segments.join("/");
+  }
+  const subdirectoryLanguage = url.hostname.split(".")[0]?.toLowerCase();
+  if (languageCodes.includes(subdirectoryLanguage ?? "")) {
+    const parts = url.hostname.split(".");
+    parts.shift();
+    url.hostname = parts.join(".");
+  }
+  return url.href;
+};
+var extractFromQueryParamsAndValidate = (url, availableLocales) => {
+  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);
+};
+var extractFromSubfolderAndValidate = (url, availableLocales) => {
+  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);
+};
+var extractFromSubdomainAndValidate = (url, availableLocales) => {
+  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);
+};
+var getLanguageIfExists = (languageCode, availableLocales) => {
+  if (languageCode == null) {
+    return void 0;
+  }
+  const lowerCasedCode = languageCode.toLowerCase();
+  return availableLocales.find(
+    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode
+  );
+};
+
+// src/localizationUtils.ts
+function getLocalizationData(url, siteProperties) {
+  const availableLocales = siteProperties?.multilingual?.supportedLanguages ?? [];
+  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(
+    url,
+    availableLocales
+  );
+  const languageCodes = [
+    ...availableLocales.map((locale2) => locale2.locale?.languageCode),
+    siteProperties?.locale?.languageCode
+  ].filter((languageCode) => Boolean(languageCode));
+  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);
+  const locale = buildLocaleString(
+    explicitRequestedLocale?.locale ?? siteProperties?.locale
+  ) ?? void 0;
+  const language = explicitRequestedLocale?.languageCode ?? siteProperties?.language ?? void 0;
+  const essentials = {
+    language,
+    locale,
+    multilingual: siteProperties?.multilingual,
+    timezone: siteProperties?.timeZone ?? void 0
+  };
+  return { cleanUrl, essentials };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getLocalizationData
+});
+//# sourceMappingURL=index.cjs.map

package/build/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/localeUtils.ts","../src/urlUtils.ts","../src/localizationUtils.ts"],"sourcesContent":["export {\n  getLocalizationData,\n  type LocalizationData,\n} from './localizationUtils.js';\n","import type { scripts } from '@wix/headless-site-assets';\n\n// Type for locale object\nexport type Locale = scripts.Locale;\n\n// Type for locale string building\nexport const buildLocaleString = (\n  locale?: null | Locale,\n): string | undefined => {\n  if (!locale) {\n    return;\n  }\n\n  // in case of dialects, language code will be in the form of\n  // en-au and not just en\n  if (locale.languageCode?.includes('-')) {\n    return locale.languageCode;\n  }\n\n  const localeParts = [locale.languageCode, locale.country].filter(Boolean);\n\n  if (localeParts.length === 0) {\n    return;\n  }\n\n  return localeParts.join('-');\n};\n","import type { scripts } from '@wix/headless-site-assets';\n\nexport type SupportedLanguage = scripts.SupportedLanguage;\n\ntype AvailableLocale = SupportedLanguage;\n\nconst getLanguageFromQueryParam = (url: URL) =>\n  url.searchParams.get('lang') ?? undefined;\nconst getLanguageFromSubfolder = (url: URL) => url.pathname.split('/')[1];\nconst getLanguageFromSubdomain = (url: URL) => url.hostname.split('.')[0];\n\nexport const extractLanguageFromUrlAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  const localeFromQueryParams = extractFromQueryParamsAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromQueryParams?.resolutionMethod === 'QUERY_PARAM') {\n    return localeFromQueryParams;\n  }\n\n  const localeFromSubfolder = extractFromSubfolderAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubfolder?.resolutionMethod === 'SUBDIRECTORY') {\n    return localeFromSubfolder;\n  }\n\n  const localeFromSubdomain = extractFromSubdomainAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubdomain?.resolutionMethod === 'SUBDOMAIN') {\n    return localeFromSubdomain;\n  }\n\n  // Fallback if a locale is available but doesn't have the correct resolution method\n  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;\n};\n\nexport const clearLanguageFromUrl = (\n  urlString: string,\n  languageCodes: string[],\n): string => {\n  const url = new URL(urlString);\n  url.searchParams.delete('lang');\n\n  const subfolderLanguage = url.pathname.split('/')[1]?.toLowerCase();\n  if (languageCodes.includes(subfolderLanguage ?? '')) {\n    const segments = url.pathname.split('/'); // ['', 'en', 'docs', 'api']\n    segments.splice(1, 1); // Remove index 1\n    url.pathname = segments.join('/');\n  }\n\n  const subdirectoryLanguage = url.hostname.split('.')[0]?.toLowerCase();\n  if (languageCodes.includes(subdirectoryLanguage ?? '')) {\n    const parts = url.hostname.split('.'); // ['fr', 'example', 'com']\n    parts.shift(); // ['example', 'com']\n    url.hostname = parts.join('.');\n  }\n\n  return url.href;\n};\n\n// https://somesite.com/hello?lang:XX\nconst extractFromQueryParamsAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);\n};\n\n// https://somesite.com/XX/hello\nconst extractFromSubfolderAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);\n};\n\n// https://XX.somesite.com/hello\nconst extractFromSubdomainAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);\n};\n\nconst getLanguageIfExists = (\n  languageCode: string | undefined,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  if (languageCode == null) {\n    return undefined;\n  }\n  const lowerCasedCode = languageCode.toLowerCase();\n  return availableLocales.find(\n    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode,\n  );\n};\n","import type { Essentials, Multilingual } from '@wix/headless-node';\nimport type { scripts } from '@wix/headless-site-assets';\nimport { buildLocaleString } from './localeUtils.js';\nimport {\n  clearLanguageFromUrl,\n  extractLanguageFromUrlAndValidate,\n} from './urlUtils.js';\n\nexport type EssentialProperties = scripts.EssentialProperties;\n\nexport type LocalizationData = {\n  cleanUrl: string;\n  essentials: Essentials;\n};\n\nexport function getLocalizationData(\n  url: URL,\n  siteProperties: EssentialProperties,\n): LocalizationData {\n  const availableLocales =\n    siteProperties?.multilingual?.supportedLanguages ?? [];\n  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(\n    url,\n    availableLocales,\n  );\n\n  const languageCodes = [\n    ...availableLocales.map((locale) => locale.locale?.languageCode),\n    siteProperties?.locale?.languageCode,\n  ].filter((languageCode) => Boolean(languageCode)) as string[];\n\n  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);\n\n  const locale =\n    buildLocaleString(\n      explicitRequestedLocale?.locale ?? siteProperties?.locale,\n    ) ?? undefined;\n\n  const language =\n    explicitRequestedLocale?.languageCode ??\n    siteProperties?.language ??\n    undefined;\n\n  const essentials: Essentials = {\n    language,\n    locale,\n    multilingual: siteProperties?.multilingual as Multilingual | undefined,\n    timezone: siteProperties?.timeZone ?? undefined,\n  };\n\n  return { cleanUrl, essentials };\n}\n"],"mappings":"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","names":["locale"]}

package/build/index.d.cts

@@ -0,0 +1,11 @@
+import { Essentials } from '@wix/headless-node';
+import { scripts } from '@wix/headless-site-assets';
+
+type EssentialProperties = scripts.EssentialProperties;
+type LocalizationData = {
+    cleanUrl: string;
+    essentials: Essentials;
+};
+declare function getLocalizationData(url: URL, siteProperties: EssentialProperties): LocalizationData;
+
+export { type LocalizationData, getLocalizationData };

package/build/index.d.ts

@@ -0,0 +1,11 @@
+import { Essentials } from '@wix/headless-node';
+import { scripts } from '@wix/headless-site-assets';
+
+type EssentialProperties = scripts.EssentialProperties;
+type LocalizationData = {
+    cleanUrl: string;
+    essentials: Essentials;
+};
+declare function getLocalizationData(url: URL, siteProperties: EssentialProperties): LocalizationData;
+
+export { type LocalizationData, getLocalizationData };

package/build/index.js

@@ -0,0 +1,107 @@
+// src/localeUtils.ts
+var buildLocaleString = (locale) => {
+  if (!locale) {
+    return;
+  }
+  if (locale.languageCode?.includes("-")) {
+    return locale.languageCode;
+  }
+  const localeParts = [locale.languageCode, locale.country].filter(Boolean);
+  if (localeParts.length === 0) {
+    return;
+  }
+  return localeParts.join("-");
+};
+
+// src/urlUtils.ts
+var getLanguageFromQueryParam = (url) => url.searchParams.get("lang") ?? void 0;
+var getLanguageFromSubfolder = (url) => url.pathname.split("/")[1];
+var getLanguageFromSubdomain = (url) => url.hostname.split(".")[0];
+var extractLanguageFromUrlAndValidate = (url, availableLocales) => {
+  const localeFromQueryParams = extractFromQueryParamsAndValidate(
+    url,
+    availableLocales
+  );
+  if (localeFromQueryParams?.resolutionMethod === "QUERY_PARAM") {
+    return localeFromQueryParams;
+  }
+  const localeFromSubfolder = extractFromSubfolderAndValidate(
+    url,
+    availableLocales
+  );
+  if (localeFromSubfolder?.resolutionMethod === "SUBDIRECTORY") {
+    return localeFromSubfolder;
+  }
+  const localeFromSubdomain = extractFromSubdomainAndValidate(
+    url,
+    availableLocales
+  );
+  if (localeFromSubdomain?.resolutionMethod === "SUBDOMAIN") {
+    return localeFromSubdomain;
+  }
+  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;
+};
+var clearLanguageFromUrl = (urlString, languageCodes) => {
+  const url = new URL(urlString);
+  url.searchParams.delete("lang");
+  const subfolderLanguage = url.pathname.split("/")[1]?.toLowerCase();
+  if (languageCodes.includes(subfolderLanguage ?? "")) {
+    const segments = url.pathname.split("/");
+    segments.splice(1, 1);
+    url.pathname = segments.join("/");
+  }
+  const subdirectoryLanguage = url.hostname.split(".")[0]?.toLowerCase();
+  if (languageCodes.includes(subdirectoryLanguage ?? "")) {
+    const parts = url.hostname.split(".");
+    parts.shift();
+    url.hostname = parts.join(".");
+  }
+  return url.href;
+};
+var extractFromQueryParamsAndValidate = (url, availableLocales) => {
+  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);
+};
+var extractFromSubfolderAndValidate = (url, availableLocales) => {
+  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);
+};
+var extractFromSubdomainAndValidate = (url, availableLocales) => {
+  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);
+};
+var getLanguageIfExists = (languageCode, availableLocales) => {
+  if (languageCode == null) {
+    return void 0;
+  }
+  const lowerCasedCode = languageCode.toLowerCase();
+  return availableLocales.find(
+    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode
+  );
+};
+
+// src/localizationUtils.ts
+function getLocalizationData(url, siteProperties) {
+  const availableLocales = siteProperties?.multilingual?.supportedLanguages ?? [];
+  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(
+    url,
+    availableLocales
+  );
+  const languageCodes = [
+    ...availableLocales.map((locale2) => locale2.locale?.languageCode),
+    siteProperties?.locale?.languageCode
+  ].filter((languageCode) => Boolean(languageCode));
+  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);
+  const locale = buildLocaleString(
+    explicitRequestedLocale?.locale ?? siteProperties?.locale
+  ) ?? void 0;
+  const language = explicitRequestedLocale?.languageCode ?? siteProperties?.language ?? void 0;
+  const essentials = {
+    language,
+    locale,
+    multilingual: siteProperties?.multilingual,
+    timezone: siteProperties?.timeZone ?? void 0
+  };
+  return { cleanUrl, essentials };
+}
+export {
+  getLocalizationData
+};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/localeUtils.ts","../src/urlUtils.ts","../src/localizationUtils.ts"],"sourcesContent":["import type { scripts } from '@wix/headless-site-assets';\n\n// Type for locale object\nexport type Locale = scripts.Locale;\n\n// Type for locale string building\nexport const buildLocaleString = (\n  locale?: null | Locale,\n): string | undefined => {\n  if (!locale) {\n    return;\n  }\n\n  // in case of dialects, language code will be in the form of\n  // en-au and not just en\n  if (locale.languageCode?.includes('-')) {\n    return locale.languageCode;\n  }\n\n  const localeParts = [locale.languageCode, locale.country].filter(Boolean);\n\n  if (localeParts.length === 0) {\n    return;\n  }\n\n  return localeParts.join('-');\n};\n","import type { scripts } from '@wix/headless-site-assets';\n\nexport type SupportedLanguage = scripts.SupportedLanguage;\n\ntype AvailableLocale = SupportedLanguage;\n\nconst getLanguageFromQueryParam = (url: URL) =>\n  url.searchParams.get('lang') ?? undefined;\nconst getLanguageFromSubfolder = (url: URL) => url.pathname.split('/')[1];\nconst getLanguageFromSubdomain = (url: URL) => url.hostname.split('.')[0];\n\nexport const extractLanguageFromUrlAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  const localeFromQueryParams = extractFromQueryParamsAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromQueryParams?.resolutionMethod === 'QUERY_PARAM') {\n    return localeFromQueryParams;\n  }\n\n  const localeFromSubfolder = extractFromSubfolderAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubfolder?.resolutionMethod === 'SUBDIRECTORY') {\n    return localeFromSubfolder;\n  }\n\n  const localeFromSubdomain = extractFromSubdomainAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubdomain?.resolutionMethod === 'SUBDOMAIN') {\n    return localeFromSubdomain;\n  }\n\n  // Fallback if a locale is available but doesn't have the correct resolution method\n  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;\n};\n\nexport const clearLanguageFromUrl = (\n  urlString: string,\n  languageCodes: string[],\n): string => {\n  const url = new URL(urlString);\n  url.searchParams.delete('lang');\n\n  const subfolderLanguage = url.pathname.split('/')[1]?.toLowerCase();\n  if (languageCodes.includes(subfolderLanguage ?? '')) {\n    const segments = url.pathname.split('/'); // ['', 'en', 'docs', 'api']\n    segments.splice(1, 1); // Remove index 1\n    url.pathname = segments.join('/');\n  }\n\n  const subdirectoryLanguage = url.hostname.split('.')[0]?.toLowerCase();\n  if (languageCodes.includes(subdirectoryLanguage ?? '')) {\n    const parts = url.hostname.split('.'); // ['fr', 'example', 'com']\n    parts.shift(); // ['example', 'com']\n    url.hostname = parts.join('.');\n  }\n\n  return url.href;\n};\n\n// https://somesite.com/hello?lang:XX\nconst extractFromQueryParamsAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);\n};\n\n// https://somesite.com/XX/hello\nconst extractFromSubfolderAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);\n};\n\n// https://XX.somesite.com/hello\nconst extractFromSubdomainAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);\n};\n\nconst getLanguageIfExists = (\n  languageCode: string | undefined,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  if (languageCode == null) {\n    return undefined;\n  }\n  const lowerCasedCode = languageCode.toLowerCase();\n  return availableLocales.find(\n    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode,\n  );\n};\n","import type { Essentials, Multilingual } from '@wix/headless-node';\nimport type { scripts } from '@wix/headless-site-assets';\nimport { buildLocaleString } from './localeUtils.js';\nimport {\n  clearLanguageFromUrl,\n  extractLanguageFromUrlAndValidate,\n} from './urlUtils.js';\n\nexport type EssentialProperties = scripts.EssentialProperties;\n\nexport type LocalizationData = {\n  cleanUrl: string;\n  essentials: Essentials;\n};\n\nexport function getLocalizationData(\n  url: URL,\n  siteProperties: EssentialProperties,\n): LocalizationData {\n  const availableLocales =\n    siteProperties?.multilingual?.supportedLanguages ?? [];\n  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(\n    url,\n    availableLocales,\n  );\n\n  const languageCodes = [\n    ...availableLocales.map((locale) => locale.locale?.languageCode),\n    siteProperties?.locale?.languageCode,\n  ].filter((languageCode) => Boolean(languageCode)) as string[];\n\n  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);\n\n  const locale =\n    buildLocaleString(\n      explicitRequestedLocale?.locale ?? siteProperties?.locale,\n    ) ?? undefined;\n\n  const language =\n    explicitRequestedLocale?.languageCode ??\n    siteProperties?.language ??\n    undefined;\n\n  const essentials: Essentials = {\n    language,\n    locale,\n    multilingual: siteProperties?.multilingual as Multilingual | undefined,\n    timezone: siteProperties?.timeZone ?? undefined,\n  };\n\n  return { cleanUrl, essentials };\n}\n"],"mappings":"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","names":["locale"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@wix/headless-localization-utils",
+  "version": "1.0.0",
+  "unpkg": true,
+  "license": "MIT",
+  "author": {
+    "name": "tomsa",
+    "email": "tomsa@wix.com"
+  },
+  "main": "build/index.cjs",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "build"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./build/index.d.ts",
+        "default": "./build/index.js"
+      },
+      "require": {
+        "types": "./build/index.d.ts",
+        "default": "./build/index.cjs"
+      },
+      "default": {
+        "types": "./build/index.d.ts",
+        "default": "./build/index.js"
+      }
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "publishScoped": true,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest",
+    "lint": "eslint --max-warnings=0 .",
+    "lint:fix": "eslint --max-warnings=0 . --fix",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@wix/headless-node": "1.21.0",
+    "@wix/headless-site-assets": "^1.0.9"
+  },
+  "devDependencies": {
+    "@types/node": "^16.0.0",
+    "eslint": "^8.57.1",
+    "tsup": "^8.5.0",
+    "typescript": "~4.9.0",
+    "vitest": "^3.2.4"
+  },
+  "eslintConfig": {
+    "extends": "@wix/eslint-config-yoshi",
+    "ignorePatterns": [
+      "**/build/*"
+    ]
+  },
+  "wix": {
+    "artifact": {
+      "groupId": "com.wixpress",
+      "artifactId": "headless-localization-utils"
+    },
+    "validations": {
+      "source": [
+        "lint"
+      ],
+      "postDependenciesBuild": [
+        "typecheck"
+      ]
+    }
+  },
+  "falconPackageHash": "adbcff16f170e15e21f5e703cfcd0b5e183b5258f15ee998fb4dd41f"
+}