skill-bill 0.2.0 → 0.2.1

package/dist/setup/importer.d.ts

@@ -0,0 +1,79 @@
+import type { BillDb, BillRow } from '../fetch/index.js';
+/** 导入认的六个字段（老侧 `MAPPING_HINTS` 里除「收支方向」外的六项——方向由金额符号定，见下）。 */
+export type ImportField = 'time' | 'amount' | 'category' | 'account' | 'ledger' | 'note';
+/** 字段序号（列映射的取值面）。 */
+export declare const IMPORT_FIELDS: readonly ImportField[];
+/** 字段的中文名（老侧字段标签同集；页面与报错共用一处）。 */
+export declare const FIELD_LABEL: Readonly<Record<ImportField, string>>;
+/** 必填三列（老侧 `MAPPING_HINTS` 的 `必填` 标记：日期／金额／分类）。 */
+export declare const REQUIRED_FIELDS: readonly ImportField[];
+/** 老侧的缺省列序（无表头或猜不出时的兜底：`cli.py:469-474` 缺 date→1／amount→2／category→3）。 */
+export declare const DEFAULT_ORDER: Readonly<Record<ImportField, number>>;
+/** 预览取前几行（老侧 `cli.py:545` 的 `Math.min(8, …)` 同数）。 */
+export declare const PREVIEW_ROWS = 8;
+/** 读出来的一张 CSV（表头／数据行／编码）。 */
+export interface CsvFile {
+    readonly file: string;
+    readonly name: string;
+    readonly encoding: string;
+    readonly hasHeader: boolean;
+    readonly header: readonly string[];
+    readonly rows: readonly (readonly string[])[];
+}
+/** 列映射（字段 → 0 起的列号；缺项＝没映射）。 */
+export type ColumnMap = {
+    readonly [k in ImportField]?: number;
+};
+/** 一条排好的待写行。 */
+export interface ImportRow {
+    readonly line: number;
+    readonly time: string;
+    readonly amount: number;
+    readonly category: string;
+    readonly account: string;
+    readonly ledger: string;
+    readonly note: string;
+}
+/** 一条读不出来的行（哪一行／为什么）。 */
+export interface BadRow {
+    readonly line: number;
+    readonly why: string;
+}
+/** 一条与库里已有记录重号的行。 */
+export interface DuplicateRow {
+    readonly line: number;
+    readonly signature: string;
+}
+/** 这一次导入的计划（页面照它说「将新增几行」，写库照它写）。 */
+export interface ImportPlan {
+    readonly rows: readonly ImportRow[];
+    readonly duplicates: readonly DuplicateRow[];
+    readonly bad: readonly BadRow[];
+    readonly newRows: number;
+}
+/** 一条记录的签名（重复检测的判据：时刻＋金额＋分类＋备注四件，**不经数据库**）。 */
+export declare function signatureOf(r: {
+    time: string;
+    amount: number;
+    category: string;
+    note: string;
+}): string;
+/** 读一张 CSV（缺文件／空文件在这一层报「取数失败」；坏在文件本身，不是缺参数）。 */
+export declare function readCsv(file: string): CsvFile;
+/** 按表头猜映射（猜不出的必填项用老侧缺省列序兜底）。 */
+export declare function guessMap(csv: CsvFile): ColumnMap;
+/** 解析用户写的映射原文（`日期=第1列,金额=第3列`；也认 `time=1` 这种）。认不得即抛——**不猜**。 */
+export declare function parseMapping(text: string): ColumnMap;
+/** 必填三列里还缺哪些（空数组＝可以往下走）。 */
+export declare function missingRequired(map: ColumnMap): readonly ImportField[];
+/** 排一遍导入计划：逐行试读，读得动的进 `rows`，与库里重号的进 `duplicates`，读不动的进 `bad`。 */
+export declare function planImport(csv: CsvFile, map: ColumnMap, existing: readonly BillRow[]): ImportPlan;
+/** 真写：整批一个事务（要么全进、要么全不进），返回成功行数与读不出来的行。
+ *  计划里已经剔过坏行，故正常路径下失败为空；写库中途抛错即回滚并把那一条记进 `failed`。 */
+export declare function applyImport(db: BillDb, plan: ImportPlan): {
+    readonly inserted: number;
+    readonly failed: readonly BadRow[];
+};
+/** 库里现有记录（重复检测的对照面）。 */
+export declare function existingRows(db: BillDb): readonly BillRow[];
+//# sourceMappingURL=importer.d.ts.map

package/dist/setup/importer.d.ts.map

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

package/dist/setup/importer.js

@@ -0,0 +1,231 @@
+/** 开始使用域的 CSV 导入面：**读文件 → 认列 → 排一遍计划（新增／重复／坏行）→ 真写**。
+ *
+ * 老侧对应件：`scripts/setup/cli.py` 的 `_read_csv_rows`（478-492）／`guess_mapping`（455-475）／
+ *   `build_import_payload`（495-559）／`cmd_import` 的写库循环（587-645），字段标签同 `MAPPING_HINTS`（62-70）。
+ *   老侧逐块取证见 `.scratch/t731/old-setup.md` §6。
+ *
+ * **`#688` §二 D2 的「导入四件」在这里逐件落地**（老侧四件全无，逐条证据见 `t731-差异表.md`）：
+ *   ① 明示「本次将新增 N 行、不覆盖已有记录」——`planImport` 算出来的 `newRows`／`duplicates`／`bad` 三档，
+ *      页面照它出话（老侧只报文件总行数，`import.html:158/161`）；
+ *   ② 导入前**自动备份一次**——住在 `./run.js`（导入这条路先调 `createBackup`，见那里的顺序）；
+ *   ③ **重复导入检测**——本件的 `planImport` 拿库里已有的记录（`time|amount|category|note` 四件签名）逐行比，
+ *      同一个 CSV 导两次，第二次的每一行都会落进 `duplicates`（老侧 `db.py:85-89` 是纯 INSERT，无去重）；
+ *   ④ **页面级结果卡**——`applyImport` 回成功／失败行数与失败原因（老侧失败只在 stdout，页面 0 命中）。
+ *
+ * 两处**有意与老侧不同**（都写进差异表）：
+ *   - 老侧逐行 `insert_record`（每行开一次连接、各自 commit，`db.py:82/89`）——中途失败已写的行不回退；
+ *     新侧**整批一个事务**：要么全进，要么全不进（失败行先剔除，剩下的都是能写的）；
+ *   - 老侧 `total` 把被跳过的空行也算进去（`cli.py:632` 对 `597-598`）——新侧三档分开报，不混一个数。
+ */
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import { BillFetchError, BillPolicyError } from '../fetch/errors.js';
+import { addBill, fetchAll } from '../fetch/index.js';
+import { validateAmount, validateCategory } from '../shared/category.js';
+import { validateTime } from '../shared/dateRange.js';
+/** 字段序号（列映射的取值面）。 */
+export const IMPORT_FIELDS = ['time', 'amount', 'category', 'account', 'ledger', 'note'];
+/** 字段的中文名（老侧字段标签同集；页面与报错共用一处）。 */
+export const FIELD_LABEL = {
+    time: '日期/时间',
+    amount: '金额',
+    category: '分类',
+    account: '账户',
+    ledger: '账本',
+    note: '备注',
+};
+/** 必填三列（老侧 `MAPPING_HINTS` 的 `必填` 标记：日期／金额／分类）。 */
+export const REQUIRED_FIELDS = ['time', 'amount', 'category'];
+/** 老侧的缺省列序（无表头或猜不出时的兜底：`cli.py:469-474` 缺 date→1／amount→2／category→3）。 */
+export const DEFAULT_ORDER = {
+    time: 0, amount: 1, category: 2, account: 3, ledger: 4, note: 5,
+};
+/** 表头关键词（老侧 `MAPPING_HINTS` 的中文词集 ＋ 英文小写；命中即认）。 */
+const HEADER_WORDS = {
+    time: ['日期', '时间', '交易时间', '记账日期', 'date', 'time'],
+    amount: ['金额', '数额', 'amount', 'money'],
+    category: ['分类', '类别', 'category'],
+    account: ['账户', '帐号', 'account'],
+    ledger: ['账本', '帐本', 'ledger'],
+    note: ['备注', '摘要', 'note', 'memo'],
+};
+/** 预览取前几行（老侧 `cli.py:545` 的 `Math.min(8, …)` 同数）。 */
+export const PREVIEW_ROWS = 8;
+/** 一条记录的签名（重复检测的判据：时刻＋金额＋分类＋备注四件，**不经数据库**）。 */
+export function signatureOf(r) {
+    return [r.time.trim(), r.amount.toFixed(2), r.category.trim(), r.note.trim()].join('|');
+}
+/** 解码：先按 UTF-8 读，出现替换字符再按 GBK 读（老侧 `cli.py:482-488` 的 `utf-8-sig → gbk` 同序）。 */
+function decode(raw) {
+    const utf8 = raw.toString('utf8').replace(/^\uFEFF/, '');
+    if (!utf8.includes('\uFFFD'))
+        return { text: utf8, encoding: 'UTF-8' };
+    try {
+        const gbk = new TextDecoder('gbk').decode(raw);
+        return { text: gbk, encoding: 'GBK' };
+    }
+    catch {
+        return { text: utf8, encoding: 'UTF-8（有读不出的字符）' };
+    }
+}
+/** 一行拆成格子：照老侧按逗号切（`cli.py:597-598`），引号不特殊处理——本仓不替用户猜 CSV 方言。 */
+function cellsOf(line) {
+    return line.split(',').map((c) => c.trim());
+}
+/** 首行是不是表头：命中任一关键词即当表头（老侧 `cli.py:509-525` 同判法）。 */
+function looksLikeHeader(cells) {
+    const words = Object.values(HEADER_WORDS).flat();
+    return cells.some((c) => words.includes(c.trim().toLowerCase()) || words.includes(c.trim()));
+}
+/** 读一张 CSV（缺文件／空文件在这一层报「取数失败」；坏在文件本身，不是缺参数）。 */
+export function readCsv(file) {
+    let raw;
+    try {
+        raw = readFileSync(file);
+    }
+    catch (e) {
+        throw new BillFetchError('BILL_DB_MISSING', '导入文件读不出来：' + file, { cause: e });
+    }
+    const { text, encoding } = decode(raw);
+    const lines = text.split(/\r?\n/).map((l) => l.trim()).filter((l) => l !== '');
+    if (lines.length === 0)
+        throw new BillFetchError('BILL_BAD_QUERY', 'CSV 一行都没有：' + file);
+    const first = cellsOf(lines[0]);
+    const hasHeader = looksLikeHeader(first);
+    return {
+        file,
+        name: basename(file),
+        encoding,
+        hasHeader,
+        header: hasHeader ? first : first.map((_c, i) => '列' + String(i + 1)),
+        rows: (hasHeader ? lines.slice(1) : lines).map((l) => cellsOf(l)),
+    };
+}
+/** 按表头猜映射（猜不出的必填项用老侧缺省列序兜底）。 */
+export function guessMap(csv) {
+    const out = {};
+    for (const field of IMPORT_FIELDS) {
+        const words = HEADER_WORDS[field];
+        const hit = csv.header.findIndex((h) => {
+            const cell = h.trim().toLowerCase();
+            return words.some((w) => cell === w.toLowerCase() || (cell !== '' && cell.includes(w.toLowerCase())));
+        });
+        if (hit >= 0 && !Object.values(out).includes(hit))
+            out[field] = hit;
+    }
+    for (const field of IMPORT_FIELDS) {
+        if (out[field] !== undefined)
+            continue;
+        const fallback = DEFAULT_ORDER[field];
+        if (fallback < csv.header.length && !Object.values(out).includes(fallback))
+            out[field] = fallback;
+    }
+    return out;
+}
+/** 解析用户写的映射原文（`日期=第1列,金额=第3列`；也认 `time=1` 这种）。认不得即抛——**不猜**。 */
+export function parseMapping(text) {
+    const out = {};
+    for (const piece of text.split(/[,，]/).map((p) => p.trim()).filter((p) => p !== '')) {
+        const m = /^(.+?)\s*=\s*(?:第)?\s*(\d+)\s*列?$/.exec(piece);
+        if (m === null)
+            throw new BillPolicyError('POLICY_BAD_INPUT', '列映射写不明白：' + piece
+                + '（照「日期=第1列,金额=第3列」这样写）');
+        const label = m[1].trim().toLowerCase();
+        const col = Number(m[2]) - 1;
+        if (!Number.isInteger(col) || col < 0)
+            throw new BillPolicyError('POLICY_BAD_INPUT', '列号要从 1 起数：' + piece);
+        const field = IMPORT_FIELDS.find((f) => f === label
+            || FIELD_LABEL[f] === m[1].trim()
+            || HEADER_WORDS[f].some((w) => w.toLowerCase() === label));
+        if (field === undefined) {
+            throw new BillPolicyError('POLICY_BAD_INPUT', '认不得这一列是哪个字段：' + m[1].trim()
+                + '（认这些：' + IMPORT_FIELDS.map((f) => FIELD_LABEL[f]).join('／') + '）');
+        }
+        out[field] = col;
+    }
+    return out;
+}
+/** 必填三列里还缺哪些（空数组＝可以往下走）。 */
+export function missingRequired(map) {
+    return REQUIRED_FIELDS.filter((f) => map[f] === undefined);
+}
+/** 一格取值（列号越界或没映射＝空串）。 */
+function cell(row, col) {
+    if (col === undefined || col < 0 || col >= row.length)
+        return '';
+    return row[col].trim();
+}
+/** 排一遍导入计划：逐行试读，读得动的进 `rows`，与库里重号的进 `duplicates`，读不动的进 `bad`。 */
+export function planImport(csv, map, existing) {
+    const known = new Set(existing.map((r) => signatureOf(r)));
+    const rows = [];
+    const duplicates = [];
+    const bad = [];
+    const seen = new Set();
+    csv.rows.forEach((cells, i) => {
+        const line = i + (csv.hasHeader ? 2 : 1);
+        if (cells.every((c) => c === ''))
+            return; // 整行空白：跳过，不计入任何一档（老侧同样跳）
+        const rawTime = cell(cells, map.time);
+        const rawAmount = cell(cells, map.amount);
+        const rawCategory = cell(cells, map.category) === '' ? '其他' : cell(cells, map.category);
+        try {
+            const time = validateTime(rawTime);
+            // 老侧没有「收支方向」这一格时按符号定：金额栏自带方向上，`cli.py:614-617` 的方向列本仓不收。
+            const amount = validateAmount(rawAmount);
+            const category = validateCategory(rawCategory);
+            const row = {
+                line, time, amount, category,
+                account: cell(cells, map.account),
+                ledger: cell(cells, map.ledger) === '' ? '生活' : cell(cells, map.ledger),
+                note: cell(cells, map.note),
+            };
+            const sig = signatureOf(row);
+            if (known.has(sig) || seen.has(sig)) {
+                duplicates.push({ line, signature: sig });
+                return;
+            }
+            seen.add(sig);
+            rows.push(row);
+        }
+        catch (e) {
+            bad.push({ line, why: e.message });
+        }
+    });
+    return { rows, duplicates, bad, newRows: rows.length };
+}
+/** 真写：整批一个事务（要么全进、要么全不进），返回成功行数与读不出来的行。
+ *  计划里已经剔过坏行，故正常路径下失败为空；写库中途抛错即回滚并把那一条记进 `failed`。 */
+export function applyImport(db, plan) {
+    const failed = [];
+    let inserted = 0;
+    db.db.exec('BEGIN');
+    try {
+        for (const row of plan.rows) {
+            try {
+                addBill(db, {
+                    category: row.category, amount: row.amount, time: row.time,
+                    account: row.account, ledger: row.ledger, currency: '人民币', note: row.note,
+                });
+                inserted += 1;
+            }
+            catch (e) {
+                failed.push({ line: row.line, why: e.message });
+            }
+        }
+        db.db.exec('COMMIT');
+    }
+    catch (e) {
+        try {
+            db.db.exec('ROLLBACK');
+        }
+        catch { /* 回滚失败也照样抛下面那句 */ }
+        throw new BillFetchError('BILL_DB_UNREADABLE', '导入写库失败，整批回滚了：' + e.message);
+    }
+    return { inserted, failed };
+}
+/** 库里现有记录（重复检测的对照面）。 */
+export function existingRows(db) {
+    return fetchAll(db, { includeDeleted: true });
+}
+//# sourceMappingURL=importer.js.map

package/dist/setup/importer.js.map

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

package/dist/setup/index.d.ts

@@ -0,0 +1,8 @@
+/** 开始使用域对外的门：**命令声明**（权威源在 `./commands.ts`，这里只是转出）。
+ *
+ * 与账户域同形（`../account/index.ts`）：出口分派只要一条命令的 `run`，故本域不再多转一个入口函数；
+ * 域内其他件（六件场景件、三片页型件、`./params.js`／`./backups.js`／`./status.js`／`./importer.js`／
+ * `./steps.js`／`./pageParts.js`／`./run.js`）**不出这个目录**，不在这里转出。
+ */
+export { SETUP_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/setup/index.js

@@ -0,0 +1,8 @@
+/** 开始使用域对外的门：**命令声明**（权威源在 `./commands.ts`，这里只是转出）。
+ *
+ * 与账户域同形（`../account/index.ts`）：出口分派只要一条命令的 `run`，故本域不再多转一个入口函数；
+ * 域内其他件（六件场景件、三片页型件、`./params.js`／`./backups.js`／`./status.js`／`./importer.js`／
+ * `./steps.js`／`./pageParts.js`／`./run.js`）**不出这个目录**，不在这里转出。
+ */
+export { SETUP_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/setup/pageParts.d.ts

@@ -0,0 +1,93 @@
+import type { SerializableEnvelope, StatusKind } from 'base-paint';
+import type { ParamFieldInput } from 'base-paint/blocks';
+import type { PageShellInput } from '../shared/pageShell.js';
+import { humanBytes } from './backups.js';
+import type { WizardStep } from './steps.js';
+import type { SetupBlocked, SetupSlot } from './params.js';
+/** 开始使用域各页的眉标：**只在本域写一次**（共用位不持「域名→取值」表；老侧 `init_wizard.html:60` 同句）。 */
+export declare const EYEBROW = "\u8BB0\u8D26\uFF5C\u5F00\u59CB\u4F7F\u7528";
+/** 本域各页统一走它：补上眉标再转共用位的 `pageShell`。 */
+export declare function setupPageShell(input: Omit<PageShellInput, 'eyebrow'>): string;
+/** 六种 op 同走 `receipt` 形（本域只有一条命令、一个形状；`receipt` 形只校验 `ok`／`message` 两格，
+ *  其余字段是各 op 自己的事实，照 `../shared/commandSpec.js` 的写入域口径办）。 */
+export declare function receiptEnvelopeOf(key: string, data: {
+    readonly ok: boolean;
+    readonly message: string;
+} & Record<string, unknown>): SerializableEnvelope;
+/** 缺值占位（`#688` 裁定 4）。 */
+export declare const MISSING = "\u2014";
+/** 一个值写成上屏文本：空白串与缺值一律 `—`（不写 `undefined`、不留空）。 */
+export declare function textOrDash(v: unknown): string;
+/** 字节数写成人话（列表页与回执页共用 `./backups.js` 那一处算式，本件只转出）。 */
+export { humanBytes };
+/** 类型徽章那一串（唤醒词 ＋ 口径 ＋ 状态徽章 ＋ 下一步动作）：形状照写入域／账户域同一套。 */
+export declare function badgeOf(input: {
+    readonly word: string;
+    readonly caliber: string;
+    readonly status: StatusKind;
+    readonly statusText: string;
+    readonly next: string;
+}): string;
+/** 步骤条的**进度面**：一枚 `共 N 步` ＋ 每步一枚 `第 N 步 · 步骤名 · 状态`。
+ *  空数组＝不出（「没内容不留空块」）；**不在这里判全部通过**——状态是 `./steps.js` 算好的事实。 */
+export declare function stepChipsOf(steps: readonly WizardStep[]): string;
+/** 步骤条的**说明面**：每一步一行（第几步／步骤名／现在什么情况／状态）。
+ *  这一张表是「徽章列承载不了的不足处」的域内落点，见本件头注释那条口径。 */
+export declare function stepTableOf(steps: readonly WizardStep[]): string;
+/** 环境检测那一格：老侧 `init_wizard.html:155` 空 `env.checks` 时回落渲染绿色「✓ 全部通过」＝**假绿**
+ *  （`#688` §二 D7／`.scratch/t731/old-setup.md` §7(c)）——**不照抄**：
+ *  本件对「一项都没检测到」和「检测项都过了」出**两句不同的话**，且前者不给绿灯。 */
+export declare function envChecksOf(checks: readonly {
+    readonly label: string;
+    readonly ok: boolean;
+    readonly detail: string;
+}[]): string;
+/** 字段卡的一格（普通数据：参数名／中文名／怎么给／是否必需）。 */
+export declare function slotFieldsOf(params: Record<string, unknown>, fields: readonly SetupSlot[]): ParamFieldInput[];
+/** 缺项阻断条（照 `#688` 裁定 9 的同一条判法：缺什么就不给复制）：一边点名缺哪几项，
+ *  一边给只读的补齐口令（不给复制按钮——页面上那条口令只给看不给复制，与账户域同形）。 */
+export declare function blockedOf(input: {
+    readonly blocked: readonly SetupBlocked[];
+    readonly command: string;
+}): string;
+/** 复制指令块（过程型页的「照这句跟助手说一遍」）：走公共层 `renderPreBlock` 自带复制按钮。 */
+export declare function promptBlockOf(prompt: string, label?: string): string;
+/** 复制区（数据位 ＋ 日志位；三格式与双按钮由共用件给）。 */
+export declare function copyZoneOf(input: {
+    readonly envelope: SerializableEnvelope;
+    readonly title: string;
+    readonly key: string;
+    readonly params: Record<string, unknown>;
+    readonly source: string;
+    readonly detail: string;
+    readonly actionAt: string;
+}): string;
+/** 空态（含「接下来怎么办」那一句）。 */
+export declare function emptyOf(input: {
+    readonly title?: string;
+    readonly text: string;
+    readonly next: string;
+}): string;
+/** 来源脚注（三片页型的每张页恒出，照 `#688` §五 5.2 第 26 行）。 */
+export declare function sourceNoteOf(input: {
+    readonly sourceText: string;
+    readonly start: string;
+    readonly end: string;
+    readonly count: number;
+}): string;
+/** 补齐口令：缺的值留成尖括号占位符（照账户域同件；`state` 那一格不是参数名，单给一条映射）。 */
+export declare function blockedCommandOf(key: string, params: Record<string, unknown>, blocked: readonly {
+    readonly name: string;
+    readonly label: string;
+}[]): string;
+/** 场景口令（过程型页复制的那一段）：说清是哪条词、每一格填什么。
+ *  空着的格写 `____`（必填）或 `____（选填）`，与老侧复制文本的占位写法同义。 */
+export declare function promptOf(word: string, slots: readonly SetupSlot[], params: Record<string, unknown>): string;
+/** 复制日志第 3 段／来源脚注那两句来源（给机器看的可带载体名，上屏的只写人话——`#688` 裁定 1）。 */
+export declare const SOURCE_READ = "\u8BB0\u8D26\u5E93\u4E0E\u5907\u4EFD\u76EE\u5F55\uFF08\u53EA\u8BFB\uFF09";
+export declare const SOURCE_READ_TEXT = "\u8BB0\u8D26\u5E93\u4E0E\u5907\u4EFD\u76EE\u5F55\uFF08\u53EA\u8BFB\uFF09";
+export declare const SOURCE_WRITE = "\u8BB0\u8D26\u5E93\u4E0E\u5907\u4EFD\u76EE\u5F55\uFF08\u5199\u5E93\u56DE\u6267\uFF09";
+export declare const SOURCE_WRITE_TEXT = "\u8BB0\u8D26\u5E93\u4E0E\u5907\u4EFD\u76EE\u5F55\uFF08\u5199\u5165\uFF09";
+export declare const SOURCE_FILE = "CSV \u6587\u4EF6\u4E0E\u8BB0\u8D26\u5E93\uFF08\u8BFB\u6587\u4EF6 \u00B7 \u5199\u5E93\u56DE\u6267\uFF09";
+export declare const SOURCE_FILE_TEXT = "CSV \u6587\u4EF6\u4E0E\u8BB0\u8D26\u5E93";
+//# sourceMappingURL=pageParts.d.ts.map

package/dist/setup/pageParts.d.ts.map

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