@hub-kit/core 0.3.0

package/dist/adapters/properties.d.ts

@@ -0,0 +1,87 @@
+import type { QueryResult } from "../lib/query-result";
+import type { StatusTone } from "./processing-log";
+export type PropertyVatStatus = "taxable" | "taxExempt" | "mixed";
+export interface Property {
+    id: string;
+    code: string;
+    name: string | null;
+    address: string | null;
+    vatStatus: PropertyVatStatus | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface PropertyCompany {
+    id: string;
+    code: string;
+    name: string;
+}
+export interface PropertyInvoiceTotals {
+    bookedAmount: number;
+    invoiceCount: number;
+}
+export interface PropertyInvoiceVatLine {
+    rate: number | null;
+    netAmount: number | null;
+}
+export interface PropertyInvoice {
+    id: string;
+    supplierName: string | null;
+    invoiceNumber: string | null;
+    companyCode: string | null;
+    documentDate: string | null;
+    vatRate: number | null;
+    vatLines: PropertyInvoiceVatLine[] | null;
+    amountGross: number | null;
+    status: string | null;
+}
+export interface PropertyNameVariant {
+    id: string;
+    text: string;
+}
+export type NameVariantRejectionReason = "alreadyExists" | "claimedByOther";
+export interface PropertyChanges {
+    name?: string | null;
+    address?: string | null;
+    vatStatus?: PropertyVatStatus | null;
+}
+export interface PropertiesAdapter {
+    useProperties(): QueryResult<Property[]>;
+    useProperty(code: string): QueryResult<Property | null>;
+    useCompanies(): QueryResult<PropertyCompany[]>;
+    /** Company ids assigned to each property, keyed by property id. */
+    useCompanyIdsByPropertyId(): QueryResult<Record<string, string[]>>;
+    /** Booked invoice volume and count per property, keyed by property id. */
+    useInvoiceTotalsByPropertyId(): QueryResult<Record<string, PropertyInvoiceTotals>>;
+    usePropertyInvoices(code: string): QueryResult<PropertyInvoice[]>;
+    useNameVariants(propertyCode: string): QueryResult<PropertyNameVariant[]>;
+    createProperty(input: {
+        code: string;
+        name: string | null;
+        address: string | null;
+        vatStatus: PropertyVatStatus | null;
+    }): Promise<Property>;
+    updateProperty(input: {
+        propertyId: string;
+        changes: PropertyChanges;
+    }): Promise<void>;
+    setPropertyCompanies(input: {
+        propertyId: string;
+        companyIds: string[];
+    }): Promise<void>;
+    addNameVariant(input: {
+        propertyCode: string;
+        text: string;
+    }): Promise<void>;
+    removeNameVariant(input: {
+        propertyCode: string;
+        variantId: string;
+    }): Promise<void>;
+    /** Classify an addNameVariant rejection so the page can word it; null means a generic failure. */
+    nameVariantRejectionReason(error: unknown): NameVariantRejectionReason | null;
+    invoiceStatusTone: Record<string, StatusTone>;
+    openPropertyList(): void;
+    openProperty(code: string): void;
+    /** Open the property list with its create dialog pre-filled with this code. */
+    openPropertyCreate(code: string): void;
+    openInvoice(invoiceId: string): void;
+}

package/dist/adapters/properties.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/supplier-detail.d.ts

@@ -0,0 +1,64 @@
+export interface SupplierRecord {
+    id: string;
+    name: string;
+    vat_id: string | null;
+    iban: string | null;
+    bic: string | null;
+    bank_name: string | null;
+    address: string | null;
+    phone: string | null;
+    email: string | null;
+    contact_person: string | null;
+    deleted_at: string | null;
+    delete_reason: string | null;
+    created_at: string;
+}
+export interface SupplierBankAccountRecord {
+    id: string;
+    iban: string;
+    bic: string | null;
+    bank_name: string | null;
+    is_active: boolean;
+    is_default: boolean;
+    confirmed_at?: string | null;
+}
+export interface SupplierInvoiceRow {
+    id: string;
+    invoiceNumber: string | null;
+    documentDate: string | null;
+    amountGross: number | null;
+    status: string | null;
+    paidAt: string | null;
+}
+export interface NewSupplierBankAccount {
+    iban: string;
+    bic: string;
+    bankName: string;
+}
+export interface SupplierDetailAdapter {
+    useSupplier(id: string): {
+        data: SupplierRecord | undefined;
+        loading: boolean;
+        error: unknown;
+        refetch: () => void;
+    };
+    useInvoices(supplierId: string): {
+        data: SupplierInvoiceRow[];
+        loading: boolean;
+    };
+    canEdit: boolean;
+    updateSupplier(id: string, changes: Record<string, unknown>): Promise<void>;
+    softDelete(id: string, reason: string): Promise<void>;
+    restore(id: string): Promise<void>;
+    openInvoice: (invoiceId: string) => void;
+    openSupplierList: () => void;
+    bankAccounts?: {
+        useAccounts(supplierId: string): {
+            data: SupplierBankAccountRecord[];
+            loading: boolean;
+        };
+        addAccount(supplierId: string, account: NewSupplierBankAccount): Promise<void>;
+        deleteAccount(accountId: string): Promise<void>;
+        setDefault(supplierId: string, accountId: string): Promise<void>;
+    };
+}

package/dist/adapters/supplier-detail.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/supplier-list.d.ts

@@ -0,0 +1,21 @@
+import type { SupplierRecord } from "./supplier-detail";
+export interface SupplierListRow extends SupplierRecord {
+    bookedTotal: number;
+    invoiceCount: number;
+    hasUnconfirmedAccount: boolean;
+}
+export interface NewSupplierInput {
+    name: string;
+}
+export interface SupplierListAdapter {
+    useSuppliers(includeDeleted: boolean): {
+        data: SupplierListRow[];
+        loading: boolean;
+        error: unknown;
+    };
+    canCreate: boolean;
+    createSupplier(input: NewSupplierInput): Promise<{
+        id: string;
+    }>;
+    openSupplier: (supplierId: string) => void;
+}

package/dist/adapters/supplier-list.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/team.d.ts

@@ -0,0 +1,79 @@
+import type { QueryResult } from "../lib/query-result";
+import type { AccessPermission } from "../components/access/types";
+export interface TeamEmployee {
+    id: string;
+    name: string | null;
+    email: string;
+    roleName: string;
+    permissions: string[];
+    allowedCompanyIds: string[];
+    isActive: boolean;
+    mustChangePassword: boolean;
+}
+export interface TeamCompany {
+    id: string;
+    code: string;
+    name: string;
+}
+export interface TeamRole {
+    id: string;
+    name: string;
+}
+export interface CreatedAccount {
+    employeeId: string;
+    email: string;
+    tempPassword: string;
+}
+export interface TeamAdapter {
+    useEmployees(): QueryResult<TeamEmployee[]>;
+    useCompanies(): QueryResult<TeamCompany[]>;
+    usePermissionCatalogue(): QueryResult<AccessPermission[]>;
+    useRoles(): QueryResult<TeamRole[]>;
+    useRolePermissions(): QueryResult<Record<string, string[]>>;
+    createEmployee(input: {
+        email: string;
+        name: string;
+        roleName: string;
+        companyIds: string[];
+    }): Promise<CreatedAccount>;
+    updateEmployeeProfile(input: {
+        employeeId: string;
+        name: string;
+        email: string;
+    }): Promise<void>;
+    updateEmployeeRole(input: {
+        employeeId: string;
+        roleName: string;
+    }): Promise<void>;
+    setCompanyAccess(input: {
+        employeeId: string;
+        companyIds: string[];
+    }): Promise<void>;
+    setEmployeeRight(input: {
+        employeeId: string;
+        right: string;
+        value: boolean;
+    }): Promise<void>;
+    setRolePermission(input: {
+        roleId: string;
+        roleName: string;
+        key: string;
+        value: boolean;
+    }): Promise<void>;
+    setEmployeeActive(input: {
+        employeeId: string;
+        isActive: boolean;
+    }): Promise<void>;
+    resetPassword(input: {
+        employeeId: string;
+    }): Promise<{
+        email: string;
+        tempPassword: string;
+    }>;
+    /** Email of the signed-in admin, so the page can stop self-demotion and self-deactivation. */
+    currentUserEmail: string | null;
+    /** Roles an admin may assign. The owner role stays out of this list. */
+    assignableRoles: string[];
+    /** Placeholder domain for the new-employee email field, e.g. "example.com". */
+    emailDomain: string;
+}

package/dist/adapters/team.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/trash.d.ts

@@ -0,0 +1,26 @@
+import type { QueryResult } from "../lib/query-result";
+export interface TrashedRecord {
+    tableName: string;
+    id: string;
+    label: string;
+    deletedAt: string;
+    deletedBy: string | null;
+    deleteReason: string | null;
+}
+export interface TrashTableNames {
+    eligible: string[];
+    purgeable: string[];
+}
+export interface TrashAdapter {
+    useTrashedRecords(tableFilter: string | undefined): QueryResult<TrashedRecord[]>;
+    useTrashTableNames(): QueryResult<TrashTableNames>;
+    restoreRecord(input: {
+        tableName: string;
+        id: string;
+        reason: string | null;
+    }): Promise<void>;
+    purgeRecord(input: {
+        tableName: string;
+        id: string;
+    }): Promise<void>;
+}

package/dist/adapters/trash.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/vat-rules.d.ts

@@ -0,0 +1,83 @@
+import type { QueryResult } from "../lib/query-result";
+export interface VatRule {
+    id: string;
+    vatRate: number | null;
+    vatTreatment: string | null;
+    vatDeductiblePercent: number | null;
+    vatSpecialCase: string | null;
+    supplierId: string | null;
+    propertyId: string | null;
+    companyId: string | null;
+    referencePattern: string | null;
+    note: string | null;
+    isActive: boolean;
+}
+export interface VatRuleDraft {
+    vatRate: number;
+    vatTreatment: string | null;
+    vatDeductiblePercent: number | null;
+    vatSpecialCase: string | null;
+    supplierId: string | null;
+    propertyId: string | null;
+    companyId: string | null;
+    referencePattern: string | null;
+}
+export interface VatRuleInput extends VatRuleDraft {
+    note: string | null;
+}
+export interface VatRuleCompany {
+    id: string;
+    code: string;
+    name: string;
+}
+export interface VatRuleSupplier {
+    id: string;
+    name: string;
+}
+export interface VatRuleProperty {
+    id: string;
+    code: string;
+    name: string | null;
+}
+export interface RuleImpact {
+    wouldChange: number;
+    matches: number;
+}
+export interface BulkApplyResult {
+    changed: number;
+    matches: number;
+    skipped: number;
+}
+export interface VatReserveSummary {
+    companyId: string;
+    inputVatTotal: number;
+    inputVatDeductible: number;
+    inputVatNondeductible: number;
+    outputVat: number;
+    reserve: number;
+    unresolvedCount: number;
+    unresolvedAmount: number;
+}
+export interface VatRulesAdapter {
+    useVatRules(): QueryResult<VatRule[]>;
+    useCompanies(): QueryResult<VatRuleCompany[]>;
+    useSuppliers(): QueryResult<VatRuleSupplier[]>;
+    useProperties(): QueryResult<VatRuleProperty[]>;
+    useRuleImpact(ruleId: string): QueryResult<RuleImpact>;
+    useDraftImpact(draft: VatRuleDraft | null): QueryResult<RuleImpact>;
+    useVatReserve(companyId: string | null): QueryResult<VatReserveSummary>;
+    useVatReserveForCompanies(companyIds: string[]): QueryResult<VatReserveSummary[]>;
+    createVatRule(input: VatRuleInput): Promise<void>;
+    setVatRuleActive(input: {
+        id: string;
+        isActive: boolean;
+    }): Promise<void>;
+    applyVatRuleToExisting(ruleId: string): Promise<BulkApplyResult>;
+    deleteVatRule(input: {
+        id: string;
+        reason: string;
+    }): Promise<void>;
+    isDuplicateRuleError(error: unknown): boolean;
+    vatTreatmentValues: string[];
+    vatSpecialCaseValues: string[];
+}

package/dist/adapters/vat-rules.js

@@ -0,0 +1 @@
+export {};

package/dist/components/access/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export { PermissionChecklist } from "./permission-checklist";
+export { PermissionMatrix } from "./permission-matrix";

package/dist/components/access/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export { PermissionChecklist } from "./permission-checklist.js";
+export { PermissionMatrix } from "./permission-matrix.js";

package/dist/components/access/permission-checklist.d.ts

@@ -0,0 +1,13 @@
+import type { AccessPermission, AccessToggle } from "./types";
+export declare function PermissionChecklist({ permissions, held, onToggle, disabled, readOnlyNote, categoryLabel, className, }: {
+    permissions: AccessPermission[];
+    /** Keys currently in force for this subject. */
+    held: string[];
+    onToggle: AccessToggle;
+    /** Locks every box — used for a subject whose access is not editable (e.g. an owner account). */
+    disabled?: boolean;
+    /** Shown instead of nothing when `disabled`, so a locked list explains itself. */
+    readOnlyNote?: string;
+    categoryLabel?: (category: string) => string;
+    className?: string;
+}): import("react").JSX.Element | null;

package/dist/components/access/permission-checklist.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Checkbox } from "../../ui/checkbox.js";
+import { cn } from "../../lib/class-names.js";
+export function PermissionChecklist({ permissions, held, onToggle, disabled = false, readOnlyNote, categoryLabel = (c) => c, className, }) {
+    const gruppen = useMemo(() => {
+        const nach = new Map();
+        for (const p of permissions) {
+            if (!nach.has(p.category))
+                nach.set(p.category, []);
+            nach.get(p.category).push(p);
+        }
+        return [...nach.entries()];
+    }, [permissions]);
+    const gehalten = useMemo(() => new Set(held), [held]);
+    if (gruppen.length === 0)
+        return null;
+    return (_jsxs("div", { className: cn("space-y-3", className), children: [disabled && readOnlyNote && _jsx("p", { className: "text-sm text-muted-foreground", children: readOnlyNote }), gruppen.map(([kategorie, eintraege]) => (_jsxs("div", { children: [_jsx("div", { className: "text-sm font-semibold text-foreground", children: categoryLabel(kategorie) }), _jsx("div", { className: "mt-1.5 grid gap-x-3 gap-y-0.5 sm:grid-cols-2", children: eintraege.map((p) => (_jsxs("label", { title: p.description ?? undefined, className: cn("flex items-center gap-2.5 rounded-md px-2 py-1.5 text-sm", disabled ? "cursor-not-allowed opacity-60" : "cursor-pointer hover:bg-muted/50"), children: [_jsx(Checkbox, { checked: gehalten.has(p.key), disabled: disabled, onCheckedChange: (checked) => onToggle(p.key, checked === true), "aria-label": p.label }), _jsx("span", { className: "min-w-0 text-sm font-medium leading-snug text-foreground", children: p.label })] }, p.key))) })] }, kategorie)))] }));
+}

package/dist/components/access/permission-matrix.d.ts

@@ -0,0 +1,12 @@
+import type { AccessPermission, AccessRole } from "./types";
+export declare function PermissionMatrix({ permissions, roles, grantedByRole, onToggle, disabled, permissionColumnLabel, categoryLabel, className, }: {
+    permissions: AccessPermission[];
+    roles: AccessRole[];
+    /** role id → permission keys that role grants. */
+    grantedByRole: Record<string, string[]>;
+    onToggle: (roleId: string, key: string, next: boolean) => void;
+    disabled?: boolean;
+    permissionColumnLabel: string;
+    categoryLabel?: (category: string) => string;
+    className?: string;
+}): import("react").JSX.Element | null;

package/dist/components/access/permission-matrix.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Checkbox } from "../../ui/checkbox.js";
+import { cn } from "../../lib/class-names.js";
+export function PermissionMatrix({ permissions, roles, grantedByRole, onToggle, disabled = false, permissionColumnLabel, categoryLabel = (c) => c, className, }) {
+    const gruppen = useMemo(() => {
+        const nach = new Map();
+        for (const p of permissions) {
+            if (!nach.has(p.category))
+                nach.set(p.category, []);
+            nach.get(p.category).push(p);
+        }
+        return [...nach.entries()];
+    }, [permissions]);
+    if (gruppen.length === 0 || roles.length === 0)
+        return null;
+    return (_jsx("div", { className: cn("max-w-4xl space-y-5", className), children: gruppen.map(([kategorie, eintraege], gruppenIndex) => (_jsx("section", { className: "overflow-hidden rounded-xl border border-border bg-card", children: _jsx("div", { className: "overflow-x-auto", children: _jsxs("div", { className: "min-w-[38rem]", children: [_jsxs("header", { className: "flex items-end gap-4 border-b border-border bg-muted/40 px-4 py-3", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "text-base font-semibold text-foreground", children: categoryLabel(kategorie) }), gruppenIndex === 0 && (_jsx("div", { className: "text-sm text-muted-foreground", children: permissionColumnLabel }))] }), roles.map((r) => (_jsx("div", { className: "w-28 shrink-0 text-center text-sm font-medium text-foreground", children: r.label }, r.id)))] }), _jsx("div", { className: "divide-y divide-border", children: eintraege.map((p) => (_jsxs("div", { className: "flex items-center gap-4 px-4 py-3 transition-colors hover:bg-muted/40", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "text-base font-medium leading-snug text-foreground", children: p.label }), p.description && (_jsx("div", { className: "mt-1 text-sm leading-snug text-muted-foreground", children: p.description }))] }), roles.map((r) => (_jsx("div", { className: "flex w-28 shrink-0 justify-center", children: _jsx(Checkbox, { checked: (grantedByRole[r.id] ?? []).includes(p.key), disabled: disabled, onCheckedChange: (checked) => onToggle(r.id, p.key, checked === true), "aria-label": `${r.label}: ${p.label}` }) }, r.id)))] }, p.key))) })] }) }) }, kategorie))) }));
+}

package/dist/components/access/types.d.ts

@@ -0,0 +1,15 @@
+/** One grantable thing, as the catalogue describes it. */
+export interface AccessPermission {
+    key: string;
+    /** Groups rows under a heading. Free text — the host maps it to a label. */
+    category: string;
+    label: string;
+    description?: string | null;
+}
+/** A role, as a column in the matrix. */
+export interface AccessRole {
+    id: string;
+    label: string;
+}
+/** Called when a box is ticked or cleared. Rejections should surface as a toast by the host. */
+export type AccessToggle = (key: string, next: boolean) => void;

package/dist/components/access/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/dashboard/date-range-calendar.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from "react";
+export type IsoDay = string;
+export interface DateRangeCalendarLabels {
+    reset: string;
+    apply: string;
+    previousMonth: string;
+    nextMonth: string;
+    pickSecond: string;
+}
+export declare const englishDateRangeCalendarLabels: DateRangeCalendarLabels;
+export declare function DateRangeCalendar({ from, to, onApply, labels, locale, open, footerExtra, }: {
+    from: IsoDay;
+    to: IsoDay;
+    onApply: (from: IsoDay, to: IsoDay) => void;
+    labels: DateRangeCalendarLabels;
+    locale: string;
+    open: boolean;
+    footerExtra?: ReactNode;
+}): import("react").JSX.Element;

package/dist/components/dashboard/date-range-calendar.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import { Button } from "../../ui/button.js";
+import { cn } from "../../lib/class-names.js";
+export const englishDateRangeCalendarLabels = {
+    reset: "Reset",
+    apply: "Apply",
+    previousMonth: "Previous month",
+    nextMonth: "Next month",
+    pickSecond: "Pick the second date",
+};
+export function DateRangeCalendar({ from, to, onApply, labels, locale, open, footerExtra, }) {
+    const [draftFrom, setDraftFrom] = useState(null);
+    const [draftTo, setDraftTo] = useState(null);
+    const [month, setMonth] = useState(() => startOfMonth(parseDay(from) ?? new Date()));
+    useEffect(() => {
+        if (!open)
+            return;
+        setDraftFrom(null);
+        setDraftTo(null);
+        setMonth(startOfMonth(parseDay(from) ?? parseDay(to) ?? new Date()));
+    }, [open, from, to]);
+    const appliedFrom = parseDay(from);
+    const appliedTo = parseDay(to);
+    const shownFrom = draftFrom ?? (draftTo ? null : appliedFrom);
+    const shownTo = draftTo ?? (draftFrom ? null : appliedTo);
+    const halfPicked = !!draftFrom !== !!draftTo;
+    const days = useMemo(() => monthGrid(month), [month]);
+    const weekdayNames = useMemo(() => weekdays(locale), [locale]);
+    const monthName = useMemo(() => new Intl.DateTimeFormat(locale, { month: "long", year: "numeric" }).format(month), [month, locale]);
+    function pick(day) {
+        if (!draftFrom || draftTo) {
+            setDraftFrom(day);
+            setDraftTo(null);
+            return;
+        }
+        if (day < draftFrom) {
+            setDraftTo(draftFrom);
+            setDraftFrom(day);
+        }
+        else {
+            setDraftTo(day);
+        }
+    }
+    const canApply = !!draftFrom && !!draftTo;
+    return (_jsxs("div", { children: [_jsxs("div", { className: "mb-2 flex items-center justify-between gap-2", children: [_jsx(Button, { type: "button", variant: "ghost", size: "icon", className: "size-7", "aria-label": labels.previousMonth, onClick: () => setMonth(shiftMonth(month, -1)), children: _jsx(ChevronLeft, { className: "size-4" }) }), _jsx("span", { className: "text-sm font-medium text-foreground", children: monthName }), _jsx(Button, { type: "button", variant: "ghost", size: "icon", className: "size-7", "aria-label": labels.nextMonth, onClick: () => setMonth(shiftMonth(month, 1)), children: _jsx(ChevronRight, { className: "size-4" }) })] }), _jsxs("div", { className: "grid grid-cols-7 gap-0.5", children: [weekdayNames.map((name) => (_jsx("div", { className: "flex h-7 items-center justify-center text-xs font-medium text-muted-foreground", children: name }, name))), days.map((day) => {
+                        const inMonth = day.getMonth() === month.getMonth();
+                        const isStart = isSameDay(day, shownFrom);
+                        const isEnd = isSameDay(day, shownTo);
+                        const isBetween = !!shownFrom && !!shownTo && day > shownFrom && day < shownTo;
+                        const isEdge = isStart || isEnd;
+                        return (_jsx("button", { type: "button", onClick: () => pick(day), className: cn("flex h-8 w-8 cursor-pointer items-center justify-center rounded-md text-sm transition-colors", !inMonth && "text-muted-foreground/40", inMonth && !isEdge && !isBetween && "hover:bg-accent", isBetween && "bg-accent text-accent-foreground", isEdge && "bg-primary font-medium text-primary-foreground", isToday(day) && !isEdge && "ring-1 ring-inset ring-border"), "aria-pressed": isEdge || isBetween, children: day.getDate() }, day.toISOString()));
+                    })] }), _jsx("p", { className: "mt-2 min-h-[1.25rem] text-xs text-muted-foreground", children: halfPicked ? labels.pickSecond : null }), _jsxs("div", { className: "mt-1 flex items-center justify-between gap-2", children: [_jsx("div", { children: footerExtra }), _jsxs("div", { className: "flex gap-2", children: [_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => onApply("", ""), children: labels.reset }), _jsx(Button, { type: "button", size: "sm", disabled: !canApply, onClick: () => {
+                                    if (!draftFrom || !draftTo)
+                                        return;
+                                    onApply(isoDay(draftFrom), isoDay(draftTo));
+                                }, children: labels.apply })] })] })] }));
+}
+function parseDay(value) {
+    if (!value)
+        return null;
+    const [year, month, day] = value.split("-").map(Number);
+    if (!year || !month || !day)
+        return null;
+    const date = new Date(year, month - 1, day, 12);
+    return Number.isNaN(date.getTime()) ? null : date;
+}
+function isoDay(date) {
+    const month = `${date.getMonth() + 1}`.padStart(2, "0");
+    const day = `${date.getDate()}`.padStart(2, "0");
+    return `${date.getFullYear()}-${month}-${day}`;
+}
+function startOfMonth(date) {
+    return new Date(date.getFullYear(), date.getMonth(), 1, 12);
+}
+function shiftMonth(date, months) {
+    return new Date(date.getFullYear(), date.getMonth() + months, 1, 12);
+}
+function isSameDay(left, right) {
+    return (!!right &&
+        left.getFullYear() === right.getFullYear() &&
+        left.getMonth() === right.getMonth() &&
+        left.getDate() === right.getDate());
+}
+function isToday(date) {
+    return isSameDay(date, new Date());
+}
+function monthGrid(month) {
+    const firstWeekday = (new Date(month.getFullYear(), month.getMonth(), 1, 12).getDay() + 6) % 7;
+    const start = new Date(month.getFullYear(), month.getMonth(), 1 - firstWeekday, 12);
+    return Array.from({ length: 42 }, (_, index) => new Date(start.getFullYear(), start.getMonth(), start.getDate() + index, 12));
+}
+function weekdays(locale) {
+    const format = new Intl.DateTimeFormat(locale, { weekday: "short" });
+    return Array.from({ length: 7 }, (_, index) => format.format(new Date(2024, 0, 1 + index, 12)));
+}

package/dist/components/dashboard/index.d.ts

@@ -0,0 +1,23 @@
+export { DashboardPanel } from "./panel";
+export { KpiCard } from "./kpi-card";
+export { StatTile, StatRow } from "./stat-tile";
+export { StageTiles } from "./stage-tiles";
+export type { StageTile } from "./stage-tiles";
+export { RankedBars, RankedBarsSkeleton } from "./ranked-bars";
+export type { RankedBarRow } from "./ranked-bars";
+export { OVERVIEW_PERIODS, OVERVIEW_PERIOD_DEFAULT, isOverviewPeriod, overviewPeriodRange, previousPeriodRange, } from "./periods";
+export type { OverviewPeriod, PeriodRange } from "./periods";
+export { PeriodPicker, useStoredPeriod, readStoredPeriod, writeStoredPeriod, englishPeriodLabels, } from "./period-picker";
+export type { PeriodValue, PeriodLabels } from "./period-picker";
+export { MoneyTrendChart } from "./money-trend-chart";
+export type { MoneyTrendPoint } from "./money-trend-chart";
+export { StatRowsPanel } from "./stat-rows-panel";
+export type { StatRowConfig } from "./stat-rows-panel";
+export { MoneyCardsRow } from "./money-cards-row";
+export type { MoneyFigure, MoneyCardSpec } from "./money-cards-row";
+export { PipelineStagesPanel } from "./pipeline-stages-panel";
+export { RankedListPanel } from "./ranked-list-panel";
+export { ProcessingSummaryPanel } from "./processing-summary-panel";
+export type { ProcessingSummary } from "./processing-summary-panel";
+export { DateRangeCalendar, englishDateRangeCalendarLabels } from "./date-range-calendar";
+export type { DateRangeCalendarLabels, IsoDay } from "./date-range-calendar";

package/dist/components/dashboard/index.js

@@ -0,0 +1,14 @@
+export { DashboardPanel } from "./panel.js";
+export { KpiCard } from "./kpi-card.js";
+export { StatTile, StatRow } from "./stat-tile.js";
+export { StageTiles } from "./stage-tiles.js";
+export { RankedBars, RankedBarsSkeleton } from "./ranked-bars.js";
+export { OVERVIEW_PERIODS, OVERVIEW_PERIOD_DEFAULT, isOverviewPeriod, overviewPeriodRange, previousPeriodRange, } from "./periods.js";
+export { PeriodPicker, useStoredPeriod, readStoredPeriod, writeStoredPeriod, englishPeriodLabels, } from "./period-picker.js";
+export { MoneyTrendChart } from "./money-trend-chart.js";
+export { StatRowsPanel } from "./stat-rows-panel.js";
+export { MoneyCardsRow } from "./money-cards-row.js";
+export { PipelineStagesPanel } from "./pipeline-stages-panel.js";
+export { RankedListPanel } from "./ranked-list-panel.js";
+export { ProcessingSummaryPanel } from "./processing-summary-panel.js";
+export { DateRangeCalendar, englishDateRangeCalendarLabels } from "./date-range-calendar.js";

package/dist/components/dashboard/kpi-card.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
+export declare function KpiCard({ icon: Icon, iconTint, label, to, loading, value, delta, headerRight, className, }: {
+    icon: LucideIcon;
+    iconTint: string;
+    label: string;
+    to: string;
+    loading: boolean;
+    value: ReactNode;
+    delta?: ReactNode;
+    headerRight?: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;