autosnippet 3.2.9 → 3.2.11

package/dist/lib/shared/DimensionCopyRegistry.js

@@ -0,0 +1,402 @@
+/**
+ * @module DimensionCopyRegistry
+ * @description 维度文案注册表 - 按编程语言提供差异化的 label 和 guide
+ *
+ * Bootstrap 的 baseDimensions 中每个维度的 label/guide 不再硬编码为 ObjC/Swift 视角，
+ * 而是通过此注册表按项目主语言动态选择最匹配的文案。
+ *
+ * ---
+ * 使用方式：
+ *   import { DimensionCopy } from '../shared/DimensionCopyRegistry.js';
+ *   const copy = DimensionCopy.get('code-pattern', 'python');
+ *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
+ */
+// ═══════════════════════════════════════════════════════════
+// 语言族定义
+// ═══════════════════════════════════════════════════════════
+/**
+ * 将具体语言归入语言族（用于文案选择 fallback）
+ * @param {string} lang
+ * @returns {string} 语言族 ID
+ */
+function _langFamily(lang) {
+    switch (lang) {
+        case 'swift':
+        case 'objectivec':
+            return 'apple';
+        case 'typescript':
+        case 'javascript':
+            return 'js';
+        case 'java':
+        case 'kotlin':
+            return 'jvm';
+        default:
+            return lang; // python, go, rust, ruby 等本身就是族
+    }
+}
+// ═══════════════════════════════════════════════════════════
+// 通用维度文案 — 各语言差异化
+// ═══════════════════════════════════════════════════════════
+/**
+ * 维度文案格式: { label: string, guide: string }
+ * - `_default` 为兜底
+ * - 按语言族 key (apple/js/jvm/python/go/rust/ruby) 覆盖
+ *
+ * 注意：条件维度（objc-deep-scan 等）不需要多语言文案，因为它们本身就是特定语言才激活
+ */
+const COPY_REGISTRY = {
+    // ── ① 代码规范 ──────────────────────────────────────
+    'code-standard': {
+        _default: {
+            label: '代码规范',
+            guide: '命名约定、注释风格、文件组织规范、代码格式化标准',
+        },
+        apple: {
+            label: '代码规范',
+            guide: '命名约定（类名前缀/方法签名风格/API 命名）、注释风格（语言/格式/MARK 分段）、文件组织规范',
+        },
+        js: {
+            label: '代码规范',
+            guide: '命名约定（camelCase/PascalCase/UPPER_CASE）、ESLint/Prettier 风格、文件/目录命名、注释与 JSDoc 规范',
+        },
+        jvm: {
+            label: '代码规范',
+            guide: '命名约定（类名/方法名/常量）、包结构组织、Javadoc/KDoc 注释规范、代码格式化（Checkstyle/ktlint）',
+        },
+        python: {
+            label: '代码规范',
+            guide: '命名约定（PEP 8 snake_case/PascalCase）、docstring 风格（Google/NumPy/Sphinx）、import 排序、Black/Ruff 格式化',
+        },
+        go: {
+            label: '代码规范',
+            guide: '命名约定（exported/unexported、MixedCaps）、gofmt 格式化、注释规范（godoc）、包组织',
+        },
+        dart: {
+            label: '代码规范',
+            guide: '命名约定（lowerCamelCase/UpperCamelCase/snake_case 文件名）、dart format 格式化、/// 文档注释、library 组织、effective dart 规范',
+        },
+        rust: {
+            label: '代码规范',
+            guide: '命名约定（snake_case/CamelCase）、rustfmt 格式化、/// 文档注释、模块组织（mod.rs/lib.rs）',
+        },
+    },
+    // ── ② 设计模式与代码惯例 ─────────────────────────────
+    'code-pattern': {
+        _default: {
+            label: '设计模式与代码惯例',
+            guide: '单例/工厂/观察者/策略/Builder 等设计模式在项目中的使用方式',
+        },
+        apple: {
+            label: '设计模式与代码惯例',
+            guide: '单例/委托/Category·Extension/工厂/Builder/观察者/Coordinator 模式、继承关系',
+        },
+        js: {
+            label: '设计模式与代码惯例',
+            guide: '模块模式/工厂函数/观察者(EventEmitter)/中间件/高阶函数/组合模式、框架特有 Hooks/Composition 模式',
+        },
+        jvm: {
+            label: '设计模式与代码惯例',
+            guide: 'Builder/Factory/Singleton/Strategy/Observer 模式、DI 容器注入模式、Repository/Service 分层惯例',
+        },
+        python: {
+            label: '设计模式与代码惯例',
+            guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式、dataclass/Protocol 接口惯例',
+        },
+        go: {
+            label: '设计模式与代码惯例',
+            guide: 'functional options/table-driven tests/interface 消费侧定义/errgroup 并发/middleware 链/构造器函数',
+        },
+        dart: {
+            label: '设计模式与代码惯例',
+            guide: 'Factory/Singleton/Repository/Builder 模式、Widget 组合模式、Mixin 复用、Extension 扩展、Freezed 不可变数据类、Provider/Riverpod 依赖注入',
+        },
+        rust: {
+            label: '设计模式与代码惯例',
+            guide: 'Builder(owned self)/NewType/类型状态/From·Into 转换/Iterator 链/enum 代数类型/derive 宏',
+        },
+    },
+    // ── ③ 架构模式 ──────────────────────────────────────
+    architecture: {
+        _default: {
+            label: '架构模式',
+            guide: '分层架构、模块职责与边界、依赖图、导入约束规则',
+        },
+        apple: {
+            label: '架构模式',
+            guide: '分层架构（MVVM/VIPER/TCA）、Package/Target 模块边界、依赖图、import 约束规则',
+        },
+        js: {
+            label: '架构模式',
+            guide: '分层架构（MVC/MVVM/Hexagonal）、monorepo/package 划分、barrel export 边界、循环依赖检测',
+        },
+        jvm: {
+            label: '架构模式',
+            guide: '分层架构（Controller→Service→Repository）、模块划分（multi-module/micro-service）、DI 容器组织、依赖反转',
+        },
+        python: {
+            label: '架构模式',
+            guide: '分层架构（Router→Service→Repository）、包结构（src layout/flat layout）、依赖注入、接口隔离',
+        },
+        go: {
+            label: '架构模式',
+            guide: '分层架构（Handler→Service→Repository）、internal 包隔离、接口在消费侧定义、依赖注入（wire/fx）',
+        },
+        dart: {
+            label: '架构模式',
+            guide: '分层架构（Presentation→Domain→Data）、Clean Architecture/MVVM、Package 模块化、Melos monorepo、barrel export 边界、依赖注入（get_it/injectable）',
+        },
+        rust: {
+            label: '架构模式',
+            guide: '分层架构、Workspace/crate 边界、pub/pub(crate) 可见性、trait object 抽象层',
+        },
+    },
+    // ── ④ 最佳实践 ──────────────────────────────────────
+    'best-practice': {
+        _default: {
+            label: '最佳实践',
+            guide: '错误处理、并发安全、资源管理、日志规范、测试模式',
+        },
+        apple: {
+            label: '最佳实践',
+            guide: '错误处理、并发安全（Swift Concurrency/GCD）、内存管理（ARC/weak/unowned）、日志规范、XCTest 模式',
+        },
+        js: {
+            label: '最佳实践',
+            guide: '错误处理（try-catch/Error 边界）、异步安全（Promise/async-await）、内存泄漏检测、日志规范、Jest/Vitest 测试',
+        },
+        jvm: {
+            label: '最佳实践',
+            guide: '错误处理（checked/unchecked exception）、并发安全（synchronized/虚拟线程/协程）、连接池管理、日志（SLF4J）、JUnit 测试',
+        },
+        python: {
+            label: '最佳实践',
+            guide: '错误处理（except Exception/自定义异常）、并发（asyncio/threading/multiprocessing）、资源管理（with 语句）、日志（logging）、pytest 测试',
+        },
+        go: {
+            label: '最佳实践',
+            guide: '错误处理（error interface/wrapped errors）、并发安全（goroutine/channel/mutex）、defer 资源释放、结构化日志（slog）、table-driven tests',
+        },
+        dart: {
+            label: '最佳实践',
+            guide: '错误处理（try-catch/自定义 Exception）、异步安全（async-await/Stream/Completer）、内存管理（dispose/mounted 检查）、日志规范（logger 替代 print）、Widget 测试/集成测试/Golden 测试',
+        },
+        rust: {
+            label: '最佳实践',
+            guide: '错误处理（Result/? 操作符/thiserror）、并发安全（Send+Sync/Arc/Mutex）、生命周期管理、日志（tracing）、#[test] 模式',
+        },
+    },
+    // ── ⑤ 事件与数据流 ─────────────────────────────────
+    'event-and-data-flow': {
+        _default: {
+            label: '事件与数据流',
+            guide: '事件传播机制、状态管理模式、数据流向追踪',
+        },
+        apple: {
+            label: '事件与数据流',
+            guide: '事件传播（Delegate/Notification/Block·Closure/Target-Action）、数据状态管理（KVO/属性观察/Combine/SwiftUI State）',
+        },
+        js: {
+            label: '事件与数据流',
+            guide: '事件传播（EventEmitter/DOM Events/Custom Events）、状态管理（Redux/Vuex/Pinia/Zustand/Context）、响应式流（RxJS/Observable）',
+        },
+        jvm: {
+            label: '事件与数据流',
+            guide: '事件传播（Spring Events/LiveData/StateFlow/EventBus）、状态管理（ViewModel/Repository Cache）、消息队列（Kafka/RabbitMQ）',
+        },
+        python: {
+            label: '事件与数据流',
+            guide: '事件传播（Signal/Slot/Callback/asyncio Event）、状态管理（Pydantic Model/dataclass）、消息队列（Celery/Redis Pub-Sub）',
+        },
+        go: {
+            label: '事件与数据流',
+            guide: '事件传播（channel/context）、select 多路复用、fan-out/fan-in 模式、NATS/Redis Pub-Sub',
+        },
+        dart: {
+            label: '事件与数据流',
+            guide: '事件传播（Stream/StreamController/BroadcastStream）、状态管理（BLoC/Cubit/Provider/Riverpod/GetX/ValueNotifier）、响应式流（RxDart/StreamTransformer）、InheritedWidget 数据传递',
+        },
+        rust: {
+            label: '事件与数据流',
+            guide: '事件传播（tokio channel/crossbeam-channel）、Stream trait、Actor 模式（Actix）、状态管理（Arc<RwLock<T>>）',
+        },
+    },
+    // ── ⑥ 项目特征 ──────────────────────────────────────
+    'project-profile': {
+        _default: {
+            label: '项目特征',
+            guide: '技术栈、目录结构、三方依赖枚举与用途、基础设施服务注册表',
+        },
+        apple: {
+            label: '项目特征',
+            guide: '技术栈、目录结构、三方依赖枚举与用途、Extension/Category 分类聚合、自定义基类层级与全局定义（宏/typealias/PCH）、系统事件 hook 与生命周期入口、基础设施服务注册表、Runtime 与语言互操作',
+        },
+        js: {
+            label: '项目特征',
+            guide: '技术栈（框架/构建工具/包管理器）、目录结构、三方依赖枚举与用途、monorepo 配置、环境变量与配置注入、CI/CD 管线',
+        },
+        jvm: {
+            label: '项目特征',
+            guide: '技术栈（Spring/Android/Ktor）、module 结构、三方依赖枚举与用途、构建配置（Gradle/Maven）、Profile 环境管理、基础设施服务',
+        },
+        python: {
+            label: '项目特征',
+            guide: '技术栈（Django/FastAPI/Flask）、包结构、三方依赖枚举与用途、pyproject.toml/setup.cfg 配置、虚拟环境管理',
+        },
+        go: {
+            label: '项目特征',
+            guide: '技术栈、module 结构、go.mod 依赖枚举与用途、internal 包组织、build tags、Makefile 构建',
+        },
+        dart: {
+            label: '项目特征',
+            guide: '技术栈（Flutter/Dart Server/CLI）、目录结构（lib/src 分层）、pubspec.yaml 依赖枚举与用途、平台通道（MethodChannel/FFI）、Flavors/多环境配置',
+        },
+        rust: {
+            label: '项目特征',
+            guide: '技术栈、Workspace/crate 结构、Cargo.toml 依赖枚举与用途、feature flags、#[cfg] 条件编译',
+        },
+    },
+    // ── ⑦ Agent 开发注意事项 ─────────────────────────────
+    'agent-guidelines': {
+        _default: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、并发安全、资源管理、已废弃 API 标记、架构约束注释、TODO/FIXME',
+        },
+        apple: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名强制、线程安全、内存约束、已废弃 API 标记、架构约束注释、TODO/FIXME',
+        },
+        js: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、类型安全（strict/no-any）、异步错误处理、已废弃 API 标记、ESLint 配置遵循',
+        },
+        jvm: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、线程安全、@Deprecated 标记、架构约束注释、Nullable 标注',
+        },
+        python: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定（PEP 8）、type hints 覆盖、已废弃 API 标记（DeprecationWarning）、docstring 覆盖',
+        },
+        go: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、error 必须处理、goroutine 泄漏防护、Deprecated 注释、go vet 通过',
+        },
+        dart: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循（Effective Dart）、类型安全（避免 dynamic）、Widget 生命周期管理（dispose/mounted）、dart analyze 通过、避免 ! 空断言',
+        },
+        rust: {
+            label: 'Agent 开发注意事项',
+            guide: '三大核心原则（严谨性/深度特征挖掘/完整性）、命名约定遵循、unsafe 最小化、clippy lint 通过、#[deprecated] 标记、文档注释覆盖',
+        },
+    },
+};
+// ═══════════════════════════════════════════════════════════
+// DimensionCopy — 文案查询服务
+// ═══════════════════════════════════════════════════════════
+export class DimensionCopy {
+    /**
+     * 获取指定维度在指定语言下的文案
+     * @param {string} dimId   维度 ID (如 'code-standard')
+     * @param {string} lang    主语言 ID (如 'python', 'typescript')
+     * @returns {{ label: string, guide: string } | null}
+     */
+    static get(dimId, lang) {
+        const entry = COPY_REGISTRY[dimId];
+        if (!entry) {
+            return null;
+        }
+        const family = _langFamily(lang);
+        return entry[family] || entry[lang] || entry._default || null;
+    }
+    /**
+     * 批量为维度数组注入语言差异化文案（单语言版本）
+     * 会直接修改维度对象的 label 和 guide 字段
+     * @param {Array<{ id: string, label: string, guide: string }>} dimensions
+     * @param {string} lang 主语言
+     * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
+     */
+    static apply(dimensions, lang) {
+        for (const dim of dimensions) {
+            const copy = DimensionCopy.get(dim.id, lang);
+            if (copy) {
+                dim.label = copy.label;
+                dim.guide = copy.guide;
+            }
+        }
+        return dimensions;
+    }
+    /**
+     * 多语言版本 — 合并主语言 + 次要语言的 guide 文案
+     *
+     * 策略:
+     *   - label 使用主语言的 label（各语言族 label 基本一致）
+     *   - guide 以主语言为主体，追加次要语言的差异化要点
+     *   - 如果主语言和次要语言属于同一语言族，跳过（避免重复）
+     *
+     * @param {Array<{ id: string, label: string, guide: string }>} dimensions
+     * @param {string} primary 主语言 ID
+     * @param {string[]} secondary 次要语言 ID 列表
+     * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
+     */
+    static applyMulti(dimensions, primary, secondary = []) {
+        if (!secondary || secondary.length === 0) {
+            return DimensionCopy.apply(dimensions, primary);
+        }
+        const primaryFamily = _langFamily(primary);
+        // 过滤掉与主语言同族的次要语言（如 swift + objectivec 同属 apple）
+        const effectiveSecondary = secondary.filter((lang) => _langFamily(lang) !== primaryFamily);
+        for (const dim of dimensions) {
+            const primaryCopy = DimensionCopy.get(dim.id, primary);
+            if (!primaryCopy) {
+                continue;
+            }
+            dim.label = primaryCopy.label;
+            if (effectiveSecondary.length === 0) {
+                dim.guide = primaryCopy.guide;
+                continue;
+            }
+            // 收集次要语言的差异化 guide 片段
+            const secondaryGuides = [];
+            const seenFamilies = new Set([primaryFamily]);
+            for (const lang of effectiveSecondary) {
+                const fam = _langFamily(lang);
+                if (seenFamilies.has(fam)) {
+                    continue;
+                } // 同族去重
+                seenFamilies.add(fam);
+                const copy = DimensionCopy.get(dim.id, lang);
+                if (copy && copy.guide !== primaryCopy.guide) {
+                    const displayName = lang.charAt(0).toUpperCase() + lang.slice(1);
+                    secondaryGuides.push(`[${displayName}] ${copy.guide}`);
+                }
+            }
+            dim.guide =
+                secondaryGuides.length > 0
+                    ? `${primaryCopy.guide}\n${secondaryGuides.join('\n')}`
+                    : primaryCopy.guide;
+        }
+        return dimensions;
+    }
+    /**
+     * 获取所有已有文案的维度 ID 列表
+     * @returns {string[]}
+     */
+    static registeredDimIds() {
+        return Object.keys(COPY_REGISTRY);
+    }
+    /**
+     * 获取某维度所有可用语言族
+     * @param {string} dimId
+     * @returns {string[]}
+     */
+    static availableFamilies(dimId) {
+        const entry = COPY_REGISTRY[dimId];
+        if (!entry) {
+            return [];
+        }
+        return Object.keys(entry).filter((k) => k !== '_default');
+    }
+}
+export default DimensionCopy;
+//# sourceMappingURL=DimensionCopyRegistry.js.map

package/dist/lib/shared/DimensionCopyRegistry.js.map

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

package/dist/lib/shared/FieldSpec.d.ts

@@ -0,0 +1,169 @@
+/**
+ * FieldSpec.js — V3 知识条目字段规范（唯一权威来源）
+ *
+ * 字段分级:
+ *   REQUIRED  — 缺少则立即拒绝（19 个顶层字段 + 4 个嵌套字段）
+ *   EXPECTED  — 缺少则 warning + suggestions，不阻塞入库
+ *   OPTIONAL  — 缺少不报任何问题
+ *
+ * 判决依据: 从 6 条交付管线 (Channel A/B/F, Search, Guard, Quality) 反推，
+ * 以「缺少时的实际损害」为唯一标准。
+ *
+ * 消费方:
+ *   - UnifiedValidator.js       → 字段完整性检查
+ *   - dimension-text.js         → SUBMISSION_SCHEMA / REQUIRED_FIELDS_DESCRIPTION
+ *   - bootstrap-producer.js      → STYLE_GUIDE 字段列表
+ *   - MissionBriefingBuilder.js → submissionSpec 字段描述
+ *   - lifecycle.js              → JSON Schema required 数组
+ *   - consolidated.js           → 前置校验
+ *
+ * @module shared/FieldSpec
+ */
+export declare const FieldLevel: Readonly<{
+    REQUIRED: "required";
+    EXPECTED: "expected";
+    OPTIONAL: "optional";
+}>;
+/**
+ * @typedef {object} FieldDef
+ * @property {string}  name              字段名（支持点号嵌套: 'content.markdown'）
+ * @property {string}  level             - 'required' | 'expected' | 'optional'
+ * @property {string}  rule              人类友好的填写规则
+ * @property {string}  [pipeline]        下游管线消费说明
+ * @property {string}  [type]            - 'string' | 'object' | 'array' | 'number'
+ * @property {boolean} [systemInjected]  - true = 内部 Agent 路径由系统注入，AI 不必填
+ * @property {*}       [defaultValue]    默认值（用于 save_document 等特殊路径）
+ */
+/** @type {FieldDef[]} */
+export declare const V3_FIELD_SPEC: ({
+    name: string;
+    level: "required";
+    type: string;
+    rule: string;
+    pipeline: string;
+    systemInjected?: undefined;
+} | {
+    name: string;
+    level: "required";
+    type: string;
+    rule: string;
+    pipeline: string;
+    systemInjected: boolean;
+} | {
+    name: string;
+    level: "expected";
+    type: string;
+    rule: string;
+    pipeline: string;
+    systemInjected?: undefined;
+} | {
+    name: string;
+    level: "optional";
+    type: string;
+    rule: string;
+    pipeline?: undefined;
+    systemInjected?: undefined;
+})[];
+export declare const STANDARD_CATEGORIES: string[];
+/** category 白名单 — Bootstrap 维度展示分组 + 特殊流程中的合法 category */
+export declare const WHITELISTED_CATEGORIES: string[];
+export declare const VALID_KINDS: string[];
+export declare const VALID_TOPIC_HINTS: string[];
+/** 获取所有 REQUIRED 级别的顶层字段名 */
+export declare function getRequiredFieldNames(): string[];
+/** 获取所有 REQUIRED 级别的字段名（含嵌套） */
+export declare function getAllRequiredFieldNames(): string[];
+/** 获取 EXPECTED 级别字段名 */
+export declare function getExpectedFieldNames(): string[];
+/** 获取 AI 在外部路径必须提供的字段（= REQUIRED 全集，因无系统注入） */
+export declare function getExternalAgentRequiredFields(): string[];
+/** 获取 AI 在内部路径必须提供的字段（排除系统注入的 language/category/knowledgeType） */
+export declare function getInternalAgentRequiredFields(): string[];
+/** 获取系统注入的字段名列表 */
+export declare function getSystemInjectedFields(): string[];
+/**
+ * 生成人类友好的字段说明列表（供拒绝反馈使用）
+ * @returns {string[]}
+ */
+export declare function getRequiredFieldsDescription(): string[];
+/**
+ * 根据字段名获取规范定义
+ * @param {string} name
+ * @returns {FieldDef|undefined}
+ */
+export declare function getFieldDef(name: string): {
+    name: string;
+    level: "required";
+    type: string;
+    rule: string;
+    pipeline: string;
+    systemInjected?: undefined;
+} | {
+    name: string;
+    level: "required";
+    type: string;
+    rule: string;
+    pipeline: string;
+    systemInjected: boolean;
+} | {
+    name: string;
+    level: "expected";
+    type: string;
+    rule: string;
+    pipeline: string;
+    systemInjected?: undefined;
+} | {
+    name: string;
+    level: "optional";
+    type: string;
+    rule: string;
+    pipeline?: undefined;
+    systemInjected?: undefined;
+} | undefined;
+/**
+ * 生成 Cursor 交付字段描述对象（供 MissionBriefingBuilder.submissionSpec.cursorFields）
+ *
+ * 从 V3_FIELD_SPEC 中提取 trigger/kind/doClause/dontClause/whenClause/coreCode 的 rule，
+ * 并标记 REQUIRED 级别为【必填】前缀。
+ *
+ * @returns {Record<string, string>}
+ */
+export declare function getCursorDeliverySpec(): Record<string, any>;
+/**
+ * 按 level 分组返回字段
+ * @returns {{ required: FieldDef[], expected: FieldDef[], optional: FieldDef[] }}
+ */
+export declare function getFieldsByLevel(): {
+    required: ({
+        name: string;
+        level: "required";
+        type: string;
+        rule: string;
+        pipeline: string;
+        systemInjected?: undefined;
+    } | {
+        name: string;
+        level: "required";
+        type: string;
+        rule: string;
+        pipeline: string;
+        systemInjected: boolean;
+    })[];
+    expected: {
+        name: string;
+        level: "expected";
+        type: string;
+        rule: string;
+        pipeline: string;
+        systemInjected?: undefined;
+    }[];
+    optional: {
+        name: string;
+        level: "optional";
+        type: string;
+        rule: string;
+        pipeline?: undefined;
+        systemInjected?: undefined;
+    }[];
+};
+//# sourceMappingURL=FieldSpec.d.ts.map

package/dist/lib/shared/FieldSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldSpec.d.ts","sourceRoot":"","sources":["../../../lib/shared/FieldSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,eAAO,MAAM,UAAU;;;;EAIrB,CAAC;AAIH;;;;;;;;;GASG;AAEH,yBAAyB;AACzB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyLzB,CAAC;AAaF,eAAO,MAAM,mBAAmB,UAS/B,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,UAqBlC,CAAC;AAEF,eAAO,MAAM,WAAW,UAA8B,CAAC;AAEvD,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAI7F,6BAA6B;AAC7B,wBAAgB,qBAAqB,aAIpC;AAED,gCAAgC;AAChC,wBAAgB,wBAAwB,aAEvC;AAED,wBAAwB;AACxB,wBAAgB,qBAAqB,aAEpC;AAED,+CAA+C;AAC/C,wBAAgB,8BAA8B,aAE7C;AAED,kEAAkE;AAClE,wBAAgB,8BAA8B,aAI7C;AAED,mBAAmB;AACnB,wBAAgB,uBAAuB,aAEtC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,aAO3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,wBAkBpC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B"}