@liam-public/text 0.1.0

package/README.md

@@ -0,0 +1,3 @@
+# @liam-public/text
+
+Universal text guards and locale-aware formatters.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+type LocalizedText = Readonly<Record<string, string>>;
+declare function isLocalizedText(value: unknown, requiredLanguages: readonly string[]): value is LocalizedText;
+declare function selectText(text: LocalizedText | string | undefined, language: string, fallbackLanguages?: readonly string[]): string;
+declare function formatCurrency(amount: number, currency?: string, locale?: string): string;
+declare function formatNumber(value: number, locale?: string): string;
+declare function formatPercentage(value: number, decimals?: number, locale?: string): string;
+declare function formatDate(date: Date | string, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+declare function formatFileSize(bytes: number): string;
+
+export { type LocalizedText, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercentage, isLocalizedText, selectText };

package/dist/index.js

@@ -0,0 +1,43 @@
+// src/index.ts
+function isLocalizedText(value, requiredLanguages) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const record = value;
+  return requiredLanguages.every((language) => typeof record[language] === "string");
+}
+function selectText(text, language, fallbackLanguages = []) {
+  if (!text) return "";
+  if (typeof text === "string") return text;
+  return text[language] || fallbackLanguages.map((fallback) => text[fallback]).find(Boolean) || "";
+}
+function formatCurrency(amount, currency = "USD", locale = "en-US") {
+  return new Intl.NumberFormat(locale, { style: "currency", currency }).format(amount);
+}
+function formatNumber(value, locale = "en-US") {
+  return new Intl.NumberFormat(locale).format(value);
+}
+function formatPercentage(value, decimals = 2, locale = "en-US") {
+  return new Intl.NumberFormat(locale, {
+    style: "percent",
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  }).format(value / 100);
+}
+function formatDate(date, locale = "en-US", options = { year: "numeric", month: "short", day: "numeric" }) {
+  return new Intl.DateTimeFormat(locale, options).format(typeof date === "string" ? new Date(date) : date);
+}
+function formatFileSize(bytes) {
+  if (bytes === 0) return "0 Bytes";
+  const sizes = ["Bytes", "KB", "MB", "GB", "TB"];
+  const index = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), sizes.length - 1);
+  return `${(bytes / 1024 ** index).toFixed(2)} ${sizes[index]}`;
+}
+export {
+  formatCurrency,
+  formatDate,
+  formatFileSize,
+  formatNumber,
+  formatPercentage,
+  isLocalizedText,
+  selectText
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type LocalizedText = Readonly<Record<string, string>>\n\nexport function isLocalizedText(value: unknown, requiredLanguages: readonly string[]): value is LocalizedText {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return false\n  const record = value as Record<string, unknown>\n  return requiredLanguages.every((language) => typeof record[language] === 'string')\n}\n\nexport function selectText(\n  text: LocalizedText | string | undefined,\n  language: string,\n  fallbackLanguages: readonly string[] = [],\n): string {\n  if (!text) return ''\n  if (typeof text === 'string') return text\n  return text[language] || fallbackLanguages.map((fallback) => text[fallback]).find(Boolean) || ''\n}\n\nexport function formatCurrency(amount: number, currency = 'USD', locale = 'en-US'): string {\n  return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(amount)\n}\n\nexport function formatNumber(value: number, locale = 'en-US'): string {\n  return new Intl.NumberFormat(locale).format(value)\n}\n\nexport function formatPercentage(value: number, decimals = 2, locale = 'en-US'): string {\n  return new Intl.NumberFormat(locale, {\n    style: 'percent',\n    minimumFractionDigits: decimals,\n    maximumFractionDigits: decimals,\n  }).format(value / 100)\n}\n\nexport function formatDate(\n  date: Date | string,\n  locale = 'en-US',\n  options: Intl.DateTimeFormatOptions = { year: 'numeric', month: 'short', day: 'numeric' },\n): string {\n  return new Intl.DateTimeFormat(locale, options).format(typeof date === 'string' ? new Date(date) : date)\n}\n\nexport function formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 Bytes'\n  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB']\n  const index = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), sizes.length - 1)\n  return `${(bytes / 1024 ** index).toFixed(2)} ${sizes[index]}`\n}\n"],"mappings":";AAEO,SAAS,gBAAgB,OAAgB,mBAA8D;AAC5G,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,QAAM,SAAS;AACf,SAAO,kBAAkB,MAAM,CAAC,aAAa,OAAO,OAAO,QAAQ,MAAM,QAAQ;AACnF;AAEO,SAAS,WACd,MACA,UACA,oBAAuC,CAAC,GAChC;AACR,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,SAAO,KAAK,QAAQ,KAAK,kBAAkB,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,EAAE,KAAK,OAAO,KAAK;AAChG;AAEO,SAAS,eAAe,QAAgB,WAAW,OAAO,SAAS,SAAiB;AACzF,SAAO,IAAI,KAAK,aAAa,QAAQ,EAAE,OAAO,YAAY,SAAS,CAAC,EAAE,OAAO,MAAM;AACrF;AAEO,SAAS,aAAa,OAAe,SAAS,SAAiB;AACpE,SAAO,IAAI,KAAK,aAAa,MAAM,EAAE,OAAO,KAAK;AACnD;AAEO,SAAS,iBAAiB,OAAe,WAAW,GAAG,SAAS,SAAiB;AACtF,SAAO,IAAI,KAAK,aAAa,QAAQ;AAAA,IACnC,OAAO;AAAA,IACP,uBAAuB;AAAA,IACvB,uBAAuB;AAAA,EACzB,CAAC,EAAE,OAAO,QAAQ,GAAG;AACvB;AAEO,SAAS,WACd,MACA,SAAS,SACT,UAAsC,EAAE,MAAM,WAAW,OAAO,SAAS,KAAK,UAAU,GAChF;AACR,SAAO,IAAI,KAAK,eAAe,QAAQ,OAAO,EAAE,OAAO,OAAO,SAAS,WAAW,IAAI,KAAK,IAAI,IAAI,IAAI;AACzG;AAEO,SAAS,eAAe,OAAuB;AACpD,MAAI,UAAU,EAAG,QAAO;AACxB,QAAM,QAAQ,CAAC,SAAS,MAAM,MAAM,MAAM,IAAI;AAC9C,QAAM,QAAQ,KAAK,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,MAAM,SAAS,CAAC;AACrF,SAAO,IAAI,QAAQ,QAAQ,OAAO,QAAQ,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC;AAC9D;","names":[]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@liam-public/text",
+  "version": "0.1.0",
+  "description": "Universal text guards and locale-aware formatters.",
+  "type": "module",
+  "liamCompatibility": {
+    "runtime": [
+      "universal"
+    ],
+    "framework": [
+      "agnostic"
+    ]
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --sourcemap",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}