i18next-cli 0.9.0

package/types/utils/nested-object.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Sets a nested value in an object using a key path and separator.
+ * Creates intermediate objects as needed.
+ *
+ * @param obj - The target object to modify
+ * @param path - The key path (e.g., 'user.profile.name')
+ * @param value - The value to set
+ * @param keySeparator - The separator to use for splitting the path, or false for flat keys
+ *
+ * @example
+ * ```typescript
+ * const obj = {}
+ * setNestedValue(obj, 'user.profile.name', 'John', '.')
+ * // Result: { user: { profile: { name: 'John' } } }
+ *
+ * // With flat keys
+ * setNestedValue(obj, 'user.name', 'Jane', false)
+ * // Result: { 'user.name': 'Jane' }
+ * ```
+ */
+export declare function setNestedValue(obj: Record<string, any>, path: string, value: any, keySeparator: string | false): void;
+/**
+ * Retrieves a nested value from an object using a key path and separator.
+ *
+ * @param obj - The object to search in
+ * @param path - The key path (e.g., 'user.profile.name')
+ * @param keySeparator - The separator to use for splitting the path, or false for flat keys
+ * @returns The found value or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const obj = { user: { profile: { name: 'John' } } }
+ * const name = getNestedValue(obj, 'user.profile.name', '.')
+ * // Returns: 'John'
+ *
+ * // With flat keys
+ * const flatObj = { 'user.name': 'Jane' }
+ * const name = getNestedValue(flatObj, 'user.name', false)
+ * // Returns: 'Jane'
+ * ```
+ */
+export declare function getNestedValue(obj: Record<string, any>, path: string, keySeparator: string | false): any;
+/**
+ * Extracts all nested keys from an object, optionally with a prefix.
+ * Recursively traverses the object structure to build a flat list of key paths.
+ *
+ * @param obj - The object to extract keys from
+ * @param keySeparator - The separator to use for joining keys, or false for flat keys
+ * @param prefix - Optional prefix to prepend to all keys
+ * @returns Array of all nested key paths
+ *
+ * @example
+ * ```typescript
+ * const obj = {
+ *   user: {
+ *     profile: { name: 'John', age: 30 },
+ *     settings: { theme: 'dark' }
+ *   }
+ * }
+ *
+ * const keys = getNestedKeys(obj, '.')
+ * // Returns: ['user.profile.name', 'user.profile.age', 'user.settings.theme']
+ *
+ * // With flat keys
+ * const flatObj = { 'user.name': 'Jane', 'user.age': 25 }
+ * const flatKeys = getNestedKeys(flatObj, false)
+ * // Returns: ['user.name', 'user.age']
+ * ```
+ */
+export declare function getNestedKeys(obj: object, keySeparator: string | false, prefix?: string): string[];
+//# sourceMappingURL=nested-object.d.ts.map

package/types/utils/nested-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-object.d.ts","sourceRoot":"","sources":["../../src/utils/nested-object.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,EACV,YAAY,EAAE,MAAM,GAAG,KAAK,GAC3B,IAAI,CAcN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,KAAK,GAC3B,GAAG,CAKL;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAa/F"}

package/types/utils/validation.d.ts

@@ -0,0 +1,47 @@
+import type { I18nextToolkitConfig } from '../types';
+/**
+ * Validates the extractor configuration to ensure required fields are present and properly formatted.
+ *
+ * This function performs the following validations:
+ * - Ensures extract.input is specified and non-empty
+ * - Ensures extract.output is specified
+ * - Ensures locales array is specified and non-empty
+ * - Ensures extract.output contains the required {{language}} placeholder
+ *
+ * @param config - The i18next toolkit configuration object to validate
+ *
+ * @throws {ExtractorError} When any validation rule fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateExtractorConfig(config)
+ *   console.log('Configuration is valid')
+ * } catch (error) {
+ *   console.error('Invalid configuration:', error.message)
+ * }
+ * ```
+ */
+export declare function validateExtractorConfig(config: I18nextToolkitConfig): void;
+/**
+ * Custom error class for extraction-related errors.
+ * Provides additional context like file path and underlying cause.
+ *
+ * @example
+ * ```typescript
+ * throw new ExtractorError('Failed to parse file', 'src/component.tsx', syntaxError)
+ * ```
+ */
+export declare class ExtractorError extends Error {
+    readonly file?: string | undefined;
+    readonly cause?: Error | undefined;
+    /**
+     * Creates a new ExtractorError with optional file context and cause.
+     *
+     * @param message - The error message
+     * @param file - Optional file path where the error occurred
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(message: string, file?: string | undefined, cause?: Error | undefined);
+}
+//# sourceMappingURL=validation.d.ts.map

package/types/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAgB3E;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAUrB,IAAI,CAAC,EAAE,MAAM;aACb,KAAK,CAAC,EAAE,KAAK;IAV/B;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC"}

package/vitest.config.ts

@@ -0,0 +1,13 @@
+// eslint-disable-next-line import/no-unresolved
+import swc from 'unplugin-swc'
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    // Make vitest globals like `describe` and `it` available without importing
+    globals: true,
+    // Look for test files in the entire project
+    root: './',
+  },
+  plugins: [swc.vite()]
+})