@happyvertical/smrt-sales 0.39.2

package/dist/svelte/components/SalesDashboard.svelte.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SalesDashboard — CRM composition surface (#1924).
+ *
+ * Summary tiles (open opportunity count, open pipeline value per stage, win
+ * rate) computed from props via the exported pure helpers in `types.ts`, plus
+ * snippet props to embed the board and list surfaces underneath. Multi-currency
+ * pipelines render one total line per currency — amounts are never summed
+ * across currencies.
+ */
+import type { Snippet } from 'svelte';
+import type { OpportunityCardView, PipelineStageView } from '../types.js';
+export interface Props {
+    /** All opportunities in scope (open and closed — closed feed the win rate). */
+    opportunities?: OpportunityCardView[];
+    /** Pipeline stages, in order (for the per-stage value breakdown). */
+    stages?: PipelineStageView[];
+    /** BCP 47 locale for money/percent formatting. */
+    locale?: string;
+    /** Embedded pipeline board (e.g. an `OpportunityBoard`). */
+    board?: Snippet;
+    /** Embedded lead/opportunity list (e.g. a `LeadList`). */
+    list?: Snippet;
+    /** Additional embedded content rendered last. */
+    children?: Snippet;
+}
+declare const SalesDashboard: import("svelte").Component<Props, {}, "">;
+type SalesDashboard = ReturnType<typeof SalesDashboard>;
+export default SalesDashboard;
+//# sourceMappingURL=SalesDashboard.svelte.d.ts.map

package/dist/svelte/components/SalesDashboard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SalesDashboard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/SalesDashboard.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAS1E,MAAM,WAAW,KAAK;IACpB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACtC,qEAAqE;IACrE,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAwFD,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/svelte/format.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Render-time formatting helpers for the sales Svelte surfaces.
+ *
+ * All monetary values across `@happyvertical/smrt-sales` are integer cents
+ * (`*Cents` fields); these helpers convert to display strings at the render
+ * boundary only — view models keep the raw cents. Every helper is pure and
+ * locale-parameterised so it stays deterministic under test.
+ *
+ * @module
+ */
+/** Placeholder rendered for absent/unparseable values. */
+export declare const EMPTY_VALUE_PLACEHOLDER = "\u2014";
+/**
+ * Format integer cents as a localized currency string in major units.
+ *
+ * Negative-safe (clawbacks/adjustments render as negative amounts) and
+ * tolerant of accidental float inputs (rounded to whole cents first,
+ * half-away-from-zero — the module's `roundCents()` contract). Unknown
+ * currency codes fall back to `"<major-units> <code>"` instead of throwing.
+ *
+ * @param amountCents - Amount in integer cents (may be negative).
+ * @param currency - ISO 4217 currency code, e.g. `'USD'`.
+ * @param locale - BCP 47 locale; defaults to the runtime locale.
+ */
+export declare function formatCents(amountCents: number, currency: string, locale?: string): string;
+/**
+ * Format a date-ish value as a localized medium date (e.g. `Mar 5, 2026`).
+ *
+ * `null`/`undefined`/empty/unparseable inputs render the shared
+ * {@link EMPTY_VALUE_PLACEHOLDER} so optional lifecycle timestamps
+ * (`qualifiedAt`, `paidAt`, …) can be passed straight through.
+ *
+ * @param d - A `Date`, an ISO-8601 string, or `null`/`undefined`.
+ * @param locale - BCP 47 locale; defaults to the runtime locale.
+ */
+export declare function formatDate(d: Date | string | null | undefined, locale?: string): string;
+/**
+ * Format a 0–1 fraction as a localized percentage with at most one decimal
+ * (e.g. `0.5` → `50%`, `0.333` → `33.3%`). Used for credit fractions, split
+ * shares, plan rates, and win rates.
+ *
+ * @param fraction - Fraction in the 0–1 range (values outside still format).
+ * @param locale - BCP 47 locale; defaults to the runtime locale.
+ */
+export declare function formatPercent(fraction: number, locale?: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/svelte/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/svelte/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,WAAM,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAcR;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvE"}

package/dist/svelte/format.js

@@ -0,0 +1,75 @@
+/**
+ * Render-time formatting helpers for the sales Svelte surfaces.
+ *
+ * All monetary values across `@happyvertical/smrt-sales` are integer cents
+ * (`*Cents` fields); these helpers convert to display strings at the render
+ * boundary only — view models keep the raw cents. Every helper is pure and
+ * locale-parameterised so it stays deterministic under test.
+ *
+ * @module
+ */
+/** Placeholder rendered for absent/unparseable values. */
+export const EMPTY_VALUE_PLACEHOLDER = '—';
+/**
+ * Format integer cents as a localized currency string in major units.
+ *
+ * Negative-safe (clawbacks/adjustments render as negative amounts) and
+ * tolerant of accidental float inputs (rounded to whole cents first,
+ * half-away-from-zero — the module's `roundCents()` contract). Unknown
+ * currency codes fall back to `"<major-units> <code>"` instead of throwing.
+ *
+ * @param amountCents - Amount in integer cents (may be negative).
+ * @param currency - ISO 4217 currency code, e.g. `'USD'`.
+ * @param locale - BCP 47 locale; defaults to the runtime locale.
+ */
+export function formatCents(amountCents, currency, locale) {
+    if (!Number.isFinite(amountCents))
+        return EMPTY_VALUE_PLACEHOLDER;
+    const sign = amountCents < 0 ? -1 : 1;
+    const wholeCents = sign * Math.round(Math.abs(amountCents));
+    const major = wholeCents / 100;
+    try {
+        return new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency,
+        }).format(major);
+    }
+    catch {
+        // Unknown/invalid currency code — keep the surface rendering.
+        return `${major.toFixed(2)} ${currency}`.trim();
+    }
+}
+/**
+ * Format a date-ish value as a localized medium date (e.g. `Mar 5, 2026`).
+ *
+ * `null`/`undefined`/empty/unparseable inputs render the shared
+ * {@link EMPTY_VALUE_PLACEHOLDER} so optional lifecycle timestamps
+ * (`qualifiedAt`, `paidAt`, …) can be passed straight through.
+ *
+ * @param d - A `Date`, an ISO-8601 string, or `null`/`undefined`.
+ * @param locale - BCP 47 locale; defaults to the runtime locale.
+ */
+export function formatDate(d, locale) {
+    if (d == null || d === '')
+        return EMPTY_VALUE_PLACEHOLDER;
+    const date = d instanceof Date ? d : new Date(d);
+    if (Number.isNaN(date.getTime()))
+        return EMPTY_VALUE_PLACEHOLDER;
+    return new Intl.DateTimeFormat(locale, { dateStyle: 'medium' }).format(date);
+}
+/**
+ * Format a 0–1 fraction as a localized percentage with at most one decimal
+ * (e.g. `0.5` → `50%`, `0.333` → `33.3%`). Used for credit fractions, split
+ * shares, plan rates, and win rates.
+ *
+ * @param fraction - Fraction in the 0–1 range (values outside still format).
+ * @param locale - BCP 47 locale; defaults to the runtime locale.
+ */
+export function formatPercent(fraction, locale) {
+    if (!Number.isFinite(fraction))
+        return EMPTY_VALUE_PLACEHOLDER;
+    return new Intl.NumberFormat(locale, {
+        style: 'percent',
+        maximumFractionDigits: 1,
+    }).format(fraction);
+}

package/dist/svelte/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `@happyvertical/smrt-sales/svelte` — reusable sales surfaces
+ * (#1924, #1931, #1933).
+ *
+ * Props-driven, presentational Svelte 5 components: the CRM dashboard/list/
+ * board/detail set, the referrer portal (share links, referral status,
+ * earnings explanation, payout history, executed agreements), and the
+ * operator surfaces (attribution conflict queue, payout batch review, and the
+ * commission-expense summary kept separate from client invoices).
+ *
+ * No component fetches data or imports model classes — hosts map rows onto
+ * the exported view-model interfaces and wire the action callbacks. Monetary
+ * props stay integer cents; `format.ts` converts at render time. Everything
+ * works without `@happyvertical/smrt-svelte`'s `<Provider>` (only Provider-free
+ * `@happyvertical/smrt-ui` primitives are used).
+ *
+ * @packageDocumentation
+ */
+import type { ComponentProps } from 'svelte';
+import AttributionConflictQueue from './components/AttributionConflictQueue.svelte';
+import CommissionBreakdown from './components/CommissionBreakdown.svelte';
+import CommissionExpenseSummary from './components/CommissionExpenseSummary.svelte';
+import ExecutedAgreementsList from './components/ExecutedAgreementsList.svelte';
+import LeadList from './components/LeadList.svelte';
+import OpportunityBoard from './components/OpportunityBoard.svelte';
+import OpportunityDetail from './components/OpportunityDetail.svelte';
+import PayoutBatchReview from './components/PayoutBatchReview.svelte';
+import PayoutHistoryList from './components/PayoutHistoryList.svelte';
+import ReferralLinkManager from './components/ReferralLinkManager.svelte';
+import ReferralStatusList from './components/ReferralStatusList.svelte';
+import ReferrerEarningsSummary from './components/ReferrerEarningsSummary.svelte';
+import SalesDashboard from './components/SalesDashboard.svelte';
+export { AttributionConflictQueue, CommissionBreakdown, CommissionExpenseSummary, ExecutedAgreementsList, LeadList, OpportunityBoard, OpportunityDetail, PayoutBatchReview, PayoutHistoryList, ReferralLinkManager, ReferralStatusList, ReferrerEarningsSummary, SalesDashboard, };
+export type AttributionConflictQueueProps = ComponentProps<typeof AttributionConflictQueue>;
+export type CommissionBreakdownProps = ComponentProps<typeof CommissionBreakdown>;
+export type CommissionExpenseSummaryProps = ComponentProps<typeof CommissionExpenseSummary>;
+export type ExecutedAgreementsListProps = ComponentProps<typeof ExecutedAgreementsList>;
+export type LeadListProps = ComponentProps<typeof LeadList>;
+export type OpportunityBoardProps = ComponentProps<typeof OpportunityBoard>;
+export type OpportunityDetailProps = ComponentProps<typeof OpportunityDetail>;
+export type PayoutBatchReviewProps = ComponentProps<typeof PayoutBatchReview>;
+export type PayoutHistoryListProps = ComponentProps<typeof PayoutHistoryList>;
+export type ReferralLinkManagerProps = ComponentProps<typeof ReferralLinkManager>;
+export type ReferralStatusListProps = ComponentProps<typeof ReferralStatusList>;
+export type ReferrerEarningsSummaryProps = ComponentProps<typeof ReferrerEarningsSummary>;
+export type SalesDashboardProps = ComponentProps<typeof SalesDashboard>;
+export { EMPTY_VALUE_PLACEHOLDER, formatCents, formatDate, formatPercent, } from './format.js';
+export type { AgreementVersionView, AttributionAward, AttributionCandidateView, AttributionExceptionView, AwardValidation, BoardColumn, ClosedOpportunityOutcome, CommissionAdjustmentView, CommissionExpenseRowView, CommissionExpenseTotals, CommissionFormulaParts, CommissionRowView, CommissionTraceView, ConversionLinkView, CreateReferralLinkDraft, CurrencyAmount, DateInput, EarnerBalance, LeadListItemView, NextActionView, OpportunityCardView, OpportunityDetailView, PayoutActions, PayoutBatchReviewItemView, PayoutTimelineStep, PayoutView, PipelineStageView, RecordActivityDraft, ReferralLinkView, ReferralStatusView, SalesActivityView, SalesRepOptionView, StagePipelineSummary, StatusBadgeVariant, } from './types.js';
+export { AWARD_FRACTION_TOLERANCE, adjacentStageIds, agreementStatusBadgeVariant, buildShareUrl, canQualifyLead, commissionStatusBadgeVariant, equalSplitAwards, formatCommissionFormula, formatPlanRef, groupOpportunitiesByStage, isHttpUrl, isOverdue, leadStatusBadgeVariant, openOpportunityCount, openPipelineTotals, opportunityStatusBadgeVariant, payoutActionsFor, payoutStatusBadgeVariant, payoutStatusTimeline, pipelineValueByStage, referralLinkStatusBadgeVariant, referralStatusBadgeVariant, sumExpenseRowsByCurrency, uniqueCandidateReferrerIds, validateAwards, winRate, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"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"}

package/dist/svelte/index.js

@@ -0,0 +1,37 @@
+/**
+ * `@happyvertical/smrt-sales/svelte` — reusable sales surfaces
+ * (#1924, #1931, #1933).
+ *
+ * Props-driven, presentational Svelte 5 components: the CRM dashboard/list/
+ * board/detail set, the referrer portal (share links, referral status,
+ * earnings explanation, payout history, executed agreements), and the
+ * operator surfaces (attribution conflict queue, payout batch review, and the
+ * commission-expense summary kept separate from client invoices).
+ *
+ * No component fetches data or imports model classes — hosts map rows onto
+ * the exported view-model interfaces and wire the action callbacks. Monetary
+ * props stay integer cents; `format.ts` converts at render time. Everything
+ * works without `@happyvertical/smrt-svelte`'s `<Provider>` (only Provider-free
+ * `@happyvertical/smrt-ui` primitives are used).
+ *
+ * @packageDocumentation
+ */
+import AttributionConflictQueue from './components/AttributionConflictQueue.svelte';
+import CommissionBreakdown from './components/CommissionBreakdown.svelte';
+import CommissionExpenseSummary from './components/CommissionExpenseSummary.svelte';
+import ExecutedAgreementsList from './components/ExecutedAgreementsList.svelte';
+import LeadList from './components/LeadList.svelte';
+import OpportunityBoard from './components/OpportunityBoard.svelte';
+import OpportunityDetail from './components/OpportunityDetail.svelte';
+import PayoutBatchReview from './components/PayoutBatchReview.svelte';
+import PayoutHistoryList from './components/PayoutHistoryList.svelte';
+import ReferralLinkManager from './components/ReferralLinkManager.svelte';
+import ReferralStatusList from './components/ReferralStatusList.svelte';
+import ReferrerEarningsSummary from './components/ReferrerEarningsSummary.svelte';
+import SalesDashboard from './components/SalesDashboard.svelte';
+// Components
+export { AttributionConflictQueue, CommissionBreakdown, CommissionExpenseSummary, ExecutedAgreementsList, LeadList, OpportunityBoard, OpportunityDetail, PayoutBatchReview, PayoutHistoryList, ReferralLinkManager, ReferralStatusList, ReferrerEarningsSummary, SalesDashboard, };
+// Formatting helpers
+export { EMPTY_VALUE_PLACEHOLDER, formatCents, formatDate, formatPercent, } from './format.js';
+// View models and pure helpers
+export { AWARD_FRACTION_TOLERANCE, adjacentStageIds, agreementStatusBadgeVariant, buildShareUrl, canQualifyLead, commissionStatusBadgeVariant, equalSplitAwards, formatCommissionFormula, formatPlanRef, groupOpportunitiesByStage, isHttpUrl, isOverdue, leadStatusBadgeVariant, openOpportunityCount, openPipelineTotals, opportunityStatusBadgeVariant, payoutActionsFor, payoutStatusBadgeVariant, payoutStatusTimeline, pipelineValueByStage, referralLinkStatusBadgeVariant, referralStatusBadgeVariant, sumExpenseRowsByCurrency, uniqueCandidateReferrerIds, validateAwards, winRate, } from './types.js';