@sns-parse/core 0.1.0 → 0.3.0-alpha.1

package/lib/config.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 中立配置描述 DSL（core 定义，工具无关）。
+ *
+ * 各扩展包（@sns-parse/ext-*）与各平台包（@sns-parse/platform-*）以
+ * ConfigContribution 声明自己需要的配置项；core 聚合为完整清单；
+ * koishi 兼容层把清单翻译为 koishi Schema，CLI 兼容层翻译为默认配置/参数。
+ *
+ * core 与各碎片包都不依赖 koishi。
+ */
+export type ConfigFieldType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'union';
+export interface ConfigUnionValue {
+    value: string;
+    description?: string;
+}
+/** 一个配置字段的中立描述 */
+export interface ConfigField {
+    /** 字段键（对象内相对键；顶层为绝对键） */
+    key: string;
+    type: ConfigFieldType;
+    description?: string;
+    default?: any;
+    /** koishi 的 role：多行文本 / 密钥 */
+    role?: 'textarea' | 'secret';
+    hidden?: boolean;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** type='union' 的可选常量 */
+    values?: ConfigUnionValue[];
+    /** type='array' 且元素为标量时的元素类型 */
+    itemType?: ConfigFieldType;
+    /** type='array' 且元素为对象时的元素字段 */
+    itemFields?: ConfigField[];
+    /** type='object' 的子字段 */
+    fields?: ConfigField[];
+}
+/** 一组配置（通常对应 koishi 中的一个分组） */
+export interface ConfigContribution {
+    /** 分组标题 */
+    group: string;
+    description?: string;
+    fields: ConfigField[];
+}
+/** 类型辅助：声明即校验 */
+export declare function defineConfig(contribution: ConfigContribution): ConfigContribution;
+/**
+ * 聚合多组配置声明：同 group 合并字段（后者追加），保持首次出现顺序。
+ * 用于 core 汇总所有扩展与平台声明的配置。
+ */
+export declare function mergeConfigContributions(lists: ConfigContribution[][]): ConfigContribution[];

package/lib/config.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * 中立配置描述 DSL（core 定义，工具无关）。
+ *
+ * 各扩展包（@sns-parse/ext-*）与各平台包（@sns-parse/platform-*）以
+ * ConfigContribution 声明自己需要的配置项；core 聚合为完整清单；
+ * koishi 兼容层把清单翻译为 koishi Schema，CLI 兼容层翻译为默认配置/参数。
+ *
+ * core 与各碎片包都不依赖 koishi。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = defineConfig;
+exports.mergeConfigContributions = mergeConfigContributions;
+/** 类型辅助：声明即校验 */
+function defineConfig(contribution) {
+    return contribution;
+}
+/**
+ * 聚合多组配置声明：同 group 合并字段（后者追加），保持首次出现顺序。
+ * 用于 core 汇总所有扩展与平台声明的配置。
+ */
+function mergeConfigContributions(lists) {
+    const out = [];
+    const byGroup = new Map();
+    for (const list of lists) {
+        for (const c of list) {
+            const existing = byGroup.get(c.group);
+            if (existing)
+                existing.fields.push(...c.fields);
+            else {
+                const copy = { ...c, fields: [...c.fields] };
+                byGroup.set(c.group, copy);
+                out.push(copy);
+            }
+        }
+    }
+    return out;
+}

package/lib/index.d.ts

@@ -2,6 +2,7 @@
  * @sns-parse/core 公共出口。
  */
 export * from './types';
+export * from './config';
 export * from './logger';
 export * from './sender';
 export * from './extensions';

package/lib/index.js

@@ -18,6 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @sns-parse/core 公共出口。
  */
 __exportStar(require("./types"), exports);
+__exportStar(require("./config"), exports);
 __exportStar(require("./logger"), exports);
 __exportStar(require("./sender"), exports);
 __exportStar(require("./extensions"), exports);

package/lib/platform.d.ts

@@ -1,3 +1,4 @@
+import { type ConfigContribution } from './config';
 /**
  * 平台定义契约：每个平台的自描述单元，是「每平台一个包」的基础。
  *
@@ -18,6 +19,13 @@ export interface PlatformDefinition {
     };
     /** 是否默认优先专属 API（可被 config.platformDedicatedFirst 覆盖） */
     dedicatedFirst?: boolean;
+    /** 中文名（用于配置项描述与界面展示） */
+    label?: string;
     /** 解析失败时的平台特定引导提示 */
     hints?: string[];
 }
+/**
+ * 由平台定义聚合出「平台相关配置」（平台开关 / 专属 API 优先）。
+ * koishi / cli 兼容层据此动态生成配置，无需硬编码平台列表。
+ */
+export declare function platformConfigContributions(defs: PlatformDefinition[]): ConfigContribution[];

package/lib/platform.js

@@ -1,2 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.platformConfigContributions = platformConfigContributions;
+const config_1 = require("./config");
+/**
+ * 由平台定义聚合出「平台相关配置」（平台开关 / 专属 API 优先）。
+ * koishi / cli 兼容层据此动态生成配置，无需硬编码平台列表。
+ */
+function platformConfigContributions(defs) {
+    return [
+        (0, config_1.defineConfig)({
+            group: '平台开关',
+            fields: [
+                {
+                    key: 'platformEnabled', type: 'object', description: '各平台解析开关',
+                    fields: defs.map(d => ({ key: d.type, type: 'boolean', default: true, description: d.label || d.type })),
+                },
+            ],
+        }),
+        (0, config_1.defineConfig)({
+            group: 'API 与平台',
+            description: '优先使用专属 API',
+            fields: [
+                {
+                    key: 'platformDedicatedFirst', type: 'object', description: '优先使用专属 API',
+                    fields: defs.map(d => ({ key: d.type, type: 'boolean', default: d.dedicatedFirst ?? false, description: d.label || d.type })),
+                },
+            ],
+        }),
+    ];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sns-parse/core",
-  "version": "0.1.0",
+  "version": "0.3.0-alpha.1+upstream.1.6.7",
   "description": "sns-parse 核心契约与宿主抽象：类型、可注入日志、Host、发送层契约、平台定义",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",