feat: add table() method

Author: lukeed

readme.md

@@ -155,6 +155,20 @@ ctx.t('bar', { value: 123 }, 'en');
 //=> 'template sees "123"
 ```
 
+### rosetta.table(lang)
+Returns: `Object` or `undefined`
+
+Retrieve the the `lang`'s full dictionary/table of translation keys.
+
+If the language does not exist (aka, no translations have been provided for it), you'll receive `undefined`.<br>Otherwise, you'll receive the full object as it exists within the `Rosetta` instance. See [`table`](#table).
+
+> **Important:** Manipulating this object is any way will mutate and affect your `Rosetta` instance. Be careful!
+
+#### lang
+Type: `String`
+
+The language code's table to retrieve.
+
 
 ### rosetta.t(key, params?, lang?)
 Returns: `String`

rosetta.d.ts

@@ -4,6 +4,8 @@ declare module 'rosetta' {
 		locale(lang?: string): string;
 		/** Define or extend the language table */
 		set(lang: string, table: T): void;
+		/** Get the table of translations for a language */
+		table(lang: string): T | void;
 		/** Retrieve a translation segment for the current language */
 		t<X extends Record<string, any> | any[]>(key: string | (string | number)[], params?: X, lang?: string): string;
 	}
@@ -18,6 +20,8 @@ declare module 'rosetta/debug' {
 		locale(lang?: string): string;
 		/** Define or extend the language table */
 		set(lang: string, table: T): void;
+		/** Get the table of translations for a language */
+		table(lang: string): T | void;
 		/** Retrieve a translation segment for the current language */
 		t<X extends Record<string, any> | any[]>(key: string | (string | number)[], params?: X, lang?: string): string;
 	}

src/debug.js

@@ -13,6 +13,10 @@ export default function (obj) {
 			return (locale = lang || locale);
 		},
 
+		table(lang) {
+			return tree[lang];
+		},
+
 		t(key, params, lang) {
 			var val = dlv(tree[lang || locale], key);
 			if (val == null) {

src/index.js

@@ -13,6 +13,10 @@ export default function (obj) {
 			return (locale = lang || locale);
 		},
 
+		table(lang) {
+			return tree[lang];
+		},
+
 		t(key, params, lang) {
 			var val = dlv(tree[lang || locale], key, '');
 			if (typeof val === 'function') return val(params);

test/debug.js

@@ -26,6 +26,16 @@ test('(debug) usage', () => {
 		pt: { foo: 'foo {{name}}~!' },
 	});
 
+	assert.equal(
+		ctx.table('en'),
+		{ hello: 'Hello, {{name}}!' }
+	);
+
+	assert.is(
+		ctx.table('foobar'),
+		undefined
+	);
+
 	let foo = ctx.t('hello');
 	assert.is(foo, undefined, '~> undefined w/o locale');
 	assert.is(_message, `[rosetta] Missing the "hello" key within the "" dictionary`, '~> prints error message');

test/index.js

@@ -20,6 +20,16 @@ test('usage', () => {
 		pt: { foo: 'foo {{name}}~!' },
 	});
 
+	assert.equal(
+		ctx.table('en'),
+		{ hello: 'Hello, {{name}}!' }
+	);
+
+	assert.is(
+		ctx.table('foobar'),
+		undefined
+	);
+
 	let foo = ctx.t('hello');
 	assert.is(foo, "", '~> "" w/o locale');