@powerhousedao/contributor-billing 0.1.37 → 0.1.40

package/dist/editors/contributor-billing/components/MonthlyReporting.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { FileText, Camera, Calendar } from "lucide-react";
+import { useMemo } from "react";
+import { useDocumentsInSelectedDrive, setSelectedNode, } from "@powerhousedao/reactor-browser";
+import { useBillingFolderStructure, formatMonthName, } from "../hooks/useBillingFolderStructure.js";
+/**
+ * Get color classes for report status badge
+ */
+function getStatusColors(status) {
+    const statusLower = status?.toLowerCase() || "draft";
+    switch (statusLower) {
+        case "final":
+        case "approved":
+        case "completed":
+            return { bg: "bg-green-100", text: "text-green-700" };
+        case "submitted":
+        case "review":
+        case "in_review":
+            return { bg: "bg-blue-100", text: "text-blue-700" };
+        case "rejected":
+        case "cancelled":
+            return { bg: "bg-red-100", text: "text-red-700" };
+        case "draft":
+        default:
+            return { bg: "bg-amber-100", text: "text-amber-700" };
+    }
+}
+/**
+ * Reusable Monthly Reporting component
+ * Shows expense and snapshot report status for each month
+ */
+export function MonthlyReporting({ onFolderSelect, showAllMonths = false, }) {
+    const documentsInDrive = useDocumentsInSelectedDrive();
+    const { monthFolders } = useBillingFolderStructure();
+    // Get current and prior month names
+    const { currentMonth, priorMonth } = useMemo(() => {
+        const now = new Date();
+        const current = formatMonthName(now);
+        const prior = formatMonthName(new Date(now.getFullYear(), now.getMonth() - 1, 1));
+        return { currentMonth: current, priorMonth: prior };
+    }, []);
+    // Get report info for a specific month
+    const getReportInfo = (month, type) => {
+        const emptyColors = { bg: "bg-gray-100", text: "text-gray-500" };
+        const emptyReport = {
+            exists: false,
+            status: null,
+            colors: emptyColors,
+        };
+        if (!documentsInDrive)
+            return emptyReport;
+        const doc = documentsInDrive.find((d) => d.header.documentType === type &&
+            d.header.name?.toLowerCase().includes(month.toLowerCase()));
+        if (!doc)
+            return emptyReport;
+        const status = doc.state?.global?.status ||
+            "Draft";
+        return { exists: true, status, colors: getStatusColors(status) };
+    };
+    // Get months to display
+    const monthsToDisplay = useMemo(() => {
+        if (showAllMonths) {
+            // Show all months sorted by date (most recent first)
+            return Array.from(monthFolders.keys()).sort((a, b) => {
+                const dateA = new Date(a);
+                const dateB = new Date(b);
+                return dateB.getTime() - dateA.getTime();
+            });
+        }
+        // Just show current and prior month
+        return [currentMonth, priorMonth];
+    }, [showAllMonths, monthFolders, currentMonth, priorMonth]);
+    const handleOpenMonth = (monthName) => {
+        const monthInfo = monthFolders.get(monthName);
+        if (monthInfo?.reportingFolder) {
+            setSelectedNode(monthInfo.reportingFolder.id);
+            onFolderSelect?.({
+                folderId: monthInfo.reportingFolder.id,
+                folderType: "reporting",
+                monthName,
+            });
+        }
+    };
+    return (_jsxs("div", { className: "bg-white rounded-xl border border-gray-200 p-6", children: [_jsxs("div", { className: "flex items-center gap-3 mb-5", children: [_jsx("div", { className: "p-2 bg-purple-100 rounded-lg", children: _jsx(Calendar, { className: "w-5 h-5 text-purple-600" }) }), _jsxs("div", { children: [_jsx("h2", { className: "text-lg font-semibold text-gray-900", children: "Monthly Reporting" }), _jsx("p", { className: "text-sm text-gray-600", children: "Track expense and snapshot reports for each period" })] })] }), _jsx("div", { className: "space-y-4", children: monthsToDisplay.map((monthName) => {
+                    const expenseReport = getReportInfo(monthName, "powerhouse/expense-report");
+                    const snapshotReport = getReportInfo(monthName, "powerhouse/snapshot-report");
+                    const monthExists = monthFolders.has(monthName);
+                    return (_jsxs("div", { className: "border border-gray-100 rounded-lg p-4", children: [_jsxs("div", { className: "flex items-center justify-between mb-3", children: [_jsx("h3", { className: "font-medium text-gray-900", children: monthName }), monthExists ? (_jsx("button", { onClick: () => handleOpenMonth(monthName), className: "text-sm text-blue-600 hover:text-blue-700 font-medium", children: "Open Reporting" })) : (_jsx("span", { className: "text-xs text-gray-400", children: "Month not created" }))] }), _jsxs("div", { className: "grid grid-cols-2 gap-3", children: [_jsxs("div", { className: `flex items-center gap-2 p-2 rounded ${expenseReport.exists ? "bg-blue-50" : "bg-gray-50"}`, children: [_jsx(FileText, { className: `w-4 h-4 ${expenseReport.exists ? "text-blue-600" : "text-gray-400"}` }), _jsx("span", { className: `text-sm ${expenseReport.exists ? "text-blue-700" : "text-gray-500"}`, children: "Expense Report" }), expenseReport.exists && (_jsx("span", { className: `text-xs font-medium px-1.5 py-0.5 rounded ml-auto ${expenseReport.colors.bg} ${expenseReport.colors.text}`, children: expenseReport.status }))] }), _jsxs("div", { className: `flex items-center gap-2 p-2 rounded ${snapshotReport.exists ? "bg-purple-50" : "bg-gray-50"}`, children: [_jsx(Camera, { className: `w-4 h-4 ${snapshotReport.exists ? "text-purple-600" : "text-gray-400"}` }), _jsx("span", { className: `text-sm ${snapshotReport.exists ? "text-purple-700" : "text-gray-500"}`, children: "Snapshot Report" }), snapshotReport.exists && (_jsx("span", { className: `text-xs font-medium px-1.5 py-0.5 rounded ml-auto ${snapshotReport.colors.bg} ${snapshotReport.colors.text}`, children: snapshotReport.status }))] })] }), !expenseReport.exists && !snapshotReport.exists && (_jsx("div", { className: "mt-3 pt-3 border-t border-gray-100", children: _jsxs("span", { className: "text-xs font-medium text-amber-600 bg-amber-50 px-2 py-1 rounded", children: ["Reports pending for ", monthName] }) }))] }, monthName));
+                }) })] }));
+}

package/dist/editors/contributor-billing/components/ReportingView.d.ts

@@ -0,0 +1,10 @@
+interface ReportingViewProps {
+    folderId: string;
+    monthName?: string;
+}
+/**
+ * View for the Reporting folder showing Expense Reports and Snapshot Reports
+ */
+export declare function ReportingView({ folderId, monthName }: ReportingViewProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ReportingView.d.ts.map

package/dist/editors/contributor-billing/components/ReportingView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportingView.d.ts","sourceRoot":"","sources":["../../../../editors/contributor-billing/components/ReportingView.tsx"],"names":[],"mappings":"AAcA,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,kBAAkB,2CA0PxE"}

package/dist/editors/contributor-billing/components/ReportingView.js

@@ -0,0 +1,112 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useDocumentsInSelectedDrive, setSelectedNode, addDocument, dispatchActions, useSelectedDrive, } from "@powerhousedao/reactor-browser";
+import { useMemo, useState } from "react";
+import { FileText, Camera, Plus } from "lucide-react";
+import { setName } from "document-model";
+import { moveNode } from "document-drive";
+import { actions as expenseReportActions } from "../../../document-models/expense-report/index.js";
+import { actions as snapshotReportActions } from "../../../document-models/snapshot-report/index.js";
+/**
+ * Parse a month name like "January 2026" into start and end dates
+ */
+function parseMonthDates(monthName) {
+    const date = new Date(monthName + " 1"); // e.g., "January 2026 1"
+    if (isNaN(date.getTime()))
+        return null;
+    const start = new Date(date.getFullYear(), date.getMonth(), 1);
+    const end = new Date(date.getFullYear(), date.getMonth() + 1, 0); // Last day of month
+    return { start, end };
+}
+/**
+ * View for the Reporting folder showing Expense Reports and Snapshot Reports
+ */
+export function ReportingView({ folderId, monthName }) {
+    const documentsInDrive = useDocumentsInSelectedDrive();
+    const [selectedDrive] = useSelectedDrive();
+    const [isCreating, setIsCreating] = useState(false);
+    // Find expense reports and snapshot reports that match this month
+    const { expenseReports, snapshotReports } = useMemo(() => {
+        if (!documentsInDrive || !monthName) {
+            return { expenseReports: [], snapshotReports: [] };
+        }
+        const monthLower = monthName.toLowerCase();
+        const expense = documentsInDrive.filter((doc) => doc.header.documentType === "powerhouse/expense-report" &&
+            doc.header.name?.toLowerCase().includes(monthLower));
+        const snapshot = documentsInDrive.filter((doc) => doc.header.documentType === "powerhouse/snapshot-report" &&
+            doc.header.name?.toLowerCase().includes(monthLower));
+        return { expenseReports: expense, snapshotReports: snapshot };
+    }, [documentsInDrive, monthName]);
+    const handleOpenDocument = (docId) => {
+        setSelectedNode(docId);
+    };
+    const driveId = selectedDrive?.header.id;
+    const handleCreateExpenseReport = async () => {
+        if (!driveId || !monthName || isCreating)
+            return;
+        setIsCreating(true);
+        try {
+            const reportName = `${monthName} - Expense Report`;
+            const createdNode = await addDocument(driveId, reportName, "powerhouse/expense-report", undefined, undefined, undefined, "powerhouse-expense-report-editor");
+            if (!createdNode?.id)
+                return;
+            // Move to reporting folder
+            if (folderId) {
+                await dispatchActions(moveNode({ srcFolder: createdNode.id, targetParentFolder: folderId }), driveId);
+            }
+            // Set the document name
+            await dispatchActions(setName(reportName), createdNode.id);
+            // Set period dates based on month
+            const dates = parseMonthDates(monthName);
+            if (dates) {
+                await dispatchActions([
+                    expenseReportActions.setPeriodStart({
+                        periodStart: dates.start.toISOString(),
+                    }),
+                    expenseReportActions.setPeriodEnd({
+                        periodEnd: dates.end.toISOString(),
+                    }),
+                ], createdNode.id);
+            }
+            // Open the created report
+            setSelectedNode(createdNode.id);
+        }
+        finally {
+            setIsCreating(false);
+        }
+    };
+    const handleCreateSnapshotReport = async () => {
+        if (!driveId || !monthName || isCreating)
+            return;
+        setIsCreating(true);
+        try {
+            const reportName = `${monthName} - Snapshot Report`;
+            const createdNode = await addDocument(driveId, reportName, "powerhouse/snapshot-report", undefined, undefined, undefined, "powerhouse-snapshot-report-editor");
+            if (!createdNode?.id)
+                return;
+            // Move to reporting folder
+            if (folderId) {
+                await dispatchActions(moveNode({ srcFolder: createdNode.id, targetParentFolder: folderId }), driveId);
+            }
+            // Set the document name
+            await dispatchActions(setName(reportName), createdNode.id);
+            // Set period dates based on month
+            const dates = parseMonthDates(monthName);
+            if (dates) {
+                await dispatchActions([
+                    snapshotReportActions.setPeriodStart({
+                        periodStart: dates.start.toISOString(),
+                    }),
+                    snapshotReportActions.setPeriodEnd({
+                        periodEnd: dates.end.toISOString(),
+                    }),
+                ], createdNode.id);
+            }
+            // Open the created report
+            setSelectedNode(createdNode.id);
+        }
+        finally {
+            setIsCreating(false);
+        }
+    };
+    return (_jsxs("div", { children: [_jsxs("div", { className: "mb-6", children: [_jsxs("h1", { className: "text-2xl font-bold text-gray-900", children: ["Reporting ", monthName ? `- ${monthName}` : ""] }), _jsxs("p", { className: "text-gray-600", children: ["Manage expense reports and snapshot reports", monthName ? ` for ${monthName}` : ""] })] }), _jsxs("div", { className: "grid grid-cols-1 lg:grid-cols-2 gap-6", children: [_jsxs("div", { className: "bg-white rounded-lg border border-gray-200 p-4", children: [_jsxs("div", { className: "flex items-center justify-between mb-4", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(FileText, { className: "w-5 h-5 text-blue-600" }), _jsx("h2", { className: "text-lg font-semibold text-gray-900", children: "Expense Reports" })] }), expenseReports.length === 0 && (_jsxs("button", { onClick: () => void handleCreateExpenseReport(), disabled: isCreating, className: "flex items-center gap-1 px-3 py-1.5 text-sm font-medium text-blue-600 hover:bg-blue-50 rounded-md transition-colors disabled:opacity-50 disabled:cursor-not-allowed", children: [_jsx(Plus, { className: "w-4 h-4" }), isCreating ? "Creating..." : "New"] }))] }), expenseReports.length === 0 ? (_jsx("p", { className: "text-gray-500 text-sm", children: "No expense reports yet" })) : (_jsx("div", { className: "space-y-2", children: expenseReports.map((doc) => (_jsxs("button", { onClick: () => handleOpenDocument(doc.header.id), className: "w-full flex items-center gap-3 p-3 text-left hover:bg-gray-50 rounded-md transition-colors border border-gray-100", children: [_jsx(FileText, { className: "w-4 h-4 text-gray-400" }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("p", { className: "text-sm font-medium text-gray-900 truncate", children: doc.header.name || "Untitled" }), _jsxs("p", { className: "text-xs text-gray-500", children: ["Modified:", " ", new Date(doc.header.lastModifiedAtUtcIso || Date.now()).toLocaleDateString()] })] })] }, doc.header.id))) }))] }), _jsxs("div", { className: "bg-white rounded-lg border border-gray-200 p-4", children: [_jsxs("div", { className: "flex items-center justify-between mb-4", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Camera, { className: "w-5 h-5 text-purple-600" }), _jsx("h2", { className: "text-lg font-semibold text-gray-900", children: "Snapshot Reports" })] }), snapshotReports.length === 0 && (_jsxs("button", { onClick: () => void handleCreateSnapshotReport(), disabled: isCreating, className: "flex items-center gap-1 px-3 py-1.5 text-sm font-medium text-purple-600 hover:bg-purple-50 rounded-md transition-colors disabled:opacity-50 disabled:cursor-not-allowed", children: [_jsx(Plus, { className: "w-4 h-4" }), isCreating ? "Creating..." : "New"] }))] }), snapshotReports.length === 0 ? (_jsx("p", { className: "text-gray-500 text-sm", children: "No snapshot reports yet" })) : (_jsx("div", { className: "space-y-2", children: snapshotReports.map((doc) => (_jsxs("button", { onClick: () => handleOpenDocument(doc.header.id), className: "w-full flex items-center gap-3 p-3 text-left hover:bg-gray-50 rounded-md transition-colors border border-gray-100", children: [_jsx(Camera, { className: "w-4 h-4 text-gray-400" }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("p", { className: "text-sm font-medium text-gray-900 truncate", children: doc.header.name || "Untitled" }), _jsxs("p", { className: "text-xs text-gray-500", children: ["Modified:", " ", new Date(doc.header.lastModifiedAtUtcIso || Date.now()).toLocaleDateString()] })] })] }, doc.header.id))) }))] })] })] }));
+}

package/dist/editors/contributor-billing/config.js

@@ -1,6 +1,6 @@
 /** Editor config for the ContributorBilling */
 export const editorConfig = {
-    isDragAndDropEnabled: true,
+    isDragAndDropEnabled: false,
     allowedDocumentTypes: [
         "powerhouse/invoice",
         "powerhouse/billing-statement",

package/dist/editors/contributor-billing/hooks/useBillingFolderStructure.d.ts

@@ -0,0 +1,54 @@
+import type { FolderNode } from "document-drive";
+export interface MonthFolderInfo {
+    folder: FolderNode;
+    paymentsFolder: FolderNode | null;
+    reportingFolder: FolderNode | null;
+}
+export interface UseBillingFolderStructureResult {
+    /** The Billing root folder node, or null if it doesn't exist yet */
+    billingFolder: FolderNode | null;
+    /** Map of month name to folder info (e.g., "January 2025" -> folder info) */
+    monthFolders: Map<string, MonthFolderInfo>;
+    /** The current month's folder info, or null if not created yet */
+    currentMonthFolder: MonthFolderInfo | null;
+    /** Create the Billing folder if it doesn't exist */
+    createBillingFolder: () => Promise<void>;
+    /** Create a new month folder with Payments and Reporting subfolders */
+    createMonthFolder: (monthName: string) => Promise<void>;
+    /** Check if a folder is a Payments folder */
+    isPaymentsFolder: (folderId: string) => boolean;
+    /** Check if a folder is a Reporting folder */
+    isReportingFolder: (folderId: string) => boolean;
+    /** Get all Payments folder IDs */
+    paymentsFolderIds: Set<string>;
+    /** Get all Reporting folder IDs */
+    reportingFolderIds: Set<string>;
+}
+/**
+ * Format a date as "January 2025"
+ */
+export declare function formatMonthName(date: Date): string;
+/**
+ * Get the current month name (e.g., "January 2025")
+ */
+export declare function getCurrentMonthName(): string;
+/**
+ * Hook that manages the Billing folder structure in the Contributor Billing drive.
+ *
+ * Structure:
+ * Billing/
+ * ├── January 2025/
+ * │   ├── Payments/
+ * │   └── Reporting/
+ * ├── February 2025/
+ * │   ├── Payments/
+ * │   └── Reporting/
+ * └── ...
+ *
+ * This hook:
+ * 1. Creates the "Billing" folder if it doesn't exist
+ * 2. Auto-creates the current month folder with Payments/Reporting subfolders
+ * 3. Provides a function to manually create additional month folders
+ */
+export declare function useBillingFolderStructure(): UseBillingFolderStructureResult;
+//# sourceMappingURL=useBillingFolderStructure.d.ts.map

package/dist/editors/contributor-billing/hooks/useBillingFolderStructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingFolderStructure.d.ts","sourceRoot":"","sources":["../../../../editors/contributor-billing/hooks/useBillingFolderStructure.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAQ,MAAM,gBAAgB,CAAC;AAYvD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,+BAA+B;IAC9C,oEAAoE;IACpE,aAAa,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,6EAA6E;IAC7E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,kEAAkE;IAClE,kBAAkB,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,uEAAuE;IACvE,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,6CAA6C;IAC7C,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,8CAA8C;IAC9C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,kCAAkC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,mCAAmC;IACnC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,IAAI,+BAA+B,CAsJ3E"}

package/dist/editors/contributor-billing/hooks/useBillingFolderStructure.js

@@ -0,0 +1,145 @@
+import { useMemo, useCallback } from "react";
+import { isFolderNodeKind, addFolder, useSelectedDrive, } from "@powerhousedao/reactor-browser";
+const BILLING_FOLDER_NAME = "Billing";
+const PAYMENTS_FOLDER_NAME = "Payments";
+const REPORTING_FOLDER_NAME = "Reporting";
+// Module-level tracking to prevent duplicate folder creation across all hook instances
+const globalCreationState = {
+    createdBillingFolderForDrives: new Set(),
+    creatingMonths: new Set(), // Format: "driveId:monthName"
+};
+/**
+ * Format a date as "January 2025"
+ */
+export function formatMonthName(date) {
+    return date.toLocaleDateString("en-US", { month: "long", year: "numeric" });
+}
+/**
+ * Get the current month name (e.g., "January 2025")
+ */
+export function getCurrentMonthName() {
+    return formatMonthName(new Date());
+}
+/**
+ * Hook that manages the Billing folder structure in the Contributor Billing drive.
+ *
+ * Structure:
+ * Billing/
+ * ├── January 2025/
+ * │   ├── Payments/
+ * │   └── Reporting/
+ * ├── February 2025/
+ * │   ├── Payments/
+ * │   └── Reporting/
+ * └── ...
+ *
+ * This hook:
+ * 1. Creates the "Billing" folder if it doesn't exist
+ * 2. Auto-creates the current month folder with Payments/Reporting subfolders
+ * 3. Provides a function to manually create additional month folders
+ */
+export function useBillingFolderStructure() {
+    const [driveDocument] = useSelectedDrive();
+    const driveId = driveDocument?.header.id;
+    // Find the "Billing" root folder
+    const billingFolder = useMemo(() => {
+        if (!driveDocument)
+            return null;
+        const nodes = driveDocument.state.global.nodes;
+        return (nodes.find((node) => isFolderNodeKind(node) && node.name === BILLING_FOLDER_NAME) ?? null);
+    }, [driveDocument]);
+    // Find all month folders under Billing and their subfolders
+    const monthFolders = useMemo(() => {
+        const folders = new Map();
+        if (!driveDocument || !billingFolder)
+            return folders;
+        const allNodes = driveDocument.state.global.nodes;
+        // Find all folders directly under Billing (these are month folders)
+        const monthFolderNodes = allNodes.filter((node) => isFolderNodeKind(node) && node.parentFolder === billingFolder.id);
+        for (const monthFolder of monthFolderNodes) {
+            // Find Payments and Reporting subfolders
+            const paymentsFolder = allNodes.find((node) => isFolderNodeKind(node) &&
+                node.parentFolder === monthFolder.id &&
+                node.name === PAYMENTS_FOLDER_NAME) ?? null;
+            const reportingFolder = allNodes.find((node) => isFolderNodeKind(node) &&
+                node.parentFolder === monthFolder.id &&
+                node.name === REPORTING_FOLDER_NAME) ?? null;
+            folders.set(monthFolder.name, {
+                folder: monthFolder,
+                paymentsFolder,
+                reportingFolder,
+            });
+        }
+        return folders;
+    }, [driveDocument, billingFolder]);
+    // Get current month folder info
+    const currentMonthFolder = useMemo(() => {
+        const currentMonth = getCurrentMonthName();
+        return monthFolders.get(currentMonth) ?? null;
+    }, [monthFolders]);
+    // Build sets of Payments and Reporting folder IDs for quick lookup
+    const { paymentsFolderIds, reportingFolderIds } = useMemo(() => {
+        const paymentsIds = new Set();
+        const reportingIds = new Set();
+        for (const info of monthFolders.values()) {
+            if (info.paymentsFolder) {
+                paymentsIds.add(info.paymentsFolder.id);
+            }
+            if (info.reportingFolder) {
+                reportingIds.add(info.reportingFolder.id);
+            }
+        }
+        return { paymentsFolderIds: paymentsIds, reportingFolderIds: reportingIds };
+    }, [monthFolders]);
+    const isPaymentsFolder = useCallback((folderId) => paymentsFolderIds.has(folderId), [paymentsFolderIds]);
+    const isReportingFolder = useCallback((folderId) => reportingFolderIds.has(folderId), [reportingFolderIds]);
+    // Create a new month folder with Payments and Reporting subfolders
+    const createMonthFolder = useCallback(async (monthName) => {
+        if (!driveId || !billingFolder)
+            return;
+        if (monthFolders.has(monthName))
+            return; // Already exists
+        const creationKey = `${driveId}:${monthName}`;
+        if (globalCreationState.creatingMonths.has(creationKey))
+            return; // Already creating
+        globalCreationState.creatingMonths.add(creationKey);
+        try {
+            // Create month folder
+            const monthFolder = await addFolder(driveId, monthName, billingFolder.id);
+            if (!monthFolder) {
+                console.error(`Failed to create month folder: ${monthName}`);
+                return;
+            }
+            // Create Payments subfolder
+            await addFolder(driveId, PAYMENTS_FOLDER_NAME, monthFolder.id);
+            // Create Reporting subfolder
+            await addFolder(driveId, REPORTING_FOLDER_NAME, monthFolder.id);
+        }
+        catch (error) {
+            console.error(`Error creating month folder structure: ${monthName}`, error);
+        }
+        finally {
+            globalCreationState.creatingMonths.delete(creationKey);
+        }
+    }, [driveId, billingFolder, monthFolders]);
+    // Create the Billing folder if it doesn't exist (called manually)
+    const createBillingFolder = useCallback(async () => {
+        if (!driveId || billingFolder)
+            return;
+        if (globalCreationState.createdBillingFolderForDrives.has(driveId))
+            return;
+        globalCreationState.createdBillingFolderForDrives.add(driveId);
+        await addFolder(driveId, BILLING_FOLDER_NAME);
+    }, [driveId, billingFolder]);
+    return {
+        billingFolder,
+        monthFolders,
+        currentMonthFolder,
+        createBillingFolder,
+        createMonthFolder,
+        isPaymentsFolder,
+        isReportingFolder,
+        paymentsFolderIds,
+        reportingFolderIds,
+    };
+}

package/dist/editors/expense-report/components/AddBillingStatementModal.d.ts

@@ -5,7 +5,9 @@ interface AddBillingStatementModalProps {
     walletAddress: string;
     dispatch: any;
     groups: LineItemGroup[];
+    /** The Payments folder ID to filter billing statements by. If not provided, shows all billing statements in the drive. */
+    paymentsFolderId?: string | null;
 }
-export declare function AddBillingStatementModal({ isOpen, onClose, walletAddress, dispatch, groups, }: AddBillingStatementModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AddBillingStatementModal({ isOpen, onClose, walletAddress, dispatch, groups, paymentsFolderId, }: AddBillingStatementModalProps): import("react/jsx-runtime").JSX.Element | null;
 export {};
 //# sourceMappingURL=AddBillingStatementModal.d.ts.map

package/dist/editors/expense-report/components/AddBillingStatementModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AddBillingStatementModal.d.ts","sourceRoot":"","sources":["../../../../editors/expense-report/components/AddBillingStatementModal.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAI1F,UAAU,6BAA6B;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC;IACd,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AA+BD,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,QAAQ,EACR,MAAM,GACP,EAAE,6BAA6B,kDAwU/B"}
+{"version":3,"file":"AddBillingStatementModal.d.ts","sourceRoot":"","sources":["../../../../editors/expense-report/components/AddBillingStatementModal.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAI1F,UAAU,6BAA6B;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC;IACd,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,0HAA0H;IAC1H,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AA+BD,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,EAAE,6BAA6B,kDA2V/B"}

package/dist/editors/expense-report/components/AddBillingStatementModal.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState, useMemo } from "react";
 import { Button } from "@powerhousedao/document-engineering";
-import { useDocumentsInSelectedDrive } from "@powerhousedao/reactor-browser";
+import { useDocumentsInSelectedDrive, useSelectedDrive, isFileNodeKind, } from "@powerhousedao/reactor-browser";
 import { generateId } from "document-model";
 import { X, FileText, Check } from "lucide-react";
 import { actions } from "../../../document-models/expense-report/index.js";
@@ -33,8 +33,9 @@ const fusionLabelToValue = {
     "Non-current Liability": "liabilities/non-current",
     Equity: "equity/retained",
 };
-export function AddBillingStatementModal({ isOpen, onClose, walletAddress, dispatch, groups, }) {
+export function AddBillingStatementModal({ isOpen, onClose, walletAddress, dispatch, groups, paymentsFolderId, }) {
     const documents = useDocumentsInSelectedDrive();
+    const [driveDocument] = useSelectedDrive();
     const [selectedStatements, setSelectedStatements] = useState(new Set());
     const [searchTerm, setSearchTerm] = useState("");
     // Get already added billing statement IDs for this wallet from documents
@@ -55,18 +56,33 @@ export function AddBillingStatementModal({ isOpen, onClose, walletAddress, dispa
         });
         return ids;
     }, [documents, walletAddress]);
-    // Get billing statement documents from the drive
+    // Get billing statement documents from the drive, filtered by the Payments folder
     const billingStatements = useMemo(() => {
-        if (!documents)
+        if (!documents || !driveDocument)
             return [];
+        // Get all file nodes from the drive
+        const nodes = driveDocument.state.global.nodes;
+        // If we have a payments folder ID, filter billing statements to only those in that folder
+        // Otherwise, show all billing statements (fallback for editors used outside contributor billing)
         return documents
-            .filter((doc) => doc.header.documentType === "powerhouse/billing-statement")
+            .filter((doc) => {
+            if (doc.header.documentType !== "powerhouse/billing-statement") {
+                return false;
+            }
+            // If we have a payments folder, only include billing statements in that folder
+            if (paymentsFolderId) {
+                const fileNode = nodes.find((node) => isFileNodeKind(node) && node.id === doc.header.id);
+                return fileNode?.parentFolder === paymentsFolderId;
+            }
+            // Fallback: include all billing statements if no payments folder context
+            return true;
+        })
             .map((doc) => ({
             id: doc.header.id,
             name: doc.header.name,
             document: doc, // Full document with state
         }));
-    }, [documents]);
+    }, [documents, driveDocument, paymentsFolderId]);
     // Filter billing statements based on search term
     const filteredStatements = useMemo(() => {
         if (!searchTerm.trim())
@@ -144,7 +160,7 @@ export function AddBillingStatementModal({ isOpen, onClose, walletAddress, dispa
                     const group = groups.find((g) => g.id === groupId);
                     categoryAggregation.set(categoryKey, {
                         groupId: groupId,
-                        groupLabel: group?.label || "Uncategorised",
+                        groupLabel: group?.label || "Uncategorized",
                         budget: 0,
                         actuals: billingLineItem.totalPriceCash || 0,
                         forecast: 0,

package/dist/editors/expense-report/components/AggregatedExpensesTable.js

@@ -191,7 +191,7 @@ export function AggregatedExpensesTable({ wallets, groups, periodStart, periodEn
             items.push({
                 lineItemId: item.id || "",
                 groupId: item.group || "uncategorized",
-                groupLabel: item.groupLabel || "Uncategorised",
+                groupLabel: item.groupLabel || "Uncategorized",
                 parentGroupId: item.parentGroupId,
                 parentGroupLabel: item.parentGroupLabel,
                 budget: item.budget || 0,
@@ -341,7 +341,7 @@ export function AggregatedExpensesTable({ wallets, groups, periodStart, periodEn
                                         return null;
                                     const subtotals = calculateSubtotal(items);
                                     const parentLabel = parentKey === "uncategorized"
-                                        ? "Uncategorised"
+                                        ? "Uncategorized"
                                         : items[0]?.parentGroupLabel || "Other";
                                     return (_jsxs(React.Fragment, { children: [_jsx("tr", { className: "bg-gray-100 dark:bg-gray-800", children: _jsx("td", { colSpan: 8, className: "px-6 py-3 text-sm font-bold text-gray-900 dark:text-white", children: parentLabel }) }), items.map((item) => {
                                                 if (!item)

package/dist/editors/expense-report/components/ExpenseReportPDF.js

@@ -220,7 +220,7 @@ export function ExpenseReportPDF({ periodStart, periodEnd, wallets, groups, }) {
         });
         return entries.map(([key, items]) => ({
             parentLabel: key === "uncategorized"
-                ? "Uncategorised"
+                ? "Uncategorized"
                 : items[0]?.parentGroupLabel || "Unknown",
             items,
         }));
@@ -264,7 +264,7 @@ export function ExpenseReportPDF({ periodStart, periodEnd, wallets, groups, }) {
                                                         : styles.differenceNormal;
                                                     return (_jsxs(View, { style: itemIndex % 2 === 0
                                                             ? styles.tableRow
-                                                            : styles.tableRowAlt, children: [_jsx(Text, { style: [styles.cell, styles.categoryCol], children: item.groupLabel || item.label || "Uncategorised" }), _jsx(Text, { style: [styles.cellRight, styles.budgetCol], children: formatNumber(item.budget) }), _jsx(Text, { style: [styles.cellRight, styles.forecastCol], children: formatNumber(item.forecast) }), _jsx(Text, { style: [styles.cellRight, styles.actualsCol], children: formatNumber(item.actuals) }), _jsx(Text, { style: [
+                                                            : styles.tableRowAlt, children: [_jsx(Text, { style: [styles.cell, styles.categoryCol], children: item.groupLabel || item.label || "Uncategorized" }), _jsx(Text, { style: [styles.cellRight, styles.budgetCol], children: formatNumber(item.budget) }), _jsx(Text, { style: [styles.cellRight, styles.forecastCol], children: formatNumber(item.forecast) }), _jsx(Text, { style: [styles.cellRight, styles.actualsCol], children: formatNumber(item.actuals) }), _jsx(Text, { style: [
                                                                     styles.cellRight,
                                                                     styles.differenceCol,
                                                                     differenceStyle,

package/dist/editors/expense-report/editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../../editors/expense-report/editor.tsx"],"names":[],"mappings":"AAmEA,MAAM,CAAC,OAAO,UAAU,MAAM,4CAoV7B"}
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../../editors/expense-report/editor.tsx"],"names":[],"mappings":"AAuEA,MAAM,CAAC,OAAO,UAAU,MAAM,4CAiZ7B"}