@tokensapi/dsh-finance 0.1.0-beta.1

package/lib/types/client/FinanceBackupSection.d.ts

@@ -0,0 +1,8 @@
+import type { FinanceApi } from './FinanceOverlay.tsx';
+interface Props {
+    api: FinanceApi;
+    currentRevision: number;
+    onRestored: () => Promise<void>;
+}
+export declare function FinanceBackupSection({ api, currentRevision, onRestored }: Props): import("react").JSX.Element;
+export {};

package/lib/types/client/FinanceBatchSection.d.ts

@@ -0,0 +1,9 @@
+import type { CompanyWorkspace } from '../contract.ts';
+import type { FinanceApi } from './FinanceOverlay.tsx';
+interface Props {
+    api: FinanceApi;
+    workspace: CompanyWorkspace;
+    onRevision: (revision: number) => void;
+}
+export declare function FinanceBatchSection({ api, workspace, onRevision }: Props): import("react").JSX.Element;
+export {};

package/lib/types/client/FinanceImportSection.d.ts

@@ -0,0 +1,9 @@
+import type { CompanyWorkspace } from '../contract.ts';
+import type { FinanceApi } from './FinanceOverlay.tsx';
+interface Props {
+    api: FinanceApi;
+    workspace: CompanyWorkspace;
+    onRevision: (revision: number) => void;
+}
+export declare function FinanceImportSection({ api, workspace, onRevision }: Props): import("react").JSX.Element;
+export {};

package/lib/types/client/FinanceLauncher.d.ts

@@ -0,0 +1,4 @@
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { createFinanceViewStore } from './store.ts';
+export type FinanceLauncherProps = PropsRuntime<'sidebar.footer.action'> & PropsStore<ReturnType<typeof createFinanceViewStore>> & PropsLocale<'tokens-cowork-finance'>;
+export declare function FinanceLauncher({ wide, useStore, actions, t }: FinanceLauncherProps): import("react").JSX.Element;

package/lib/types/client/FinanceOverlay.d.ts

@@ -0,0 +1,82 @@
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AccountCategory, BackupEnvelope, BackupPreview, BatchDetail, BatchMutationInput, CompanyWorkspace, CompanyBatchList, CommitImportInput, FinanceBootstrap, FinanceReports, GenerateReportsInput, ImportCommitResult, ImportPreview, PreviewImportInput, PreviewBackupInput, RestoreBackupInput, TransactionMutationInput, UpdateAccountInput, UpdateBatchFundingInput, UpdateTransactionInput } from '../contract.ts';
+import type { createFinanceViewStore } from './store.ts';
+export interface FinanceApi {
+    bootstrap(): Promise<FinanceBootstrap>;
+    workspace(id: string): Promise<CompanyWorkspace>;
+    createCompany(input: {
+        name: string;
+        baseCurrency: string;
+        currencyExponent: number;
+        openingDate: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    renameCompany(input: {
+        companyId: string;
+        name: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    deleteCompany(input: {
+        companyId: string;
+        confirmationName: string;
+        expectedRevision: number;
+    }): Promise<FinanceBootstrap>;
+    createAccount(input: {
+        companyId: string;
+        code: string;
+        name: string;
+        category: AccountCategory;
+        reportItem: string;
+        isContra: boolean;
+        openingBalanceMinor: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    updateAccount(input: UpdateAccountInput): Promise<CompanyWorkspace>;
+    updateBalance(input: {
+        accountId: string;
+        openingBalanceMinor: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    updateOpeningSettings(input: {
+        companyId: string;
+        openingDate: string;
+        baseCurrency: string;
+        currencyExponent: number;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    deleteAccount(input: {
+        accountId: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    setRetained(input: {
+        companyId: string;
+        accountId: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    lock(input: {
+        companyId: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    unlock(input: {
+        companyId: string;
+        expectedRevision: number;
+    }): Promise<CompanyWorkspace>;
+    previewImport(input: PreviewImportInput): Promise<ImportPreview>;
+    commitImport(input: CommitImportInput): Promise<ImportCommitResult>;
+    companyBatches(companyId: string): Promise<CompanyBatchList>;
+    batchDetail(batchId: string): Promise<BatchDetail>;
+    updateTransaction(input: UpdateTransactionInput): Promise<BatchDetail>;
+    deleteTransaction(input: TransactionMutationInput): Promise<BatchDetail>;
+    updateBatchFunding(input: UpdateBatchFundingInput): Promise<BatchDetail>;
+    deleteBatch(input: BatchMutationInput): Promise<CompanyBatchList>;
+    approveBatch(input: BatchMutationInput): Promise<BatchDetail>;
+    unapproveBatch(input: BatchMutationInput): Promise<BatchDetail>;
+    generateReports(input: GenerateReportsInput): Promise<FinanceReports>;
+    exportBackup(): Promise<BackupEnvelope>;
+    previewBackup(input: PreviewBackupInput): Promise<BackupPreview>;
+    restoreBackup(input: RestoreBackupInput): Promise<FinanceBootstrap>;
+}
+export type FinanceOverlayProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnType<typeof createFinanceViewStore>> & PropsLocale<'tokens-cowork-finance'> & {
+    api: FinanceApi;
+};
+export declare function FinanceOverlay({ useStore, actions, t, api }: FinanceOverlayProps): import("react").ReactPortal | null;

package/lib/types/client/FinanceReportSection.d.ts

@@ -0,0 +1,8 @@
+import type { CompanyWorkspace } from '../contract.ts';
+import type { FinanceApi } from './FinanceOverlay.tsx';
+interface Props {
+    api: FinanceApi;
+    workspace: CompanyWorkspace;
+}
+export declare function FinanceReportSection({ api, workspace }: Props): import("react").JSX.Element;
+export {};

package/lib/types/client/index.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type FinanceLocaleKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'tokens-cowork-finance': FinanceLocaleKey;
+    }
+}
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/types/client/locales.d.ts

@@ -0,0 +1,26 @@
+export declare const NS = "tokens-cowork-finance";
+export declare const zh: {
+    readonly title: "财务报表";
+    readonly subtitle: "基于银行流水生成资产负债表和利润表";
+    readonly close: "关闭财务报表";
+    readonly loading: "正在读取本地财务数据…";
+    readonly emptyTitle: "尚未创建公司";
+    readonly emptyDescription: "创建第一家公司后，即可设置会计科目、导入银行流水并生成报表。";
+    readonly skeletonNotice: "插件骨架已连接。公司、科目、流水和报表功能将在下一阶段实现。";
+    readonly loadFailed: "无法读取财务数据";
+    readonly retry: "重试";
+    readonly localOnly: "财务数据保存在 TokensCowork 本地存储中。";
+};
+export declare const en: {
+    readonly title: "Finance Reports";
+    readonly subtitle: "Generate balance sheets and income statements from bank transactions";
+    readonly close: "Close finance reports";
+    readonly loading: "Loading local finance data…";
+    readonly emptyTitle: "No company yet";
+    readonly emptyDescription: "Create a company to configure accounts, import bank transactions, and generate reports.";
+    readonly skeletonNotice: "The plugin skeleton is connected. Company, account, transaction, and reporting features come next.";
+    readonly loadFailed: "Unable to load finance data";
+    readonly retry: "Retry";
+    readonly localOnly: "Finance data is stored locally by TokensCowork.";
+};
+export type FinanceLocaleKey = keyof typeof zh;

package/lib/types/client/remote.d.ts

@@ -0,0 +1,45 @@
+import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import { type CompanyMutationInput, type CompanyWorkspace, type CreateAccountInput, type CreateCompanyInput, type DeleteCompanyInput, type FinanceBootstrap, type RenameCompanyInput, type RevisionedIdInput, type SetRetainedEarningsInput, type UpdateAccountInput, type UpdateOpeningBalanceInput, type UpdateOpeningSettingsInput, type PreviewImportInput, type ImportPreview, type CommitImportInput, type ImportCommitResult, type CompanyBatchList, type BatchDetail, type UpdateTransactionInput, type TransactionMutationInput, type UpdateBatchFundingInput, type BatchMutationInput, type GenerateReportsInput, type FinanceReports, type BackupEnvelope, type BackupPreview, type PreviewBackupInput, type RestoreBackupInput } from '../contract.ts';
+export declare const FINANCE_REMOTE: TypertRemoteContribution;
+export interface FinanceRemoteFace {
+    getBootstrap(): Promise<RemoteResult<FinanceBootstrap>>;
+    getCompanyWorkspace(input: {
+        companyId: string;
+    }): Promise<RemoteResult<CompanyWorkspace>>;
+    createCompany(input: CreateCompanyInput): Promise<RemoteResult<CompanyWorkspace>>;
+    renameCompany(input: RenameCompanyInput): Promise<RemoteResult<CompanyWorkspace>>;
+    deleteCompany(input: DeleteCompanyInput): Promise<RemoteResult<FinanceBootstrap>>;
+    createAccount(input: CreateAccountInput): Promise<RemoteResult<CompanyWorkspace>>;
+    updateAccount(input: UpdateAccountInput): Promise<RemoteResult<CompanyWorkspace>>;
+    deleteAccount(input: RevisionedIdInput): Promise<RemoteResult<CompanyWorkspace>>;
+    updateOpeningBalance(input: UpdateOpeningBalanceInput): Promise<RemoteResult<CompanyWorkspace>>;
+    updateOpeningSettings(input: UpdateOpeningSettingsInput): Promise<RemoteResult<CompanyWorkspace>>;
+    setRetainedEarningsAccount(input: SetRetainedEarningsInput): Promise<RemoteResult<CompanyWorkspace>>;
+    lockOpening(input: CompanyMutationInput): Promise<RemoteResult<CompanyWorkspace>>;
+    unlockOpening(input: CompanyMutationInput): Promise<RemoteResult<CompanyWorkspace>>;
+    previewImport(input: PreviewImportInput): Promise<RemoteResult<ImportPreview>>;
+    commitImport(input: CommitImportInput): Promise<RemoteResult<ImportCommitResult>>;
+    getCompanyBatches(input: {
+        companyId: string;
+    }): Promise<RemoteResult<CompanyBatchList>>;
+    getBatchDetail(input: {
+        batchId: string;
+    }): Promise<RemoteResult<BatchDetail>>;
+    updateTransaction(input: UpdateTransactionInput): Promise<RemoteResult<BatchDetail>>;
+    deleteTransaction(input: TransactionMutationInput): Promise<RemoteResult<BatchDetail>>;
+    updateBatchFundingAccount(input: UpdateBatchFundingInput): Promise<RemoteResult<BatchDetail>>;
+    deleteBatch(input: BatchMutationInput): Promise<RemoteResult<CompanyBatchList>>;
+    approveBatch(input: BatchMutationInput): Promise<RemoteResult<BatchDetail>>;
+    unapproveBatch(input: BatchMutationInput): Promise<RemoteResult<BatchDetail>>;
+    generateReports(input: GenerateReportsInput): Promise<RemoteResult<FinanceReports>>;
+    exportBackup(): Promise<RemoteResult<BackupEnvelope>>;
+    previewBackup(input: PreviewBackupInput): Promise<RemoteResult<BackupPreview>>;
+    restoreBackup(input: RestoreBackupInput): Promise<RemoteResult<FinanceBootstrap>>;
+}
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespace$66696e616e6365 extends FinanceRemoteFace {
+    }
+    interface TypertRemoteNamespaceMap {
+        finance: TypertRemoteNamespace$66696e616e6365;
+    }
+}

package/lib/types/client/store.d.ts

@@ -0,0 +1,18 @@
+import type { StoreHandle } from '@deepseek-ai/dsh-client-ui-slots';
+export interface FinanceViewState {
+    open: boolean;
+}
+type FinanceViewActions = {
+    open: (draft: FinanceViewState) => void;
+    close: (draft: FinanceViewState) => void;
+};
+/**
+ * Build the small observable store contract consumed by DSH 0.4.4 slots.
+ *
+ * DSH 0.4.4 removed the former dsh-client-runtime package and moved its generic
+ * store engine into an unpublished internal package. Keeping this store local
+ * makes the plugin bundle self-contained while preserving the public slot
+ * contract: spec/create/getSnapshot/subscribe/actions/clearPersisted.
+ */
+export declare function createFinanceViewStore(): StoreHandle<FinanceViewState, FinanceViewActions>;
+export {};

package/lib/types/client/styles.d.ts

@@ -0,0 +1 @@
+export declare function installFinanceStyles(): () => void;