@salesforce/vscode-i18n 65.5.0

package/LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright (c) 2025, Salesforce.com, inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this
+list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+* Neither the name of Salesforce.com nor the names of its contributors may be
+used to endorse or promote products derived from this software without specific
+prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,120 @@
+# @salesforce/vscode-i18n
+
+Internationalization (i18n) library for Salesforce VS Code extensions.
+
+## Overview
+
+This package provides a comprehensive type-safe localization system for VS Code extensions, with automatic type inference for message arguments based on printf-style format specifiers.
+
+## Installation
+
+```bash
+npm install @salesforce/vscode-i18n
+```
+
+## Features
+
+- **Type-safe message localization**: Compile-time validation of message arguments
+- **Multiple locale support**: Built-in support for English (en) and Japanese (ja)
+- **Format specifier support**: Full support for Node.js `util.format()` specifiers (`%s`, `%d`, `%i`, `%f`, `%j`, `%%`)
+- **Message bundle management**: Advanced localization service for managing multiple message bundles
+- **Zero runtime cost**: Type safety with no performance impact
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { LocalizationService, MessageArgs } from '@salesforce/vscode-i18n';
+
+// Define your message bundles
+const enMessages = {
+  greeting: 'Hello %s',
+  userStats: 'User %s has %d points'
+} as const;
+
+const jaMessages = {
+  greeting: 'こんにちは %s',
+  userStats: 'ユーザー %s は %d ポイントを持っています'
+} as const;
+
+// Create a localization service instance
+const service = LocalizationService.getInstance('my-extension');
+
+// Register message bundles
+service.messageBundleManager.registerMessageBundle('my-extension', {
+  messages: enMessages,
+  type: 'base'
+});
+
+service.messageBundleManager.registerMessageBundle('my-extension', {
+  messages: { ...jaMessages, _locale: 'ja' },
+  type: 'locale',
+  locale: 'ja'
+});
+
+// Use type-safe localization
+type MessageKey = keyof typeof enMessages;
+const nls = {
+  localize: <K extends MessageKey>(key: K, ...args: MessageArgs<K, typeof enMessages>): string =>
+    service.localize(key, ...args)
+};
+
+// Type-safe calls with IntelliSense support
+nls.localize('greeting', 'World'); // ✅ string
+nls.localize('userStats', 'John', 150); // ✅ string, number
+// nls.localize('greeting', 123); // ❌ Error: Expected string
+```
+
+### Type Safety
+
+The package includes `MessageArgs` type that automatically infers argument types from format specifiers:
+
+```typescript
+import { MessageArgs } from '@salesforce/vscode-i18n';
+
+const messages = {
+  simple: 'Task %s completed',
+  complex: 'User %s has %d points and data %j'
+} as const;
+
+type SimpleArgs = MessageArgs<'simple', typeof messages>; // [string]
+type ComplexArgs = MessageArgs<'complex', typeof messages>; // [string, number, any]
+```
+
+## API
+
+### LocalizationService
+
+Singleton service for managing message bundles and localization.
+
+```typescript
+const service = LocalizationService.getInstance(instanceName: string);
+```
+
+### MessageBundleManager
+
+Manages message bundles for different locales.
+
+```typescript
+service.messageBundleManager.registerMessageBundle(instanceName, {
+  messages: messageBundle,
+  type: 'base' | 'locale',
+  locale?: Locale
+});
+```
+
+### Constants
+
+- `DEFAULT_LOCALE`: The default locale ('en')
+- `LOCALE_JA`: Japanese locale constant ('ja')
+- `MISSING_LABEL_MSG`: Error message for missing labels
+
+## License
+
+BSD-3-Clause
+
+## Support
+
+For issues or questions, please file an issue at:
+https://github.com/forcedotcom/salesforcedx-vscode/issues

package/out/src/constants.d.ts

@@ -0,0 +1,5 @@
+import { Locale } from './types/localization/config';
+export declare const DEFAULT_LOCALE: Locale;
+export declare const LOCALE_JA: Locale;
+export declare const MISSING_LABEL_MSG = "!!! MISSING LABEL !!!";
+//# sourceMappingURL=constants.d.ts.map

package/out/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,MAAa,CAAC;AAC3C,eAAO,MAAM,SAAS,EAAE,MAAa,CAAC;AACtC,eAAO,MAAM,iBAAiB,0BAA0B,CAAC"}

package/out/src/constants.js

@@ -0,0 +1,13 @@
+"use strict";
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISSING_LABEL_MSG = exports.LOCALE_JA = exports.DEFAULT_LOCALE = void 0;
+exports.DEFAULT_LOCALE = 'en';
+exports.LOCALE_JA = 'ja';
+exports.MISSING_LABEL_MSG = '!!! MISSING LABEL !!!';
+//# sourceMappingURL=constants.js.map

package/out/src/i18n/advancedLocalization.d.ts

@@ -0,0 +1,37 @@
+import { AdvancedMessageBundle } from '../types/localization/advancedTypes';
+import { Config, Locale } from '../types/localization/config';
+import { Localization } from './localization';
+import { Message } from './message';
+/** export only for test */
+export declare class LocalizationConfig {
+    private static instance;
+    private constructor();
+    static getInstance(): LocalizationConfig;
+    isLocaleSupported(locale: unknown): boolean;
+    getDefaultLocale(): Locale;
+}
+/** exported only for test */
+export declare class MessageBundleManager {
+    private static instances;
+    private baseMessages;
+    private localeMessages;
+    private messageBundles;
+    private constructor();
+    static getInstance(instanceName: string): MessageBundleManager;
+    registerMessageBundle(instanceName: string, bundle: AdvancedMessageBundle): void;
+    private rebuildMessages;
+    private isValidLocale;
+    loadMessageBundle(config?: Config): Message;
+}
+export declare class LocalizationService {
+    static instances: Map<string, LocalizationService>;
+    private _nls;
+    readonly messageBundleManager: MessageBundleManager;
+    private readonly instanceName;
+    private constructor();
+    static getInstance(instanceName: string): LocalizationService;
+    get nls(): Localization;
+    localize<K extends string>(key: K, ...args: any[]): string;
+    refreshLocalization(): void;
+}
+//# sourceMappingURL=advancedLocalization.d.ts.map

package/out/src/i18n/advancedLocalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedLocalization.d.ts","sourceRoot":"","sources":["../../../src/i18n/advancedLocalization.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,2BAA2B;AAC3B,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,OAAO;WAEO,WAAW,IAAI,kBAAkB;IAKxC,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAI3C,gBAAgB,IAAI,MAAM;CAGlC;AAED,6BAA6B;AAC7B,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2C;IACnE,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,cAAc,CAA8C;IAEpE,OAAO;WAEO,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,oBAAoB;IAU9D,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAgBvF,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,aAAa;IAOd,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;CAenD;AAED,qBAAa,mBAAmB;IAC9B,OAAc,SAAS,mCAA0C;IACjE,OAAO,CAAC,IAAI,CAA6B;IACzC,SAAgB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO;WAKO,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB;IAUpE,IAAW,GAAG,IAAI,YAAY,CAc7B;IAEM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM;IAK1D,mBAAmB,IAAI,IAAI;CAGnC"}

package/out/src/i18n/advancedLocalization.js

@@ -0,0 +1,149 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalizationService = exports.MessageBundleManager = exports.LocalizationConfig = void 0;
+const constants_1 = require("../constants");
+const localization_1 = require("./localization");
+const message_1 = require("./message");
+/* eslint-disable @typescript-eslint/consistent-type-assertions */
+const SUPPORTED_LOCALES = [constants_1.DEFAULT_LOCALE, constants_1.LOCALE_JA];
+/**
+ * Type guard function to check if a value is a valid Locale
+ * @param value - The value to check
+ * @returns true if the value is a valid Locale, false otherwise
+ */
+const isLocale = (value) => {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return SUPPORTED_LOCALES.includes(value);
+};
+/** export only for test */
+class LocalizationConfig {
+    static instance;
+    constructor() { }
+    static getInstance() {
+        LocalizationConfig.instance ??= new LocalizationConfig();
+        return LocalizationConfig.instance;
+    }
+    isLocaleSupported(locale) {
+        return isLocale(locale);
+    }
+    getDefaultLocale() {
+        return constants_1.DEFAULT_LOCALE;
+    }
+}
+exports.LocalizationConfig = LocalizationConfig;
+/** exported only for test */
+class MessageBundleManager {
+    static instances = new Map();
+    baseMessages = null;
+    localeMessages = new Map();
+    messageBundles = new Map();
+    constructor() { }
+    static getInstance(instanceName) {
+        const instance = MessageBundleManager.instances.get(instanceName);
+        if (!instance) {
+            const newInstance = new MessageBundleManager();
+            MessageBundleManager.instances.set(instanceName, newInstance);
+            return newInstance;
+        }
+        return instance;
+    }
+    registerMessageBundle(instanceName, bundle) {
+        if (!this.messageBundles.has(instanceName)) {
+            this.messageBundles.set(instanceName, []);
+        }
+        const bundles = this.messageBundles.get(instanceName);
+        if (bundles) {
+            bundles.push(bundle);
+            this.rebuildMessages(instanceName);
+            // Refresh any LocalizationService instances that might be using this bundle manager
+            const localizationService = LocalizationService.instances.get(instanceName);
+            if (localizationService) {
+                localizationService.refreshLocalization();
+            }
+        }
+    }
+    rebuildMessages(instanceName) {
+        const bundles = this.messageBundles.get(instanceName) ?? [];
+        const baseBundle = bundles.find(b => b.type === 'base');
+        const localeBundles = bundles.filter(b => b.type === 'locale');
+        if (baseBundle) {
+            this.baseMessages = new message_1.Message(baseBundle.messages);
+            localeBundles.forEach(localeBundle => {
+                const messageLocale = localeBundle.messages['_locale'];
+                const locale = localeBundle.locale ?? (this.isValidLocale(messageLocale) ? messageLocale : constants_1.DEFAULT_LOCALE);
+                if (this.isValidLocale(locale)) {
+                    this.localeMessages.set(locale, new message_1.Message(localeBundle.messages, this.baseMessages));
+                }
+            });
+        }
+    }
+    isValidLocale(locale) {
+        if (typeof locale !== 'string') {
+            return false;
+        }
+        return SUPPORTED_LOCALES.includes(locale);
+    }
+    loadMessageBundle(config) {
+        if (!this.baseMessages) {
+            throw new Error('No base messages registered');
+        }
+        const localeConfig = config?.locale ?? constants_1.DEFAULT_LOCALE;
+        const configManager = LocalizationConfig.getInstance();
+        if (!configManager.isLocaleSupported(localeConfig)) {
+            console.error(`Cannot find ${localeConfig}, defaulting to ${constants_1.DEFAULT_LOCALE}`);
+            return this.baseMessages;
+        }
+        return this.localeMessages.get(localeConfig) ?? this.baseMessages;
+    }
+}
+exports.MessageBundleManager = MessageBundleManager;
+class LocalizationService {
+    static instances = new Map();
+    _nls = null;
+    messageBundleManager;
+    instanceName;
+    constructor(instanceName) {
+        this.instanceName = instanceName;
+        this.messageBundleManager = MessageBundleManager.getInstance(instanceName);
+    }
+    static getInstance(instanceName) {
+        const instance = LocalizationService.instances.get(instanceName);
+        if (!instance) {
+            const newInstance = new LocalizationService(instanceName);
+            LocalizationService.instances.set(instanceName, newInstance);
+            return newInstance;
+        }
+        return instance;
+    }
+    get nls() {
+        if (!this._nls) {
+            try {
+                const message = this.messageBundleManager.loadMessageBundle();
+                this._nls = new localization_1.Localization(message);
+            }
+            catch {
+                console.warn(`LocalizationService: No messages registered for instance '${this.instanceName}', using fallback localization`);
+                const emptyMessage = new message_1.Message({});
+                this._nls = new localization_1.Localization(emptyMessage);
+            }
+        }
+        return this._nls;
+    }
+    localize(key, ...args) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        return this.nls.localize(key, ...args);
+    }
+    refreshLocalization() {
+        this._nls = null;
+    }
+}
+exports.LocalizationService = LocalizationService;
+//# sourceMappingURL=advancedLocalization.js.map

package/out/src/i18n/localization.d.ts

@@ -0,0 +1,8 @@
+import { LocalizationProvider } from '../types/localization/localizationProvider';
+import { Message } from './message';
+export declare class Localization implements LocalizationProvider {
+    private readonly delegate;
+    constructor(delegate: Message);
+    localize(label: string, ...args: any[]): string;
+}
+//# sourceMappingURL=localization.d.ts.map

package/out/src/i18n/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../../src/i18n/localization.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,qBAAa,YAAa,YAAW,oBAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,QAAQ,EAAE,OAAO;IAItB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM;CAIvD"}

package/out/src/i18n/localization.js

@@ -0,0 +1,21 @@
+"use strict";
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Localization = void 0;
+class Localization {
+    delegate;
+    constructor(delegate) {
+        this.delegate = delegate;
+    }
+    localize(label, ...args) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        return this.delegate.localize(label, ...args);
+    }
+}
+exports.Localization = Localization;
+//# sourceMappingURL=localization.js.map

package/out/src/i18n/message.d.ts

@@ -0,0 +1,10 @@
+import { LocalizationProvider } from '../types/localization/localizationProvider';
+import { MessageBundle } from '../types/localization/messageBundle';
+export declare class Message implements LocalizationProvider {
+    private readonly delegate?;
+    private readonly messages;
+    constructor(messages: MessageBundle, delegate?: Message);
+    localize(label: string, ...args: any[]): string;
+    private getLabel;
+}
+//# sourceMappingURL=message.d.ts.map

package/out/src/i18n/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/i18n/message.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,qBAAa,OAAQ,YAAW,oBAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,OAAO;IAKhD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM;IAmCtD,OAAO,CAAC,QAAQ;CASjB"}

package/out/src/i18n/message.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Message = void 0;
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+const node_util_1 = require("node:util");
+const constants_1 = require("../constants");
+class Message {
+    delegate;
+    messages;
+    constructor(messages, delegate) {
+        this.messages = messages;
+        this.delegate = delegate;
+    }
+    localize(label, ...args) {
+        let possibleLabel = this.getLabel(label);
+        if (!possibleLabel) {
+            console.warn(`Missing label for key: ${label}`);
+            possibleLabel = `${constants_1.MISSING_LABEL_MSG} ${label}`;
+            if (args.length > 0) {
+                args.forEach(arg => {
+                    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+                    possibleLabel += ` (${arg})`;
+                });
+            }
+            return possibleLabel;
+        }
+        let labelArgs = args;
+        if (args.length > 0) {
+            // Count all printf-style format specifiers: %s, %d, %i, %f, %j, %%, etc.
+            const formatSpecifiers = possibleLabel.match(/%[sdifj%]/g);
+            const expectedNumArgs = formatSpecifiers ? formatSpecifiers.filter(spec => spec !== '%%').length : 0;
+            if (args.length !== expectedNumArgs) {
+                // just log it, we might want to hide some in some languages on purpose
+                console.log(`Arguments do not match for label '${label}', got ${args.length} but want ${expectedNumArgs}`);
+                // remove the extra args
+                if (args.length > expectedNumArgs) {
+                    labelArgs = args.slice(0, -(args.length - expectedNumArgs));
+                }
+            }
+            return (0, node_util_1.format)(possibleLabel, ...labelArgs);
+        }
+        return possibleLabel;
+    }
+    getLabel(label) {
+        if (this.messages[label]) {
+            return this.messages[label];
+        }
+        else if (this.delegate) {
+            return this.delegate.messages[label];
+        }
+        else {
+            return undefined;
+        }
+    }
+}
+exports.Message = Message;
+//# sourceMappingURL=message.js.map

package/out/src/index.d.ts

@@ -0,0 +1,11 @@
+export { Locale } from './types/localization/config';
+export { MessageArgs } from './types/localization/messageArgs';
+export { MessageBundle } from './types/localization/messageBundle';
+export { AdvancedMessageBundle } from './types/localization/advancedTypes';
+export { LocalizationProvider } from './types/localization/localizationProvider';
+export { Config } from './types/localization/config';
+export { LocalizationService, LocalizationConfig, MessageBundleManager } from './i18n/advancedLocalization';
+export { Localization } from './i18n/localization';
+export { Message } from './i18n/message';
+export { DEFAULT_LOCALE, LOCALE_JA, MISSING_LABEL_MSG } from './constants';
+//# sourceMappingURL=index.d.ts.map

package/out/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/out/src/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISSING_LABEL_MSG = exports.LOCALE_JA = exports.DEFAULT_LOCALE = exports.Message = exports.Localization = exports.MessageBundleManager = exports.LocalizationConfig = exports.LocalizationService = void 0;
+// i18n
+var advancedLocalization_1 = require("./i18n/advancedLocalization");
+Object.defineProperty(exports, "LocalizationService", { enumerable: true, get: function () { return advancedLocalization_1.LocalizationService; } });
+Object.defineProperty(exports, "LocalizationConfig", { enumerable: true, get: function () { return advancedLocalization_1.LocalizationConfig; } });
+Object.defineProperty(exports, "MessageBundleManager", { enumerable: true, get: function () { return advancedLocalization_1.MessageBundleManager; } });
+var localization_1 = require("./i18n/localization");
+Object.defineProperty(exports, "Localization", { enumerable: true, get: function () { return localization_1.Localization; } });
+var message_1 = require("./i18n/message");
+Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return message_1.Message; } });
+// Constants
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_LOCALE", { enumerable: true, get: function () { return constants_1.DEFAULT_LOCALE; } });
+Object.defineProperty(exports, "LOCALE_JA", { enumerable: true, get: function () { return constants_1.LOCALE_JA; } });
+Object.defineProperty(exports, "MISSING_LABEL_MSG", { enumerable: true, get: function () { return constants_1.MISSING_LABEL_MSG; } });
+//# sourceMappingURL=index.js.map

package/out/src/types/localization/advancedTypes.d.ts

@@ -0,0 +1,7 @@
+import { Locale } from './config';
+export type AdvancedMessageBundle = {
+    messages: Record<string, string>;
+    type: 'base' | 'locale';
+    locale?: Locale;
+};
+//# sourceMappingURL=advancedTypes.d.ts.map

package/out/src/types/localization/advancedTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedTypes.d.ts","sourceRoot":"","sources":["../../../../src/types/localization/advancedTypes.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/out/src/types/localization/advancedTypes.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=advancedTypes.js.map

package/out/src/types/localization/config.d.ts

@@ -0,0 +1,5 @@
+export type Locale = 'en' | 'ja';
+export type Config = {
+    locale: Locale;
+};
+//# sourceMappingURL=config.d.ts.map

package/out/src/types/localization/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/types/localization/config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/out/src/types/localization/config.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/out/src/types/localization/localizationProvider.d.ts

@@ -0,0 +1,4 @@
+export type LocalizationProvider = {
+    localize<T extends string>(key: T, ...args: any[]): string;
+};
+//# sourceMappingURL=localizationProvider.d.ts.map

package/out/src/types/localization/localizationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localizationProvider.d.ts","sourceRoot":"","sources":["../../../../src/types/localization/localizationProvider.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;CAC5D,CAAC"}

package/out/src/types/localization/localizationProvider.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=localizationProvider.js.map

package/out/src/types/localization/messageArgs.d.ts

@@ -0,0 +1,5 @@
+type PlaceholderToType<S extends string> = S extends '%s' ? string : S extends '%d' ? number : S extends '%i' ? number : S extends '%f' ? number : S extends '%j' ? any : unknown;
+type ExtractArgs<S extends string, Acc extends any[] = []> = S extends `${infer _}%${infer P}${infer Rest}` ? P extends 's' | 'd' | 'i' | 'f' | 'j' ? ExtractArgs<Rest, [...Acc, PlaceholderToType<`%${P}`>]> : ExtractArgs<Rest, Acc> : Acc;
+export type MessageArgs<K extends keyof T, T extends Record<string, string>> = ExtractArgs<T[K]>;
+export {};
+//# sourceMappingURL=messageArgs.d.ts.map

package/out/src/types/localization/messageArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageArgs.d.ts","sourceRoot":"","sources":["../../../../src/types/localization/messageArgs.ts"],"names":[],"mappings":"AAQA,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,GACrD,MAAM,GACN,CAAC,SAAS,IAAI,GACZ,MAAM,GACN,CAAC,SAAS,IAAI,GACZ,MAAM,GACN,CAAC,SAAS,IAAI,GACZ,MAAM,GACN,CAAC,SAAS,IAAI,GACZ,GAAG,GACH,OAAO,CAAC;AAIpB,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,IAAI,EAAE,GACvG,CAAC,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GACnC,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GACvD,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,GACxB,GAAG,CAAC;AAGR,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/out/src/types/localization/messageArgs.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=messageArgs.js.map

package/out/src/types/localization/messageBundle.d.ts

@@ -0,0 +1,4 @@
+export type MessageBundle = {
+    readonly [index: string]: string;
+};
+//# sourceMappingURL=messageBundle.d.ts.map

package/out/src/types/localization/messageBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageBundle.d.ts","sourceRoot":"","sources":["../../../../src/types/localization/messageBundle.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC,CAAC"}

package/out/src/types/localization/messageBundle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=messageBundle.js.map

package/out/test/jest/i18n/advancedLocalization.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=advancedLocalization.test.d.ts.map

package/out/test/jest/i18n/advancedLocalization.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedLocalization.test.d.ts","sourceRoot":"","sources":["../../../../test/jest/i18n/advancedLocalization.test.ts"],"names":[],"mappings":""}