@zucker-framework/ext-kit 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,102 @@
+type Settings = Record<string, unknown>;
+interface CaptureContext {
+    /** batch = 后台批量新开 tab；quick = 用户当前浏览的 tab（不得改视口、需还原页面状态） */
+    mode: 'batch' | 'quick';
+    tabId: number;
+    url: string;
+    options: Settings;
+    /** chrome.debugger sendCommand（已 attach） */
+    send(method: string, params?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+interface CaptureOutput {
+    base64: string;
+    mime: string;
+    /** 文件扩展名，不含点："png" | "jpg" | "pdf" … */
+    extension: string;
+    /** 非致命告警（如超高截断），展示在结果列表 */
+    warning?: string;
+}
+interface LicensingConfig {
+    apiBase: string;
+    purchaseUrl: string;
+}
+/** 措辞（capture/convert 等动词差异）；不配则用 capture 系默认值 */
+interface ExtTexts {
+    alreadyRunning: string;
+    cannotQuick: string;
+    challengeBeforeQuick: (challenge: string) => string;
+    quickFolder: string;
+}
+interface ExtKitConfig {
+    /** 消费项目提供的存储 key 命名空间；已发布产品应保持原值，以兼容既有安装 */
+    product: string;
+    /** 品牌名：下载文件夹前缀、设备名 */
+    brand: string;
+    /** 消费项目提供的消息类型前缀，用于构造 START 等消息类型 */
+    messagePrefix: string;
+    freeDailyLimit?: number;
+    badgeColor: string;
+    defaultSettings: Settings;
+    licensing: LicensingConfig;
+    texts?: Partial<ExtTexts>;
+    /** 仅批量模式、autoScroll 之前调用（如固定视口宽度）；quick 模式不调用（不能动用户的 tab） */
+    beforeScroll?(ctx: CaptureContext): Promise<void>;
+    /** 核心业务：页面已加载、已过验证、已滚动揭示，产出要下载的数据 */
+    capture(ctx: CaptureContext): Promise<CaptureOutput>;
+}
+interface PopupTexts {
+    startNone: string;
+    startSome: (n: number) => string;
+    quickIng: string;
+    quickFailed: string;
+}
+interface PopupConfig {
+    messagePrefix: string;
+    /** 消费项目提供的 URL 队列存储 key；已发布产品应保持原值 */
+    queueKey: string;
+    /** 快速处理当前页的消息类型后缀：CAPTURE_CURRENT / CONVERT_CURRENT */
+    quickType: string;
+    /** 快速按钮的元素 id，默认 "captureCurrent"，可由消费项目覆盖 */
+    quickButtonId?: string;
+    texts: PopupTexts;
+    collectSettings(): Settings;
+    collectQuickSettings(): Settings;
+    /** 快速处理成功后的状态栏文案 */
+    quickResult(result: {
+        fileName: string;
+        warning?: string;
+    }): string;
+}
+
+declare function initExtension(config: ExtKitConfig): void;
+
+declare function initPopup(config: PopupConfig): void;
+
+interface Entitlement {
+    plan: string;
+    expiresAt: string;
+}
+interface Licensing {
+    activate(code: string): Promise<unknown>;
+    getEntitlement(): Promise<Entitlement | null>;
+    isPro(): Promise<boolean>;
+    clear(): Promise<void>;
+    purchaseUrl: string;
+}
+declare function createLicensing(product: string, brand: string, config: LicensingConfig): Licensing;
+
+declare function sanitize(value: string): string;
+declare function hostOf(url: string): string;
+declare function normalizeUrls(urls: unknown[]): string[];
+declare function sessionStamp(): string;
+declare function fileStamp(): string;
+declare function todayString(): string;
+declare function folderNameFor(urls: string[]): string;
+declare function urlBaseName(url: string, maxLength: number, includeQuery: boolean): string;
+declare function buildBatchFileName(folder: string, item: {
+    url: string;
+    index: number;
+}, extension: string): string;
+declare function buildQuickFileName(brand: string, quickFolder: string, pageUrl: string, extension: string): string;
+
+export { type CaptureContext, type CaptureOutput, type Entitlement, type ExtKitConfig, type ExtTexts, type Licensing, type LicensingConfig, type PopupConfig, type PopupTexts, type Settings, buildBatchFileName, buildQuickFileName, createLicensing, fileStamp, folderNameFor, hostOf, initExtension, initPopup, normalizeUrls, sanitize, sessionStamp, todayString, urlBaseName };

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+type Settings = Record<string, unknown>;
+interface CaptureContext {
+    /** batch = 后台批量新开 tab；quick = 用户当前浏览的 tab（不得改视口、需还原页面状态） */
+    mode: 'batch' | 'quick';
+    tabId: number;
+    url: string;
+    options: Settings;
+    /** chrome.debugger sendCommand（已 attach） */
+    send(method: string, params?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+interface CaptureOutput {
+    base64: string;
+    mime: string;
+    /** 文件扩展名，不含点："png" | "jpg" | "pdf" … */
+    extension: string;
+    /** 非致命告警（如超高截断），展示在结果列表 */
+    warning?: string;
+}
+interface LicensingConfig {
+    apiBase: string;
+    purchaseUrl: string;
+}
+/** 措辞（capture/convert 等动词差异）；不配则用 capture 系默认值 */
+interface ExtTexts {
+    alreadyRunning: string;
+    cannotQuick: string;
+    challengeBeforeQuick: (challenge: string) => string;
+    quickFolder: string;
+}
+interface ExtKitConfig {
+    /** 消费项目提供的存储 key 命名空间；已发布产品应保持原值，以兼容既有安装 */
+    product: string;
+    /** 品牌名：下载文件夹前缀、设备名 */
+    brand: string;
+    /** 消费项目提供的消息类型前缀，用于构造 START 等消息类型 */
+    messagePrefix: string;
+    freeDailyLimit?: number;
+    badgeColor: string;
+    defaultSettings: Settings;
+    licensing: LicensingConfig;
+    texts?: Partial<ExtTexts>;
+    /** 仅批量模式、autoScroll 之前调用（如固定视口宽度）；quick 模式不调用（不能动用户的 tab） */
+    beforeScroll?(ctx: CaptureContext): Promise<void>;
+    /** 核心业务：页面已加载、已过验证、已滚动揭示，产出要下载的数据 */
+    capture(ctx: CaptureContext): Promise<CaptureOutput>;
+}
+interface PopupTexts {
+    startNone: string;
+    startSome: (n: number) => string;
+    quickIng: string;
+    quickFailed: string;
+}
+interface PopupConfig {
+    messagePrefix: string;
+    /** 消费项目提供的 URL 队列存储 key；已发布产品应保持原值 */
+    queueKey: string;
+    /** 快速处理当前页的消息类型后缀：CAPTURE_CURRENT / CONVERT_CURRENT */
+    quickType: string;
+    /** 快速按钮的元素 id，默认 "captureCurrent"，可由消费项目覆盖 */
+    quickButtonId?: string;
+    texts: PopupTexts;
+    collectSettings(): Settings;
+    collectQuickSettings(): Settings;
+    /** 快速处理成功后的状态栏文案 */
+    quickResult(result: {
+        fileName: string;
+        warning?: string;
+    }): string;
+}
+
+declare function initExtension(config: ExtKitConfig): void;
+
+declare function initPopup(config: PopupConfig): void;
+
+interface Entitlement {
+    plan: string;
+    expiresAt: string;
+}
+interface Licensing {
+    activate(code: string): Promise<unknown>;
+    getEntitlement(): Promise<Entitlement | null>;
+    isPro(): Promise<boolean>;
+    clear(): Promise<void>;
+    purchaseUrl: string;
+}
+declare function createLicensing(product: string, brand: string, config: LicensingConfig): Licensing;
+
+declare function sanitize(value: string): string;
+declare function hostOf(url: string): string;
+declare function normalizeUrls(urls: unknown[]): string[];
+declare function sessionStamp(): string;
+declare function fileStamp(): string;
+declare function todayString(): string;
+declare function folderNameFor(urls: string[]): string;
+declare function urlBaseName(url: string, maxLength: number, includeQuery: boolean): string;
+declare function buildBatchFileName(folder: string, item: {
+    url: string;
+    index: number;
+}, extension: string): string;
+declare function buildQuickFileName(brand: string, quickFolder: string, pageUrl: string, extension: string): string;
+
+export { type CaptureContext, type CaptureOutput, type Entitlement, type ExtKitConfig, type ExtTexts, type Licensing, type LicensingConfig, type PopupConfig, type PopupTexts, type Settings, buildBatchFileName, buildQuickFileName, createLicensing, fileStamp, folderNameFor, hostOf, initExtension, initPopup, normalizeUrls, sanitize, sessionStamp, todayString, urlBaseName };