@npm-zenwork/tax-remittance-ui 0.1.0

package/dist/components/settings/AddBankAccountModal.d.ts

@@ -0,0 +1,8 @@
+interface AddBankAccountModalProps {
+    open: boolean;
+    entityId: number | null;
+    onClose: () => void;
+    onAccountAdded?: (bankAccountDetailId: number) => void;
+}
+export declare function AddBankAccountModal({ open, entityId, onClose, onAccountAdded, }: AddBankAccountModalProps): import("react").JSX.Element | null;
+export {};

package/dist/components/settings/BankAccountsSection.d.ts

@@ -0,0 +1,5 @@
+interface BankAccountsSectionProps {
+    entityId: number | null;
+}
+export declare function BankAccountsSection({ entityId }: BankAccountsSectionProps): import("react").JSX.Element;
+export {};

package/dist/components/settings/PaymentHistorySection.d.ts

@@ -0,0 +1,9 @@
+import { PaymentHistoryResponse } from '../../types/paymentHistory';
+interface PaymentHistorySectionProps {
+    entityId: number | null;
+    transactions?: PaymentHistoryResponse[];
+    isLoading?: boolean;
+    isError?: boolean;
+}
+export declare function PaymentHistorySection({ entityId, transactions, isLoading, isError, }: PaymentHistorySectionProps): import("react").JSX.Element;
+export {};

package/dist/components/settings/SettingsNav.d.ts

@@ -0,0 +1,8 @@
+import { SettingsNavItem, SettingsSectionId } from './settingsNavConfig';
+interface SettingsNavProps {
+    activeSection: SettingsSectionId;
+    onSectionChange: (section: SettingsSectionId) => void;
+    items: SettingsNavItem[];
+}
+export declare function SettingsNav({ activeSection, onSectionChange, items }: SettingsNavProps): import("react").JSX.Element;
+export {};

package/dist/components/settings/SettingsPlaceholderSection.d.ts

@@ -0,0 +1,6 @@
+import { SettingsSectionId } from './settingsNavConfig';
+interface SettingsPlaceholderSectionProps {
+    sectionId: Exclude<SettingsSectionId, 'bank-accounts'>;
+}
+export declare function SettingsPlaceholderSection({ sectionId }: SettingsPlaceholderSectionProps): import("react").JSX.Element;
+export {};

package/dist/components/settings/SettingsSectionHeader.d.ts

@@ -0,0 +1,9 @@
+import { ComponentType, SVGProps } from 'react';
+interface SettingsSectionHeaderProps {
+    title: string;
+    subtitle: string;
+    icon: ComponentType<SVGProps<SVGSVGElement>>;
+    action?: React.ReactNode;
+}
+export declare function SettingsSectionHeader({ title, subtitle, icon: Icon, action }: SettingsSectionHeaderProps): import("react").JSX.Element;
+export {};

package/dist/components/settings/TaxAccountsSection.d.ts

@@ -0,0 +1,9 @@
+import { TaxAccountResponse } from '../../types/taxAccount';
+interface TaxAccountsSectionProps {
+    entityId: number | null;
+    accounts?: TaxAccountResponse[];
+    isLoading?: boolean;
+    isError?: boolean;
+}
+export declare function TaxAccountsSection({ entityId, accounts, isLoading, isError, }: TaxAccountsSectionProps): import("react").JSX.Element;
+export {};

package/dist/components/settings/settingsNavConfig.d.ts

@@ -0,0 +1,9 @@
+import { ComponentType, SVGProps } from 'react';
+export type SettingsSectionId = 'bank-accounts' | 'tax-accounts' | 'payment-history' | 'entity-details';
+export interface SettingsNavItem {
+    id: SettingsSectionId;
+    title: string;
+    subtitle: string;
+    icon: ComponentType<SVGProps<SVGSVGElement>>;
+}
+export declare const settingsNavItems: SettingsNavItem[];

package/dist/components/tax-forms/TaxFormsTable.d.ts

@@ -0,0 +1,8 @@
+import { TaxFormResponse } from '../../types/taxForm';
+interface TaxFormsTableProps {
+    forms?: TaxFormResponse[];
+    isLoading?: boolean;
+    isError?: boolean;
+}
+export declare function TaxFormsTable({ forms, isLoading, isError }: TaxFormsTableProps): import("react").JSX.Element;
+export {};

package/dist/components/ui/Alert.d.ts

@@ -0,0 +1,7 @@
+interface AlertProps {
+    variant?: 'error' | 'info';
+    title?: string;
+    message: string;
+}
+export declare function Alert({ variant, title, message }: AlertProps): import("react").JSX.Element;
+export {};

package/dist/components/ui/Button.d.ts

@@ -0,0 +1,8 @@
+import { ButtonHTMLAttributes } from 'react';
+type ButtonVariant = 'primary' | 'secondary' | 'ghost';
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariant;
+    isLoading?: boolean;
+}
+export declare function Button({ variant, isLoading, className, children, disabled, ...props }: ButtonProps): import("react").JSX.Element;
+export {};

package/dist/components/ui/Input.d.ts

@@ -0,0 +1,7 @@
+import { InputHTMLAttributes } from 'react';
+interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
+    label: string;
+    error?: string;
+}
+export declare const Input: import('react').ForwardRefExoticComponent<InputProps & import('react').RefAttributes<HTMLInputElement>>;
+export {};

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Validates that VITE_API_BASE_URL is set for the SPA production build.
+ *
+ * DO NOT call this at module scope — when the library build compiles this file,
+ * import.meta.env.PROD is `true` but VITE_API_BASE_URL is `undefined`, so a
+ * top-level call would throw on every consumer import before React even mounts.
+ *
+ * The SPA calls this explicitly from main.tsx.
+ * Library consumers provide the URL via the apiBaseUrl prop on TaxRemittancePortal.
+ */
+export declare function validateClientConfig(): void;
+export declare function setRuntimeApiBaseUrl(url: string): void;
+export declare function setRuntimeAccessToken(token: string | null): void;
+export declare function getRuntimeAccessToken(): string | null;
+export declare function setRuntimeClientId(clientId: string): void;
+export declare function getRuntimeClientId(): string | null;
+export declare const config: {
+    /** Resolved API origin. Reads runtime override first, then env var. */
+    readonly apiBaseUrl: string;
+    apiVersion: string;
+};
+export declare function apiUrl(path: string): string;

package/dist/embedded/EmbeddedAuthContext.d.ts

@@ -0,0 +1,27 @@
+import { ReactNode } from 'react';
+interface EmbeddedAuthContextValue {
+    /** The access token provided by the host application. */
+    accessToken: string;
+}
+interface EmbeddedAuthProviderProps {
+    accessToken: string;
+    onSessionExpired?: () => void;
+    children: ReactNode;
+}
+/**
+ * Holds the host-provided access token and makes it available to the embedded
+ * widget's API calls. No login/register flow — auth is entirely the host's concern.
+ *
+ * The token is written to the module-level variable synchronously on every render.
+ * This means:
+ *   - Host-side token refresh (new accessToken prop) is picked up immediately.
+ *   - React Strict Mode's double-mount never creates a window where the token is null,
+ *     because the synchronous render-time write runs before any async fetch can fire.
+ *
+ * No cleanup on unmount: when this component unmounts there are no more renders
+ * and therefore no more API calls from this widget instance. A stale value in the
+ * module-level variable is harmless — the next mounted instance will overwrite it.
+ */
+export declare function EmbeddedAuthProvider({ accessToken, onSessionExpired, children, }: EmbeddedAuthProviderProps): import("react").JSX.Element;
+export declare function useEmbeddedAuth(): EmbeddedAuthContextValue;
+export {};

package/dist/embedded/EmbeddedContext.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+import { EntityDetailsResponse } from '../types/entity';
+interface EmbeddedContextValue {
+    entities: EntityDetailsResponse[];
+    isLoading: boolean;
+    selectedEntity: EntityDetailsResponse | null;
+    setSelectedEntityId: (id: number) => void;
+    refetchEntities: () => Promise<void>;
+}
+interface EmbeddedContextProviderProps {
+    onOrganizationCreated?: (org: EntityDetailsResponse) => void;
+    children: ReactNode;
+}
+export declare function EmbeddedContextProvider({ onOrganizationCreated, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
+export declare function useEmbeddedContext(): EmbeddedContextValue;
+export {};

package/dist/embedded/EmbeddedLayout.d.ts

@@ -0,0 +1,18 @@
+import { EntityDetailsResponse } from '../types/entity';
+/**
+ * Outlet context shape shared by every payment/settings/tax-forms page —
+ * originally defined alongside the (now removed) standalone SPA's AppLayout.
+ * EmbeddedLayout provides the same shape below so these pages need no changes.
+ */
+export interface PortalOutletContext {
+    entities: EntityDetailsResponse[];
+    selectedEntity: EntityDetailsResponse | null;
+    setSelectedEntityId: (entityId: number) => void;
+}
+/**
+ * Minimal shell for the embedded widget — no sidebar, no header branding.
+ * Renders a compact top bar with:
+ *   - Entity selector (dropdown) when multiple entities exist
+ *   - Back button when on a sub-page
+ */
+export declare function EmbeddedLayout(): import("react").JSX.Element;

package/dist/embedded/EmbeddedRoutes.d.ts

@@ -0,0 +1,10 @@
+import { PaymentsMode } from '../pages/PaymentsPage';
+interface EmbeddedRoutesProps {
+    paymentsMode?: PaymentsMode;
+}
+/**
+ * Full route tree for TaxRemittanceEmbedded (all sections).
+ * Providers and NavigationSync live in EmbeddedWidgetBase — this is just <Routes>.
+ */
+export declare function EmbeddedRoutes({ paymentsMode }: EmbeddedRoutesProps): import("react").JSX.Element;
+export {};

package/dist/embedded/EmbeddedWidgetBase.d.ts

@@ -0,0 +1,28 @@
+import { MutableRefObject, ReactNode } from 'react';
+import { TaxRemittanceTheme } from './ThemeProvider';
+import { EmbeddedRouteKey } from './TaxRemittanceEmbedded';
+import { EntityDetailsResponse } from '../types/entity';
+export type { TaxRemittanceTheme };
+export interface EmbeddedWidgetBaseProps {
+    appKey: string;
+    accessToken: string;
+    apiBaseUrl: string;
+    theme?: TaxRemittanceTheme;
+    onSessionExpired?: () => void;
+    onOrganizationCreated?: (org: EntityDetailsResponse) => void;
+    onNavigate?: (routeKey: EmbeddedRouteKey, pathname: string) => void;
+    navigateFnRef: MutableRefObject<((path: string) => void) | null>;
+    /** The <Routes> subtree specific to this widget. */
+    children: ReactNode;
+}
+/**
+ * Shared provider stack reused by every widget (TaxRemittanceEmbedded,
+ * FederalPaymentWidget, StatePaymentWidget, etc.).
+ *
+ * Wraps children with:
+ *   ThemeProvider → QueryClientProvider → EmbeddedAuthProvider →
+ *   MemoryRouter → EmbeddedContextProvider + NavigationSync
+ *
+ * Children should be a <Routes> element with the widget-specific route tree.
+ */
+export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, navigateFnRef, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;

package/dist/embedded/EntityGate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Gate route at "/".
+ * Reads entity state from EmbeddedContextProvider (which wraps the whole route tree)
+ * and redirects the user to the right starting screen:
+ *
+ *   Loading    → spinner
+ *   No entities → /create-entity
+ *   Has entities → /dashboard
+ */
+export declare function EntityGate(): import("react").JSX.Element | null;

package/dist/embedded/TaxRemittanceEmbedded.d.ts

@@ -0,0 +1,60 @@
+import { TaxRemittanceTheme } from './EmbeddedWidgetBase';
+import { EntityDetailsResponse } from '../types/entity';
+export type { TaxRemittanceTheme };
+/**
+ * The top-level section the widget is currently showing.
+ * Returned by `onNavigate` so the host can highlight the correct sidebar item.
+ */
+export type EmbeddedRouteKey = 'dashboard' | 'payments' | 'tax-forms' | 'settings' | 'create-entity' | 'other';
+/**
+ * Imperative handle exposed via `ref` on `TaxRemittanceEmbedded`.
+ * Lets the host app navigate the widget to a specific internal path
+ * without going through props.
+ *
+ * @example
+ * const widgetRef = useRef<TaxRemittanceEmbeddedHandle>(null)
+ * widgetRef.current?.navigate('/payments')
+ */
+export interface TaxRemittanceEmbeddedHandle {
+    navigate: (path: string) => void;
+}
+export interface TaxRemittanceEmbeddedProps {
+    /**
+     * The public client ID obtained from the Dev Portal (pk_...).
+     * Sent as X-Client-ID on every request to scope data to this client's tenant.
+     */
+    appKey: string;
+    /**
+     * Short-lived JWT issued by POST /api/v1/auth/embedded-login.
+     * Never pass a secret API key here — only the access token.
+     */
+    accessToken: string;
+    /**
+     * Base URL of the Tax Remittance API, e.g. "https://api.zenwork.com".
+     */
+    apiBaseUrl: string;
+    /** Optional visual theme overrides. */
+    theme?: TaxRemittanceTheme;
+    /**
+     * Called when the user's session expires (401/403 from the API).
+     * Use this to redirect to your own login page.
+     */
+    onSessionExpired?: () => void;
+    /**
+     * Called immediately after a new organization/entity is created inside the widget.
+     */
+    onOrganizationCreated?: (org: EntityDetailsResponse) => void;
+    /**
+     * Called every time the widget's internal route changes.
+     * Use this to keep the host app's sidebar selection in sync with the widget.
+     */
+    onNavigate?: (routeKey: EmbeddedRouteKey, pathname: string) => void;
+}
+/**
+ * Full embedded widget — all sections (dashboard, payments, tax forms, settings).
+ *
+ * For clients that need only a subset, use the scoped widgets instead:
+ *   - FederalPaymentWidget — federal payments + dashboard + settings
+ *   - StatePaymentWidget   — state payments + dashboard + settings
+ */
+export declare const TaxRemittanceEmbedded: import('react').ForwardRefExoticComponent<TaxRemittanceEmbeddedProps & import('react').RefAttributes<TaxRemittanceEmbeddedHandle>>;

package/dist/embedded/ThemeProvider.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode } from 'react';
+export interface TaxRemittanceTheme {
+    /**
+     * Primary color — main CTA buttons, active nav items, focus rings.
+     * Default: #2563eb (blue-600)
+     */
+    primaryColor?: string;
+    /**
+     * Secondary color — badges, tab highlights, secondary action accents.
+     * Default: #0891b2 (cyan-600)
+     */
+    secondaryColor?: string;
+    /**
+     * Tertiary color — info panels, soft background tints, tertiary accents.
+     * Default: #7c3aed (violet-600)
+     */
+    tertiaryColor?: string;
+    /**
+     * Border radius applied to cards, inputs, and buttons.
+     * Default: 0.5rem
+     */
+    borderRadius?: string;
+    /**
+     * Font family for the embedded widget.
+     * Default: inherits from the host page.
+     */
+    fontFamily?: string;
+}
+interface ThemeProviderProps {
+    theme?: TaxRemittanceTheme;
+    children: ReactNode;
+}
+/**
+ * Injects the client's brand colors as CSS custom properties on the
+ * `.tax-remittance-embedded` wrapper div.
+ *
+ * Three color slots — primary, secondary, tertiary — each also get
+ * a computed `-dark` variant (10 % darker) and a `-light` variant
+ * (15 % of the color over white) so components can use consistent
+ * hover/tint states without the client needing to specify every shade.
+ *
+ * `index.css` maps Tailwind's `--color-brand-*` tokens to these vars
+ * inside the `.tax-remittance-embedded` scope, so shared components
+ * like `<Button>` and `<Input>` automatically respect client themes.
+ */
+export declare function ThemeProvider({ theme, children }: ThemeProviderProps): import("react").JSX.Element;
+export {};

package/dist/embedded/pages/EmbeddedCreateEntityPage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Embedded version of the Create Entity landing page.
+ * No SignOutButton, no full-screen shell — just the card in a centered container.
+ * After clicking "Create Entity", navigates to the entity form with /dashboard as
+ * the return destination so the form redirects there on success.
+ */
+export declare function EmbeddedCreateEntityPage(): import("react").JSX.Element;

package/dist/embedded/pages/EmbeddedDashboardPage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Embedded version of the Dashboard page.
+ * Uses useEmbeddedContext() instead of useOutletContext() so it works inside
+ * the embedded widget without depending on AppLayout's outlet context.
+ */
+export declare function EmbeddedDashboardPage(): import("react").JSX.Element;

package/dist/embedded/pages/EmbeddedEntityFormPage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Embedded version of the Entity Form page.
+ * No SignOutButton, no full-screen shell.
+ *
+ * After the form submits successfully, EntityForm navigates to the return path
+ * set by EmbeddedCreateEntityPage (state.from = '/dashboard'), and
+ * EmbeddedContextProvider detects the new entity and fires onOrganizationCreated.
+ */
+export declare function EmbeddedEntityFormPage(): import("react").JSX.Element;

package/dist/embedded/widgets/FederalPaymentWidget.d.ts

@@ -0,0 +1,22 @@
+import { TaxRemittanceEmbeddedProps, TaxRemittanceEmbeddedHandle } from '../TaxRemittanceEmbedded';
+/**
+ * Federal-only embedded widget.
+ * Includes: dashboard, federal payments (full flow), settings, entity creation.
+ * State payments and tax forms are excluded — those routes do not exist.
+ *
+ * @example
+ * const widgetRef = useRef<FederalPaymentWidgetHandle>(null)
+ *
+ * <FederalPaymentWidget
+ *   ref={widgetRef}
+ *   appKey="pk_..."
+ *   accessToken={token}
+ *   apiBaseUrl="https://api.zenwork.com"
+ *   theme={{ primaryColor: '#1d4ed8' }}
+ *   onSessionExpired={() => logout()}
+ *   onNavigate={(routeKey, pathname) => syncSidebar(routeKey)}
+ * />
+ */
+export type FederalPaymentWidgetProps = TaxRemittanceEmbeddedProps;
+export type FederalPaymentWidgetHandle = TaxRemittanceEmbeddedHandle;
+export declare const FederalPaymentWidget: import('react').ForwardRefExoticComponent<TaxRemittanceEmbeddedProps & import('react').RefAttributes<TaxRemittanceEmbeddedHandle>>;

package/dist/embedded/widgets/StatePaymentWidget.d.ts

@@ -0,0 +1,22 @@
+import { TaxRemittanceEmbeddedProps, TaxRemittanceEmbeddedHandle } from '../TaxRemittanceEmbedded';
+/**
+ * State-only embedded widget.
+ * Includes: dashboard, state payments (full flow), settings, entity creation.
+ * Federal payments and tax forms are excluded — those routes do not exist.
+ *
+ * @example
+ * const widgetRef = useRef<StatePaymentWidgetHandle>(null)
+ *
+ * <StatePaymentWidget
+ *   ref={widgetRef}
+ *   appKey="pk_..."
+ *   accessToken={token}
+ *   apiBaseUrl="https://api.zenwork.com"
+ *   theme={{ primaryColor: '#7c3aed' }}
+ *   onSessionExpired={() => logout()}
+ *   onNavigate={(routeKey, pathname) => syncSidebar(routeKey)}
+ * />
+ */
+export type StatePaymentWidgetProps = TaxRemittanceEmbeddedProps;
+export type StatePaymentWidgetHandle = TaxRemittanceEmbeddedHandle;
+export declare const StatePaymentWidget: import('react').ForwardRefExoticComponent<TaxRemittanceEmbeddedProps & import('react').RefAttributes<TaxRemittanceEmbeddedHandle>>;