sdd-mcp-server 1.0.0

package/dist/domain/i18n/index.d.ts

@@ -0,0 +1,286 @@
+export interface I18nService {
+    init(config: I18nConfig): Promise<void>;
+    t(key: string, options?: TranslationOptions): string;
+    changeLanguage(language: SupportedLanguage): Promise<void>;
+    getCurrentLanguage(): SupportedLanguage;
+    getSupportedLanguages(): SupportedLanguage[];
+    addResourceBundle(language: SupportedLanguage, namespace: string, resources: Record<string, unknown>): void;
+    loadNamespace(namespace: string): Promise<void>;
+    exists(key: string, language?: SupportedLanguage): boolean;
+}
+export interface I18nConfig {
+    readonly defaultLanguage: SupportedLanguage;
+    readonly fallbackLanguage: SupportedLanguage;
+    readonly supportedLanguages: SupportedLanguage[];
+    readonly autoDetect: boolean;
+    readonly resourcePath: string;
+    readonly namespaces: string[];
+    readonly interpolation: InterpolationConfig;
+    readonly detection: DetectionConfig;
+    readonly cache: CacheConfig;
+}
+export interface TranslationOptions {
+    readonly [key: string]: unknown;
+    readonly count?: number;
+    readonly context?: string;
+    readonly defaultValue?: string;
+    readonly lng?: SupportedLanguage;
+    readonly ns?: string | string[];
+}
+export interface InterpolationConfig {
+    readonly prefix: string;
+    readonly suffix: string;
+    readonly escapeValue: boolean;
+    readonly formatSeparator: string;
+    readonly format: (value: unknown, format: string, language: SupportedLanguage) => string;
+}
+export interface DetectionConfig {
+    readonly order: DetectionMethod[];
+    readonly caches: DetectionCacheMethod[];
+    readonly cookieName: string;
+    readonly sessionName: string;
+    readonly headerName: string;
+    readonly excludeCacheFor: SupportedLanguage[];
+}
+export interface CacheConfig {
+    readonly enabled: boolean;
+    readonly prefix: string;
+    readonly expirationTime: number;
+    readonly versions: Record<SupportedLanguage, string>;
+}
+export interface LocaleInfo {
+    readonly code: SupportedLanguage;
+    readonly name: string;
+    readonly nativeName: string;
+    readonly region: string;
+    readonly direction: TextDirection;
+    readonly pluralRules: PluralRule[];
+    readonly dateFormats: DateFormatPatterns;
+    readonly numberFormats: NumberFormatPatterns;
+    readonly currency: CurrencyInfo;
+    readonly timeZone: string;
+}
+export interface PluralRule {
+    readonly form: PluralForm;
+    readonly condition: string;
+    readonly examples: number[];
+}
+export interface DateFormatPatterns {
+    readonly short: string;
+    readonly medium: string;
+    readonly long: string;
+    readonly full: string;
+    readonly time: string;
+    readonly dateTime: string;
+}
+export interface NumberFormatPatterns {
+    readonly decimal: string;
+    readonly percent: string;
+    readonly currency: string;
+    readonly scientific: string;
+    readonly grouping: string;
+}
+export interface CurrencyInfo {
+    readonly code: string;
+    readonly symbol: string;
+    readonly name: string;
+    readonly decimalPlaces: number;
+}
+export interface TranslationResource {
+    readonly namespace: string;
+    readonly language: SupportedLanguage;
+    readonly version: string;
+    readonly keys: Record<string, TranslationEntry>;
+    readonly metadata: ResourceMetadata;
+}
+export interface TranslationEntry {
+    readonly value: string | Record<string, string>;
+    readonly description?: string;
+    readonly context?: string;
+    readonly plurals?: Record<PluralForm, string>;
+    readonly maxLength?: number;
+    readonly examples?: string[];
+}
+export interface ResourceMetadata {
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+    readonly translators: string[];
+    readonly reviewers: string[];
+    readonly status: TranslationStatus;
+    readonly completeness: number;
+}
+export interface PlatformAdapter {
+    detectLocale(): Promise<SupportedLanguage>;
+    getSystemInfo(): Promise<SystemInfo>;
+    formatPath(path: string): string;
+    getEnvironmentVariables(): Record<string, string>;
+    getPreferredLanguages(): Promise<SupportedLanguage[]>;
+}
+export interface SystemInfo {
+    readonly platform: Platform;
+    readonly arch: Architecture;
+    readonly osVersion: string;
+    readonly nodeVersion: string;
+    readonly timezone: string;
+    readonly locale: string;
+    readonly encoding: string;
+}
+export interface LanguagePack {
+    readonly language: SupportedLanguage;
+    readonly version: string;
+    readonly resources: TranslationResource[];
+    readonly templates: LocalizedTemplate[];
+    readonly formats: LocaleFormats;
+    readonly validators: LocaleValidator[];
+}
+export interface LocalizedTemplate {
+    readonly name: string;
+    readonly category: TemplateCategory;
+    readonly content: string;
+    readonly variables: LocalizedVariable[];
+}
+export interface LocalizedVariable {
+    readonly name: string;
+    readonly label: string;
+    readonly description: string;
+    readonly placeholder: string;
+    readonly validation: LocaleValidator[];
+}
+export interface LocaleFormats {
+    readonly date: DateFormatPatterns;
+    readonly number: NumberFormatPatterns;
+    readonly currency: CurrencyInfo;
+    readonly address: AddressFormat;
+    readonly phone: PhoneFormat;
+}
+export interface AddressFormat {
+    readonly pattern: string;
+    readonly components: AddressComponent[];
+    readonly postalCodePattern: string;
+}
+export interface PhoneFormat {
+    readonly pattern: string;
+    readonly countryCode: string;
+    readonly nationalPrefix: string;
+}
+export interface AddressComponent {
+    readonly name: string;
+    readonly required: boolean;
+    readonly maxLength: number;
+}
+export interface LocaleValidator {
+    readonly type: ValidationType;
+    readonly pattern?: string;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly message: string;
+}
+export declare enum SupportedLanguage {
+    ENGLISH = "en",
+    JAPANESE = "ja",
+    CHINESE_TRADITIONAL = "zh-TW",
+    CHINESE_SIMPLIFIED = "zh-CN",
+    KOREAN = "ko",
+    SPANISH = "es",
+    FRENCH = "fr",
+    GERMAN = "de",
+    PORTUGUESE = "pt",
+    RUSSIAN = "ru"
+}
+export declare enum DetectionMethod {
+    PATH = "path",
+    HEADER = "header",
+    COOKIE = "cookie",
+    SESSION = "session",
+    QUERY = "querystring",
+    SUBDOMAIN = "subdomain",
+    HTML_TAG = "htmlTag",
+    ENVIRONMENT = "environment"
+}
+export declare enum DetectionCacheMethod {
+    COOKIE = "cookie",
+    SESSION = "session",
+    LOCAL_STORAGE = "localStorage",
+    MEMORY = "memory"
+}
+export declare enum TextDirection {
+    LTR = "ltr",
+    RTL = "rtl"
+}
+export declare enum PluralForm {
+    ZERO = "zero",
+    ONE = "one",
+    TWO = "two",
+    FEW = "few",
+    MANY = "many",
+    OTHER = "other"
+}
+export declare enum TranslationStatus {
+    DRAFT = "draft",
+    IN_REVIEW = "in-review",
+    APPROVED = "approved",
+    PUBLISHED = "published",
+    DEPRECATED = "deprecated"
+}
+export declare enum Platform {
+    WINDOWS = "win32",
+    MACOS = "darwin",
+    LINUX = "linux",
+    FREEBSD = "freebsd",
+    OPENBSD = "openbsd",
+    SUNOS = "sunos",
+    AIX = "aix"
+}
+export declare enum Architecture {
+    X64 = "x64",
+    ARM64 = "arm64",
+    ARM = "arm",
+    IA32 = "ia32",
+    MIPS = "mips",
+    MIPSEL = "mipsel",
+    PPC = "ppc",
+    PPC64 = "ppc64",
+    S390 = "s390",
+    S390X = "s390x"
+}
+export declare enum TemplateCategory {
+    SDD = "sdd",
+    DOCUMENTATION = "documentation",
+    COMMUNICATION = "communication",
+    SYSTEM = "system"
+}
+export declare enum ValidationType {
+    PATTERN = "pattern",
+    LENGTH = "length",
+    NUMERIC = "numeric",
+    EMAIL = "email",
+    URL = "url",
+    DATE = "date",
+    PHONE = "phone",
+    POSTAL_CODE = "postalCode"
+}
+export interface I18nManagerPort {
+    initialize(config: I18nConfig): Promise<void>;
+    getLocaleInfo(language: SupportedLanguage): Promise<LocaleInfo>;
+    loadLanguagePack(language: SupportedLanguage): Promise<LanguagePack>;
+    getAvailableLanguages(): Promise<SupportedLanguage[]>;
+    validateTranslation(key: string, value: string, language: SupportedLanguage): Promise<ValidationResult>;
+    formatMessage(key: string, params: Record<string, unknown>, language?: SupportedLanguage): Promise<string>;
+}
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: ValidationError[];
+    readonly warnings: ValidationWarning[];
+    readonly suggestions: string[];
+}
+export interface ValidationError {
+    readonly type: ValidationType;
+    readonly message: string;
+    readonly field?: string;
+    readonly value?: unknown;
+}
+export interface ValidationWarning {
+    readonly type: string;
+    readonly message: string;
+    readonly suggestion: string;
+}

package/dist/domain/i18n/index.js

@@ -0,0 +1,97 @@
+// Domain models and interfaces for internationalization
+// Enums and types
+export var SupportedLanguage;
+(function (SupportedLanguage) {
+    SupportedLanguage["ENGLISH"] = "en";
+    SupportedLanguage["JAPANESE"] = "ja";
+    SupportedLanguage["CHINESE_TRADITIONAL"] = "zh-TW";
+    SupportedLanguage["CHINESE_SIMPLIFIED"] = "zh-CN";
+    SupportedLanguage["KOREAN"] = "ko";
+    SupportedLanguage["SPANISH"] = "es";
+    SupportedLanguage["FRENCH"] = "fr";
+    SupportedLanguage["GERMAN"] = "de";
+    SupportedLanguage["PORTUGUESE"] = "pt";
+    SupportedLanguage["RUSSIAN"] = "ru";
+})(SupportedLanguage || (SupportedLanguage = {}));
+export var DetectionMethod;
+(function (DetectionMethod) {
+    DetectionMethod["PATH"] = "path";
+    DetectionMethod["HEADER"] = "header";
+    DetectionMethod["COOKIE"] = "cookie";
+    DetectionMethod["SESSION"] = "session";
+    DetectionMethod["QUERY"] = "querystring";
+    DetectionMethod["SUBDOMAIN"] = "subdomain";
+    DetectionMethod["HTML_TAG"] = "htmlTag";
+    DetectionMethod["ENVIRONMENT"] = "environment";
+})(DetectionMethod || (DetectionMethod = {}));
+export var DetectionCacheMethod;
+(function (DetectionCacheMethod) {
+    DetectionCacheMethod["COOKIE"] = "cookie";
+    DetectionCacheMethod["SESSION"] = "session";
+    DetectionCacheMethod["LOCAL_STORAGE"] = "localStorage";
+    DetectionCacheMethod["MEMORY"] = "memory";
+})(DetectionCacheMethod || (DetectionCacheMethod = {}));
+export var TextDirection;
+(function (TextDirection) {
+    TextDirection["LTR"] = "ltr";
+    TextDirection["RTL"] = "rtl";
+})(TextDirection || (TextDirection = {}));
+export var PluralForm;
+(function (PluralForm) {
+    PluralForm["ZERO"] = "zero";
+    PluralForm["ONE"] = "one";
+    PluralForm["TWO"] = "two";
+    PluralForm["FEW"] = "few";
+    PluralForm["MANY"] = "many";
+    PluralForm["OTHER"] = "other";
+})(PluralForm || (PluralForm = {}));
+export var TranslationStatus;
+(function (TranslationStatus) {
+    TranslationStatus["DRAFT"] = "draft";
+    TranslationStatus["IN_REVIEW"] = "in-review";
+    TranslationStatus["APPROVED"] = "approved";
+    TranslationStatus["PUBLISHED"] = "published";
+    TranslationStatus["DEPRECATED"] = "deprecated";
+})(TranslationStatus || (TranslationStatus = {}));
+export var Platform;
+(function (Platform) {
+    Platform["WINDOWS"] = "win32";
+    Platform["MACOS"] = "darwin";
+    Platform["LINUX"] = "linux";
+    Platform["FREEBSD"] = "freebsd";
+    Platform["OPENBSD"] = "openbsd";
+    Platform["SUNOS"] = "sunos";
+    Platform["AIX"] = "aix";
+})(Platform || (Platform = {}));
+export var Architecture;
+(function (Architecture) {
+    Architecture["X64"] = "x64";
+    Architecture["ARM64"] = "arm64";
+    Architecture["ARM"] = "arm";
+    Architecture["IA32"] = "ia32";
+    Architecture["MIPS"] = "mips";
+    Architecture["MIPSEL"] = "mipsel";
+    Architecture["PPC"] = "ppc";
+    Architecture["PPC64"] = "ppc64";
+    Architecture["S390"] = "s390";
+    Architecture["S390X"] = "s390x";
+})(Architecture || (Architecture = {}));
+export var TemplateCategory;
+(function (TemplateCategory) {
+    TemplateCategory["SDD"] = "sdd";
+    TemplateCategory["DOCUMENTATION"] = "documentation";
+    TemplateCategory["COMMUNICATION"] = "communication";
+    TemplateCategory["SYSTEM"] = "system";
+})(TemplateCategory || (TemplateCategory = {}));
+export var ValidationType;
+(function (ValidationType) {
+    ValidationType["PATTERN"] = "pattern";
+    ValidationType["LENGTH"] = "length";
+    ValidationType["NUMERIC"] = "numeric";
+    ValidationType["EMAIL"] = "email";
+    ValidationType["URL"] = "url";
+    ValidationType["DATE"] = "date";
+    ValidationType["PHONE"] = "phone";
+    ValidationType["POSTAL_CODE"] = "postalCode";
+})(ValidationType || (ValidationType = {}));
+//# sourceMappingURL=index.js.map

package/dist/domain/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/i18n/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AA2MxD,kBAAkB;AAClB,MAAM,CAAN,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IAC3B,mCAAc,CAAA;IACd,oCAAe,CAAA;IACf,kDAA6B,CAAA;IAC7B,iDAA4B,CAAA;IAC5B,kCAAa,CAAA;IACb,mCAAc,CAAA;IACd,kCAAa,CAAA;IACb,kCAAa,CAAA;IACb,sCAAiB,CAAA;IACjB,mCAAc,CAAA;AAChB,CAAC,EAXW,iBAAiB,KAAjB,iBAAiB,QAW5B;AAED,MAAM,CAAN,IAAY,eASX;AATD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;IACrB,0CAAuB,CAAA;IACvB,uCAAoB,CAAA;IACpB,8CAA2B,CAAA;AAC7B,CAAC,EATW,eAAe,KAAf,eAAe,QAS1B;AAED,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,2CAAmB,CAAA;IACnB,sDAA8B,CAAA;IAC9B,yCAAiB,CAAA;AACnB,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,4BAAW,CAAA;AACb,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,yBAAW,CAAA;IACX,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,6BAAe,CAAA;AACjB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AAED,MAAM,CAAN,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,oCAAe,CAAA;IACf,4CAAuB,CAAA;IACvB,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IACvB,8CAAyB,CAAA;AAC3B,CAAC,EANW,iBAAiB,KAAjB,iBAAiB,QAM5B;AAED,MAAM,CAAN,IAAY,QAQX;AARD,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,4BAAgB,CAAA;IAChB,2BAAe,CAAA;IACf,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,2BAAe,CAAA;IACf,uBAAW,CAAA;AACb,CAAC,EARW,QAAQ,KAAR,QAAQ,QAQnB;AAED,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,+BAAe,CAAA;IACf,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,2BAAW,CAAA;IACX,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,+BAAe,CAAA;AACjB,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,mDAA+B,CAAA;IAC/B,mDAA+B,CAAA;IAC/B,qCAAiB,CAAA;AACnB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAED,MAAM,CAAN,IAAY,cASX;AATD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;IACnB,iCAAe,CAAA;IACf,6BAAW,CAAA;IACX,+BAAa,CAAA;IACb,iCAAe,CAAA;IACf,4CAA0B,CAAA;AAC5B,CAAC,EATW,cAAc,KAAd,cAAc,QASzB"}