@arbidocs/blocks 0.5.11 → 0.5.13

package/dist/connection/projects/index.d.ts

@@ -1 +1,2 @@
 export { ConnectedProjectsPanel, PROJECTS_BASE_TAB_ID, type ConnectedProjectsPanelProps, type ProjectPanelTabs, } from './ConnectedProjectsPanel';
+export { buildProjectSummaries, primaryProjectWorkspace, useProjectSummaries, useProjectSummary, type ProjectMemberSummary, type ProjectSummary, type ProjectWorkspaceSummary, } from './useProjectSummaries';

package/dist/connection/projects/useProjectSummaries.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Projects joined with their workspaces: what a project list or a project page shows of each
+ * project (its details, workspaces, documents, threads, people, storage and AI quota), from the
+ * shared `useProjects` and `useWorkspaces` lists (no request of its own). A project is created with
+ * `useCreateProject` (`@arbidocs/react`).
+ *
+ * Generic: a site's words for a project ("matter", "engagement"…) and for its fields live in its
+ * own config; these are the backend's project and its `client`, `client_ref`, `stage`,
+ * `lead_user`, `budget` and host `fields`.
+ */
+import type { components } from '@arbidocs/client';
+import { type GroupedWorkspace } from '../../workspaces/workspace-groups';
+type ProjectResponse = components['schemas']['ProjectResponse'];
+type ProjectBudget = components['schemas']['ProjectBudget'];
+/** A workspace of a project, with its counts. */
+export interface ProjectWorkspaceSummary {
+    id: string;
+    name: string;
+    description?: string;
+    isPublic: boolean;
+    documentCount: number;
+    conversationCount: number;
+    memberCount: number;
+    filesMb: number;
+    updatedAt: string;
+}
+/** A member of any of the project's workspaces; possibly an agent (`agt-…`). */
+export interface ProjectMemberSummary {
+    id: string;
+    name: string;
+    email: string;
+    role: string;
+    isAgent: boolean;
+}
+/** A project and the work it groups. */
+export interface ProjectSummary {
+    id: string;
+    name: string;
+    createdAt: string;
+    subscription: string;
+    workspaces: ProjectWorkspaceSummary[];
+    workspaceCount: number;
+    documentCount: number;
+    conversationCount: number;
+    /** Everyone in the project's workspaces, agents included (`isAgent`). */
+    members: ProjectMemberSummary[];
+    /** The people (no agents). */
+    memberCount: number;
+    filesMb: number;
+    storageUsedGb: number;
+    storageLimitGb: number;
+    /** AI usage this period against the project's limit (the quota's units). */
+    aiUsageUsed: number;
+    aiUsageLimit: number;
+    client: string | null;
+    clientRef: string | null;
+    stage: string | null;
+    /** The project's lead (`usr-…`). */
+    leadUser: string | null;
+    budget: ProjectBudget | null;
+    /** The host's own fields on the project. */
+    fields: Record<string, unknown>;
+}
+/** Join projects with their workspaces; the projects with the most work first. */
+export declare function buildProjectSummaries(projects: readonly ProjectResponse[] | undefined, workspaces: readonly GroupedWorkspace[] | undefined): ProjectSummary[];
+/** Every project the caller has, joined with its workspaces. */
+export declare function useProjectSummaries(): {
+    projects: ProjectSummary[];
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+};
+/** One project's summary, with its AI usage this period. */
+export declare function useProjectSummary(projectId: string | undefined): {
+    project: ProjectSummary | undefined;
+    usage: NoInfer<{
+        external_usage?: {
+            [key: string]: unknown;
+        } | null;
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }> | NoInfer<{
+        external_usage?: {
+            [key: string]: unknown;
+        } | null;
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }> | NoInfer<{
+        external_usage?: {
+            [key: string]: unknown;
+        } | null;
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }> | undefined;
+    usageLoading: boolean;
+    isLoading: boolean;
+    isError: boolean;
+};
+/** The workspace a project's work runs in: the one with the most work. */
+export declare function primaryProjectWorkspace(project: Pick<ProjectSummary, 'workspaces'>): ProjectWorkspaceSummary | undefined;
+export {};

package/dist/databases/index.cjs

@@ -1648,7 +1648,7 @@ var DEFAULT_DATABASE_COLUMN_DIALOG_LABELS = {
   addDescription: "Pick what the column holds; every cell in it is checked against its type.",
   editDescription: "Rename the column or change its options.",
   name: "Name",
-  namePlaceholder: "e.g. Client, Matter number, Fee",
+  namePlaceholder: "e.g. Client, Reference, Fee",
   type: "Type",
   typeFixed: "A column\u2019s type can\u2019t be changed once it has been added.",
   options: "Options",