@thorprovider/blocks 0.1.1 → 0.1.3

package/src/lib/money.ts

@@ -0,0 +1,65 @@
+import type { Money } from '@thorprovider/types'
+
+/**
+ * Pure monetary helpers shared by the curated commerce blocks.
+ *
+ * Canonical `Money` (`@thorprovider/types`) carries a decimal string in major
+ * units (e.g. `"69.99"`) — never cents. A missing, invalid, or unresolved
+ * amount is *unavailable*, which is a different state from a legitimate `"0"`.
+ * These helpers keep that distinction in the presentation layer: they validate
+ * a complete finite decimal before any display conversion, and they never
+ * invent a currency.
+ */
+
+const COMPLETE_FINITE_DECIMAL = /^-?(?:\d+)(?:\.\d+)?$/
+
+/**
+ * True only for a complete, finite decimal string (`"0"`, `"69.99"`, `"-3.5"`).
+ * Rejects `""`, `" "`, `"1."`, `".5"`, `"1e3"`, `"abc"`, and non-strings.
+ */
+export function isCompleteFiniteDecimal(value: unknown): value is string {
+  if (typeof value !== 'string') return false
+  const trimmed = value.trim()
+  if (trimmed === '' || !COMPLETE_FINITE_DECIMAL.test(trimmed)) return false
+  return Number.isFinite(Number(trimmed))
+}
+
+/**
+ * True when a `Money` value is safe to display and price a purchase with: a
+ * complete finite decimal amount and a non-empty currency code. A valid zero
+ * (`{ amount: '0', currencyCode: 'USD' }`) is available — zero alone does not
+ * make a price unavailable.
+ */
+export function isAvailableMoney(money: Money | null | undefined): money is Money {
+  return (
+    !!money &&
+    typeof money.currencyCode === 'string' &&
+    money.currencyCode.trim() !== '' &&
+    isCompleteFiniteDecimal(money.amount)
+  )
+}
+
+/**
+ * Formats a `Money` for display, or `null` when the value is unavailable.
+ *
+ * This is the safety gate the whole curated surface relies on: an absent or
+ * malformed amount (`""`, `" "`, `"abc"`, a non-string, a missing currency)
+ * MUST NOT reach `Intl.NumberFormat`, because `Number("")` is `0` and would
+ * render a fake `$0.00` for missing data. A backend-resolved valid zero
+ * (`{ amount: "0", currencyCode: "USD" }`) is available and formats as zero.
+ *
+ * When no `formatter` is supplied the currency comes from
+ * `money.currencyCode`, so no currency is hardcoded. Callers render their own
+ * unavailable/pending/recovery state when this returns `null`.
+ */
+export function formatMoney(
+  money: Money | null | undefined,
+  formatter?: (money: Money) => string,
+): string | null {
+  if (!isAvailableMoney(money)) return null
+  if (formatter) return formatter(money)
+  return new Intl.NumberFormat(undefined, {
+    style: 'currency',
+    currency: money.currencyCode,
+  }).format(Number(money.amount))
+}

package/tsup.config.ts

@@ -11,6 +11,5 @@ export default defineConfig({
   sourcemap: true,
   clean: true,
   external: ['react', 'react-dom', 'clsx', 'tailwind-merge', 'lucide-react'],
-  banner: { js: "'use client';" },
   onSuccess: process.env.SKIP_TYPE_CHECK === 'true' ? undefined : 'tsc --noEmit --skipLibCheck'
 })

package/vitest.config.ts

@@ -1,9 +1,17 @@
+import { fileURLToPath } from 'node:url'
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
+  resolve: {
+    // Vendored shadcn primitives under src/ui use the `@/` alias; mirror the
+    // tsconfig paths so component tests can import them.
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+  },
   test: {
     environment: 'node',
     globals: true,
     include: ['src/**/*.test.{ts,tsx}'],
   },
-})
+})