@temboplus/frontend-react-core 0.1.3-beta.9 → 0.1.3

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2024 TemboPlus
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,385 +1,131 @@
 # @temboplus/frontend-react-core
 
-A React UI library for TemboPlus applications, providing reusable components, validators, and utilities for building consistent react applications across the platform.
+React hooks that wrap pure helpers from [`@temboplus/frontend-core`](https://github.com/TemboPlus-Frontend/frontend-core-js) for use in React applications across the TemboPlus platform.
 
-## 📦 Installation
+Today the package ships one feature area — timezone — with more to be added as React-flavored counterparts to frontend-core utilities are needed.
+
+## Installation
 
 ```bash
-npm install @temboplus/frontend-react-core
-# or
-yarn add @temboplus/frontend-react-core
+bun add @temboplus/frontend-react-core
 # or
-pnpm add @temboplus/frontend-react-core
+npm install @temboplus/frontend-react-core
 ```
 
-## 🏗️ Dependencies
-
-This package requires the following peer dependencies:
+Peer dependency:
 
 ```bash
-npm install @temboplus/frontend-core
-```
-
-## 🚀 Quick Start
-
-```typescript
-import { PHONE_NUMBER_VALIDATOR, AMOUNT_VALIDATOR } from '@temboplus/frontend-react-core';
-
-// Use in your Ant Design form
-const formRules = {
-  phoneNumber: [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }],
-  amount: [{ required: true, validator: AMOUNT_VALIDATOR({ currencyCode: 'TZS' }) }]
-};
+bun add react
 ```
 
-## 📚 Features
-
-### ✅ Form Validators (Available Now)
-
-Type-safe, country-aware form validators for Ant Design forms with built-in internationalization and error messaging.
-
-### 🔄 Coming Soon
+Runtime dependency (auto-installed):
 
-- **Reusable React Components** - Pre-built UI components for financial applications
-- **Hooks Library** - Custom React hooks for common patterns
-- **Context Providers** - Application-wide state management
-- **Theme System** - Consistent design tokens and styling
-- **Utility Functions** - Helper functions for React applications
+- `@temboplus/frontend-core` — the pure utilities and domain entities the hooks wrap.
 
-## 📋 API Reference
+## Subpath imports
 
-### Form Validators
+Import the focused surface or the root entry; both work:
 
-All validators follow the Ant Design validator pattern and return Promise-based validation results.
+```ts
+// Focused (recommended — keeps your bundles honest):
+import { useTimezone } from "@temboplus/frontend-react-core/timezone";
 
-#### `PHONE_NUMBER_VALIDATOR(countryCode?: ISO2CountryCode)`
-
-Validates general phone number format using libphonenumber-js.
-
-```typescript
-import { PHONE_NUMBER_VALIDATOR } from '@temboplus/frontend-react-core';
-
-// Basic usage
-const rules = [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }];
-
-// Supported countries: TZ, KE, and all libphonenumber-js supported countries
+// Or the root:
+import { useTimezone } from "@temboplus/frontend-react-core";
 ```
 
-**Features:**
-- Validates phone number format for any country
-- Returns normalized E.164 format on success
-- Country-specific error messages
-- Supports international and local number formats
-
-#### `MOBILE_PHONE_VALIDATOR(countryCode?: ISO2CountryCode)`
-
-Validates mobile phone numbers eligible for payout operations (stricter validation).
+## Timezone hooks
 
-```typescript
-import { MOBILE_PHONE_VALIDATOR } from '@temboplus/frontend-react-core';
+Each app passes its own `storageKey` so timezone preferences don't collide across products sharing a browser origin. Wrap once in your app and use the bare hook everywhere:
 
-const rules = [{ required: true, validator: MOBILE_PHONE_VALIDATOR('TZ') }];
-```
-
-**Features:**
-- Validates mobile-specific number formats
-- Checks payout eligibility (supports TZ and KE)
-- MNO (Mobile Network Operator) validation
-- Returns normalized E.164 format
-
-#### `ACCOUNT_NAME_VALIDATOR`
-
-Validates bank account holder names.
+```ts
+// src/shared/lib/timezone.ts (or similar)
+import {
+  useTimezone as useTimezoneBase,
+  useTimezoneDate as useTimezoneDateBase,
+  useFormatDate as useFormatDateBase,
+  useFormatDateTime as useFormatDateTimeBase,
+  useFormatTime as useFormatTimeBase,
+} from "@temboplus/frontend-react-core/timezone";
 
-```typescript
-import { ACCOUNT_NAME_VALIDATOR } from '@temboplus/frontend-react-core';
+const STORAGE_KEY = "myapp.timezone";
 
-const rules = [{ required: true, validator: ACCOUNT_NAME_VALIDATOR }];
+export const useTimezone = () => useTimezoneBase({ storageKey: STORAGE_KEY });
+export const useTimezoneDate = () => useTimezoneDateBase({ storageKey: STORAGE_KEY });
+export const useFormatDate = () => useFormatDateBase({ storageKey: STORAGE_KEY });
+export const useFormatDateTime = () => useFormatDateTimeBase({ storageKey: STORAGE_KEY });
+export const useFormatTime = () => useFormatTimeBase({ storageKey: STORAGE_KEY });
 ```
 
-**Validation Rules:**
-- 3-50 characters length
-- Only letters, spaces, hyphens, apostrophes, commas
-- At least two words (first name + last name)
-- Not all uppercase
-- No numbers or special characters
+### `useTimezone()`
 
-#### `SWIFT_CODE_VALIDATOR(countryCode?: ISO2CountryCode)`
-
-Validates SWIFT/BIC codes for banks.
-
-```typescript
-import { SWIFT_CODE_VALIDATOR } from '@temboplus/frontend-react-core';
-
-// Country-specific validation
-const rules = [{ required: true, validator: SWIFT_CODE_VALIDATOR('TZ') }];
-
-// Multi-country validation
-const rules = [{ required: true, validator: SWIFT_CODE_VALIDATOR() }];
+```ts
+const [timezone, setTimezone] = useTimezone();
 ```
 
-**Features:**
-- Validates against known bank SWIFT codes
-- Country-specific validation (TZ, KE)
-- Automatic uppercase conversion
-- Real bank verification
-
-#### `ACCOUNT_NUMBER_VALIDATOR(countryCode?: ISO2CountryCode)`
-
-Validates bank account numbers with country-specific formats.
+- Reads from `localStorage[storageKey]` on mount (after first paint, to avoid SSR mismatch).
+- Falls back to `DEFAULT_TIMEZONE` (`"Africa/Nairobi"`) when nothing's stored.
+- `setTimezone(next)` validates against `Intl.supportedValuesOf("timeZone")` plus TemboPlus operating/anchor zones, then persists.
 
-```typescript
-import { ACCOUNT_NUMBER_VALIDATOR } from '@temboplus/frontend-react-core';
+### `useTimezoneDate()`
 
-const rules = [{ required: true, validator: ACCOUNT_NUMBER_VALIDATOR('KE') }];
-```
+Boundary helpers bound to the current timezone preference. Re-memoises when the preference changes.
 
-**Country-Specific Rules:**
-- **Kenya (KE)**: 10, 12, or 15 alphanumeric characters
-- **Tanzania (TZ)**: 9-19 characters
-- Automatic space removal and normalization
-
-#### `AMOUNT_VALIDATOR(options?: AmountValidatorOptions)`
-
-Validates monetary amounts with currency-specific constraints.
-
-```typescript
-import { AMOUNT_VALIDATOR } from '@temboplus/frontend-react-core';
-
-// Basic usage with defaults
-const rules = [{ required: true, validator: AMOUNT_VALIDATOR() }];
-
-// Custom configuration
-const rules = [{
-  required: true,
-  validator: AMOUNT_VALIDATOR({
-    currencyCode: 'KES',
-    min: 100,
-    max: 50000,
-    invalidFormatMessage: 'Please enter a valid amount',
-    minMessage: 'Minimum amount is 100 KES',
-    maxMessage: 'Maximum amount is 50,000 KES'
-  })
-}];
-
-// Disable constraints
-const rules = [{
-  required: true,
-  validator: AMOUNT_VALIDATOR({
-    currencyCode: 'USD',
-    min: null,    // No minimum
-    max: null,    // No maximum
-  })
-}];
-```
+```ts
+const { tz, startOfDay, endOfDay, parse, sameDay, toUtc } = useTimezoneDate();
 
-**Default Constraints:**
-- **TZS**: Min: 1,000, Max: 1,000,000
-- **KES**: Min: 40, Max: 40,000,000  
-- **Other**: Min: 1, Max: 1,000,000
-
-**Options:**
-```typescript
-interface AmountValidatorOptions {
-  currencyCode?: CurrencyCode;           // Default: 'TZS'
-  min?: number | null;                   // Default: currency-specific
-  max?: number | null;                   // Default: currency-specific
-  invalidFormatMessage?: string;         // Custom error message
-  minMessage?: string;                   // Custom minimum error
-  maxMessage?: string;                   // Custom maximum error
-}
+const utcStart = startOfDay(pickerDate);   // UTC instant of midnight in `tz`
+const utcEnd = endOfDay(pickerDate);
+const zoned = parse("2026-05-15T00:00:00Z"); // TZDate; getDate() reports `tz` wall clock
 ```
 
-**Features:**
-- Supports all currencies from @temboplus/frontend-core
-- Handles comma-separated numbers (1,000.50)
-- Rejects negative amounts
-- Currency-specific formatting
-- Returns normalized numeric format
-
-## 🎯 Usage Examples
+### `useFormatDate*()`
 
-### Complete Form Example
-
-```typescript
-import React from 'react';
-import { Form, Input, Button } from 'antd';
-import {
-  PHONE_NUMBER_VALIDATOR,
-  AMOUNT_VALIDATOR,
-  ACCOUNT_NAME_VALIDATOR,
-  SWIFT_CODE_VALIDATOR,
-  ACCOUNT_NUMBER_VALIDATOR,
-} from '@temboplus/frontend-react-core';
-
-const PayoutForm: React.FC = () => {
-  const [form] = Form.useForm();
-
-  const onFinish = (values: any) => {
-    console.log('Validated values:', values);
-  };
-
-  return (
-    <Form form={form} onFinish={onFinish} layout="vertical">
-      <Form.Item
-        label="Phone Number"
-        name="phoneNumber"
-        rules={[{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }]}
-      >
-        <Input placeholder="+255 712 345 678" />
-      </Form.Item>
-
-      <Form.Item
-        label="Amount"
-        name="amount"
-        rules={[{
-          required: true,
-          validator: AMOUNT_VALIDATOR({
-            currencyCode: 'TZS',
-            min: 1000,
-            max: 100000
-          })
-        }]}
-      >
-        <Input placeholder="10,000" />
-      </Form.Item>
-
-      <Form.Item
-        label="Account Name"
-        name="accountName"
-        rules={[{ required: true, validator: ACCOUNT_NAME_VALIDATOR }]}
-      >
-        <Input placeholder="John Smith" />
-      </Form.Item>
-
-      <Form.Item
-        label="Bank SWIFT Code"
-        name="swiftCode"
-        rules={[{ required: true, validator: SWIFT_CODE_VALIDATOR('TZ') }]}
-      >
-        <Input placeholder="CORUTZTZ" />
-      </Form.Item>
-
-      <Form.Item
-        label="Account Number"
-        name="accountNumber"
-        rules={[{ required: true, validator: ACCOUNT_NUMBER_VALIDATOR('TZ') }]}
-      >
-        <Input placeholder="123456789" />
-      </Form.Item>
-
-      <Form.Item>
-        <Button type="primary" htmlType="submit">
-          Submit
-        </Button>
-      </Form.Item>
-    </Form>
-  );
-};
-
-export default PayoutForm;
-```
+Reactive formatters. Re-render automatically when the user changes their timezone preference.
 
-### Multi-Country Support
-
-```typescript
-import { useState } from 'react';
-import { PHONE_NUMBER_VALIDATOR, AMOUNT_VALIDATOR } from '@temboplus/frontend-react-core';
-
-const MultiCountryForm: React.FC = () => {
-  const [selectedCountry, setSelectedCountry] = useState<'TZ' | 'KE'>('TZ');
-
-  const getValidationRules = () => ({
-    phoneNumber: [{ 
-      required: true, 
-      validator: PHONE_NUMBER_VALIDATOR(selectedCountry) 
-    }],
-    amount: [{ 
-      required: true, 
-      validator: AMOUNT_VALIDATOR({ 
-        currencyCode: selectedCountry === 'TZ' ? 'TZS' : 'KES' 
-      }) 
-    }]
-  });
-
-  // Rest of component...
-};
+```ts
+const fmtDateTime = useFormatDateTime();
+return <span>{fmtDateTime(row.createdAt)}</span>;  // "25 MAY 2026, 02:30 PM"
 ```
 
-## 🌍 Supported Countries
+Available variants:
 
-| Country  | Code | Phone | Mobile | Bank | Currency        |
-| -------- | ---- | ----- | ------ | ---- | --------------- |
-| Tanzania | TZ   | ✅     | ✅      | ✅    | TZS             |
-| Kenya    | KE   | ✅     | ✅      | ✅    | KES             |
-| Global   | *    | ✅     | ❌      | ❌    | 150+ currencies |
+| Hook | Output |
+|---|---|
+| `useFormatDate` | `25 MAY 2026` |
+| `useFormatDateTime` | `25 MAY 2026, 02:30 PM` |
+| `useFormatDateTimeWithSeconds` | `25 MAY 2026, 02:30:45 PM` |
+| `useFormatTime` | `02:30 PM` |
 
-## 🔧 Error Handling
+For non-React call sites, the imperative siblings live in [`@temboplus/frontend-core`](https://github.com/TemboPlus-Frontend/frontend-core-js):
 
-All validators provide clear, user-friendly error messages:
+```ts
+import { formatDateTime } from "@temboplus/frontend-core";
 
-```typescript
-// Phone validation errors
-"Invalid Tanzania phone number format. Please enter a valid Tanzania phone number."
-
-// Amount validation errors  
-"Amount must be at least TSh 1,000. Please enter a higher amount."
-"Negative amounts are not allowed. Please enter a positive amount."
-
-// Account name errors
-"Invalid account name. Please enter a valid full name with at least two words."
-
-// SWIFT code errors
-"Invalid Tanzania SWIFT code. Please enter a valid Tanzania bank SWIFT/BIC code."
+formatDateTime(date, "Africa/Nairobi");  // "25 MAY 2026, 02:30 PM"
 ```
 
-## 🏆 Best Practices
-
-### 1. Always Specify Country Context
-```typescript
-// ✅ Good - specific country validation
-validator: PHONE_NUMBER_VALIDATOR('TZ')
-
-// ❌ Less ideal - generic validation
-validator: PHONE_NUMBER_VALIDATOR()
-```
+## Development
 
-### 2. Combine with Required Rules
-```typescript
-// ✅ Good - explicit required validation
-rules: [
-  { required: true, message: 'Phone number is required' },
-  { validator: PHONE_NUMBER_VALIDATOR('TZ') }
-]
+Bun for everything, Biome for lint+format, mise for the toolchain pin.
 
-// ✅ Also good - validator handles required
-rules: [{ required: true, validator: PHONE_NUMBER_VALIDATOR('TZ') }]
-```
-
-### 3. Custom Error Messages
-```typescript
-// ✅ Good - custom business-specific messages
-validator: AMOUNT_VALIDATOR({
-  currencyCode: 'TZS',
-  min: 5000,
-  minMessage: 'Minimum transfer amount is TSh 5,000 for international transfers'
-})
-```
-
-### 4. Normalize Return Values
-```typescript
-const onFinish = (values: any) => {
-  // Validators return normalized values
-  console.log(values.phoneNumber); // "+255712345678" (E.164 format)
-  console.log(values.amount);      // "10000.00" (normalized number)
-  console.log(values.swiftCode);   // "CORUTZTZ" (uppercase)
-};
+```bash
+mise install        # one-time: installs pinned Bun
+bun install
+bun run dev         # rollup build in watch mode
 ```
 
-## 📄 License
+| Script | Does |
+| --- | --- |
+| `bun run dev` | Rollup build in watch mode |
+| `bun run build` | `tsc` declarations + Rollup bundles to `dist/` (CJS + ESM, each with a `"use client"` banner) |
+| `bun run test` | `bun:test` (passes with zero tests; smoke test only — bun:test has no DOM, so real hook tests live in consumer apps) |
+| `bun run lint` | Biome check |
+| `bun run format` | Biome auto-fix |
+| `bun run typecheck` | `tsc --noEmit` |
 
-Private package for TemboPlus applications.
+Tag-driven releases via `.github/workflows/release.yml` — update `CHANGELOG.md`, bump `package.json`, push a `vX.Y.Z` tag.
 
-## 🔗 Related Packages
+## License
 
-- **[@temboplus/frontend-core](https://github.com/TemboPlus-Frontend/temboplus-frontend-core)** - Core business logic and models
+[ISC](./LICENSE) © TemboPlus

package/dist/index.cjs.js

@@ -1,2 +1,16 @@
-"use strict";var n=require("./theme-provider-RhAw3jw_.js"),t=require("@ebay/nice-modal-react"),e=require("tslib"),s=require("react"),o=require("react-toastify");require("lodash");var r=require("./tembo-notify-Bp14qngd.js");function i(n){return n&&n.__esModule?n:{default:n}}require("antd"),require("./InfoCircleOutlined-B7d2aRfV.js"),require("./ZoomOutOutlined-CW-jqBMI.js");var a=i(t);const l=t=>n.jsxRuntimeExports.jsx(a.default.Provider,{children:t.children}),c=t=>{var{showCloseButton:i=!1,showProgressBar:a=!1}=t,l=e.__rest(t,["showCloseButton","showProgressBar"]);const{colors:c,constants:d}=n.useTemboTheme();return s.useEffect(()=>{r.TemboNotify.init(c,d)},[c,d]),n.jsxRuntimeExports.jsxs(n.jsxRuntimeExports.Fragment,{children:[n.jsxRuntimeExports.jsx(o.ToastContainer,Object.assign({closeButton:i,hideProgressBar:!a},l)),n.jsxRuntimeExports.jsx("style",{children:`\n                .Toastify__toast {\n                    font-family: ${d.typography.fontFamily};\n                    line-height: 1.5;\n                    display: flex;\n                    align-items: center; /* center icon + content */\n                }\n\n                .Toastify__toast-body {\n                    padding: 0;\n                    margin: 0;\n                    display: flex;\n                    align-items: flex-start;\n                }\n\n                .Toastify__toast-icon {\n                    width: 18px;\n                    display: flex;\n                    align-items: center;\n                    justify-content: center;\n                    margin-inline-end: 6px; /* tighter spacing */\n                }\n\n                .Toastify__progress-bar {\n                    display: none;\n                }\n\n                .Toastify__close-button {\n                    opacity: 0.5;\n                    transition: opacity 0.2s ease;\n                }\n\n                .Toastify__close-button:hover {\n                    opacity: 1;\n                }\n\n                /* Force progress bar hidden in case someone enables it unintentionally */\n                .Toastify__progress-bar {\n                    display: none;\n                }\n\n                /* Smooth entrance animation */\n                @keyframes toastSlideIn {\n                    from {\n                        transform: translateX(110%);\n                        opacity: 0;\n                    }\n                    to {\n                        transform: translateX(0);\n                        opacity: 1;\n                    }\n                }\n\n                .Toastify__toast--top-right {\n                    animation: toastSlideIn 0.3s ease-out;\n                }\n\n                /* Optional: full-width mobile behaviour */\n                @media (max-width: 480px) {\n                    .Toastify__toast-container--top-right {\n                        right: 0;\n                        left: 0;\n                        padding: 0;\n                        width: 100vw;\n                    }\n\n                    .Toastify__toast {\n                        margin-bottom: 0;\n                        border-radius: 0;\n                    }\n                }\n            `})]})};exports.TemboUIProviders=({children:t,colors:e,constants:s,themeOverrides:o})=>n.jsxRuntimeExports.jsx(n.TemboThemeProvider,{colors:e,constants:s,themeOverrides:o,children:n.jsxRuntimeExports.jsxs(l,{children:[t,n.jsxRuntimeExports.jsx(c,{})]})});
+"use client";
+'use strict';
+
+var useTimezoneDate = require('./use-timezone-date-s1Ru9Fw6.js');
+require('@temboplus/frontend-core');
+require('react');
+
+
+
+exports.useFormatDate = useTimezoneDate.useFormatDate;
+exports.useFormatDateTime = useTimezoneDate.useFormatDateTime;
+exports.useFormatDateTimeWithSeconds = useTimezoneDate.useFormatDateTimeWithSeconds;
+exports.useFormatTime = useTimezoneDate.useFormatTime;
+exports.useTimezone = useTimezoneDate.useTimezone;
+exports.useTimezoneDate = useTimezoneDate.useTimezoneDate;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/features/dialogs/modal-provider.tsx","../src/features/notifications/toast-container.tsx","../src/providers.tsx"],"sourcesContent":[null,null,null],"names":["TemboModalProvider","props","_jsx","NiceModal","Provider","children","TemboToastContainer","_a","showCloseButton","showProgressBar","rest","__rest","colors","constants","useTemboTheme","useEffect","TemboNotify","init","_jsxs","_Fragment","ToastContainer","Object","assign","closeButton","hideProgressBar","typography","fontFamily","themeOverrides","TemboThemeProvider"],"mappings":"kYAGA,MAAMA,EAAmDC,GAC9CC,EAAAA,kBAAAA,IAACC,EAAAA,QAAUC,mBAAUH,EAAMI,WCsBhCC,EAA2DC,IAAA,IAAAC,gBAC7DA,GAAkB,EAAKC,gBACvBA,GAAkB,GAAKF,EACpBG,EAAIC,EAAAA,OAAAJ,EAHsD,CAAA,kBAAA,oBAK7D,MAAMK,OAAEA,EAAMC,UAAEA,GAAcC,kBAM9B,OAJAC,EAAAA,UAAU,KACNC,cAAYC,KAAKL,EAAQC,IAC1B,CAACD,EAAQC,IAGRK,EAAAA,kBAAAA,KAAAC,EAAAA,kBAAAA,SAAA,CAAAd,SAAA,CACIH,EAAAA,kBAAAA,IAACkB,EAAAA,eAAcC,OAAAC,OAAA,CACXC,YAAaf,EACbgB,iBAAkBf,GACdC,IAGRR,EAAAA,kBAAAA,IAAA,QAAA,CAAAG,SAAQ,0EAEeQ,EAAUY,WAAWC,ovECJS,EAC7DrB,WACAO,SACAC,YACAc,oBAGIzB,EAAAA,kBAAAA,IAAC0B,qBAAkB,CACfhB,OAAQA,EACRC,UAAWA,EACXc,eAAgBA,EAActB,SAE9Ba,EAAAA,kBAAAA,KAAClB,EAAkB,CAAAK,SAAA,CACdA,EACDH,EAAAA,kBAAAA,IAACI,EAAmB,CAAA"}
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -1 +1,2 @@
-export * from "./providers.js";
+export * from "./timezone/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/index.esm.js

@@ -1,2 +1,5 @@
-import{j as n,u as t,T as o}from"./theme-provider-Ca4P0Hcp.js";import i from"@ebay/nice-modal-react";import{__rest as s}from"tslib";import{useEffect as e}from"react";import{ToastContainer as r}from"react-toastify";import"lodash";import{T as a}from"./tembo-notify-h5Xn66oA.js";import"antd";import"./InfoCircleOutlined-DYs90hdV.js";import"./ZoomOutOutlined-Pw8hpWWK.js";const l=t=>n.jsx(i.Provider,{children:t.children}),m=o=>{var{showCloseButton:i=!1,showProgressBar:l=!1}=o,m=s(o,["showCloseButton","showProgressBar"]);const{colors:c,constants:d}=t();return e(()=>{a.init(c,d)},[c,d]),n.jsxs(n.Fragment,{children:[n.jsx(r,Object.assign({closeButton:i,hideProgressBar:!l},m)),n.jsx("style",{children:`\n                .Toastify__toast {\n                    font-family: ${d.typography.fontFamily};\n                    line-height: 1.5;\n                    display: flex;\n                    align-items: center; /* center icon + content */\n                }\n\n                .Toastify__toast-body {\n                    padding: 0;\n                    margin: 0;\n                    display: flex;\n                    align-items: flex-start;\n                }\n\n                .Toastify__toast-icon {\n                    width: 18px;\n                    display: flex;\n                    align-items: center;\n                    justify-content: center;\n                    margin-inline-end: 6px; /* tighter spacing */\n                }\n\n                .Toastify__progress-bar {\n                    display: none;\n                }\n\n                .Toastify__close-button {\n                    opacity: 0.5;\n                    transition: opacity 0.2s ease;\n                }\n\n                .Toastify__close-button:hover {\n                    opacity: 1;\n                }\n\n                /* Force progress bar hidden in case someone enables it unintentionally */\n                .Toastify__progress-bar {\n                    display: none;\n                }\n\n                /* Smooth entrance animation */\n                @keyframes toastSlideIn {\n                    from {\n                        transform: translateX(110%);\n                        opacity: 0;\n                    }\n                    to {\n                        transform: translateX(0);\n                        opacity: 1;\n                    }\n                }\n\n                .Toastify__toast--top-right {\n                    animation: toastSlideIn 0.3s ease-out;\n                }\n\n                /* Optional: full-width mobile behaviour */\n                @media (max-width: 480px) {\n                    .Toastify__toast-container--top-right {\n                        right: 0;\n                        left: 0;\n                        padding: 0;\n                        width: 100vw;\n                    }\n\n                    .Toastify__toast {\n                        margin-bottom: 0;\n                        border-radius: 0;\n                    }\n                }\n            `})]})},c=({children:t,colors:i,constants:s,themeOverrides:e})=>n.jsx(o,{colors:i,constants:s,themeOverrides:e,children:n.jsxs(l,{children:[t,n.jsx(m,{})]})});export{c as TemboUIProviders};
+"use client";
+export { u as useFormatDate, a as useFormatDateTime, b as useFormatDateTimeWithSeconds, c as useFormatTime, d as useTimezone, e as useTimezoneDate } from './use-timezone-date-B-P03WD_.js';
+import '@temboplus/frontend-core';
+import 'react';
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/features/dialogs/modal-provider.tsx","../src/features/notifications/toast-container.tsx","../src/providers.tsx"],"sourcesContent":[null,null,null],"names":["TemboModalProvider","props","_jsx","NiceModal","Provider","children","TemboToastContainer","_a","showCloseButton","showProgressBar","rest","__rest","colors","constants","useTemboTheme","useEffect","TemboNotify","init","_jsxs","_Fragment","ToastContainer","Object","assign","closeButton","hideProgressBar","typography","fontFamily","TemboUIProviders","themeOverrides","TemboThemeProvider"],"mappings":"gXAGA,MAAMA,EAAmDC,GAC9CC,EAAAA,IAACC,EAAUC,mBAAUH,EAAMI,WCsBhCC,EAA2DC,IAAA,IAAAC,gBAC7DA,GAAkB,EAAKC,gBACvBA,GAAkB,GAAKF,EACpBG,EAAIC,EAAAJ,EAHsD,CAAA,kBAAA,oBAK7D,MAAMK,OAAEA,EAAMC,UAAEA,GAAcC,IAM9B,OAJAC,EAAU,KACNC,EAAYC,KAAKL,EAAQC,IAC1B,CAACD,EAAQC,IAGRK,EAAAA,KAAAC,EAAAA,SAAA,CAAAd,SAAA,CACIH,EAAAA,IAACkB,EAAcC,OAAAC,OAAA,CACXC,YAAaf,EACbgB,iBAAkBf,GACdC,IAGRR,EAAAA,IAAA,QAAA,CAAAG,SAAQ,0EAEeQ,EAAUY,WAAWC,2tECJ3CC,EAAoD,EAC7DtB,WACAO,SACAC,YACAe,oBAGI1B,EAAAA,IAAC2B,EAAkB,CACfjB,OAAQA,EACRC,UAAWA,EACXe,eAAgBA,EAAcvB,SAE9Ba,EAAAA,KAAClB,EAAkB,CAAAK,SAAA,CACdA,EACDH,EAAAA,IAACI,EAAmB,CAAA"}
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/timezone/index.cjs.js

@@ -0,0 +1,16 @@
+"use client";
+'use strict';
+
+var useTimezoneDate = require('../use-timezone-date-s1Ru9Fw6.js');
+require('@temboplus/frontend-core');
+require('react');
+
+
+
+exports.useFormatDate = useTimezoneDate.useFormatDate;
+exports.useFormatDateTime = useTimezoneDate.useFormatDateTime;
+exports.useFormatDateTimeWithSeconds = useTimezoneDate.useFormatDateTimeWithSeconds;
+exports.useFormatTime = useTimezoneDate.useFormatTime;
+exports.useTimezone = useTimezoneDate.useTimezone;
+exports.useTimezoneDate = useTimezoneDate.useTimezoneDate;
+//# sourceMappingURL=index.cjs.js.map

package/dist/{notifications → timezone}/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}

package/dist/timezone/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./use-format-date.js";
+export * from "./use-timezone.js";
+export * from "./use-timezone-date.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/timezone/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timezone/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/timezone/index.js

@@ -0,0 +1,5 @@
+"use client";
+export { u as useFormatDate, a as useFormatDateTime, b as useFormatDateTimeWithSeconds, c as useFormatTime, d as useTimezone, e as useTimezoneDate } from '../use-timezone-date-B-P03WD_.js';
+import '@temboplus/frontend-core';
+import 'react';
+//# sourceMappingURL=index.js.map

package/dist/{notifications → timezone}/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/timezone/use-format-date.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Centralised, reactive date-formatter hooks. Each returns a function
+ * `(date: Date) => string` bound to the user's current timezone
+ * preference. Consumers re-render automatically when the preference
+ * changes in Settings.
+ *
+ * For non-React call sites, import the imperative siblings directly
+ * from `@temboplus/frontend-core`.
+ */
+type Options = {
+    storageKey: string;
+    defaultTimezone?: string;
+};
+/** `25 MAY 2026` */
+export declare function useFormatDate(options: Options): (date: Date) => string;
+/** `25 MAY 2026, 02:30 PM` */
+export declare function useFormatDateTime(options: Options): (date: Date) => string;
+/** `25 MAY 2026, 02:30:45 PM` — audit rows where seconds matter. */
+export declare function useFormatDateTimeWithSeconds(options: Options): (date: Date) => string;
+/** `02:30 PM` */
+export declare function useFormatTime(options: Options): (date: Date) => string;
+export {};
+//# sourceMappingURL=use-format-date.d.ts.map

package/dist/timezone/use-format-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-format-date.d.ts","sourceRoot":"","sources":["../../src/timezone/use-format-date.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AAEH,KAAK,OAAO,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,oBAAoB;AACpB,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAGtE;AAED,8BAA8B;AAC9B,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAG1E;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAGrF;AAED,iBAAiB;AACjB,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAGtE"}

package/dist/timezone/use-timezone-date.d.ts

@@ -0,0 +1,18 @@
+import { toUtcInstant } from "@temboplus/frontend-core";
+/**
+ * Boundary helpers bound to the user's current timezone preference.
+ * Re-memoises when the preference changes so date pickers / range
+ * builders pick up the new offset automatically.
+ */
+export declare function useTimezoneDate(options: {
+    storageKey: string;
+    defaultTimezone?: string;
+}): {
+    tz: string;
+    startOfDay: (date: Date) => Date;
+    endOfDay: (date: Date) => Date;
+    parse: (iso: string) => import("@date-fns/tz").TZDate;
+    sameDay: (a: Date, b: Date) => boolean;
+    toUtc: typeof toUtcInstant;
+};
+//# sourceMappingURL=use-timezone-date.d.ts.map

package/dist/timezone/use-timezone-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-timezone-date.d.ts","sourceRoot":"","sources":["../../src/timezone/use-timezone-date.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,YAAY,EACb,MAAM,0BAA0B,CAAC;AAKlC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE;;uBAKhE,IAAI;qBACN,IAAI;iBACR,MAAM;iBACN,IAAI,KAAK,IAAI;;EAK/B"}