@maxal_studio/kratosjs-react 1.0.0

package/src/i18n/index.ts

@@ -0,0 +1,12 @@
+// React i18n barrel.
+export { I18nProvider, useI18nContext } from './I18nProvider';
+export type { I18nContextValue, I18nProviderProps } from './I18nProvider';
+export { useTranslation } from './useTranslation';
+export { useLocale } from './useLocale';
+export { useFormatter } from './useFormatter';
+export { LocaleSwitcher } from './LocaleSwitcher';
+export type { LocaleSwitcherProps } from './LocaleSwitcher';
+export { getActiveLocale, translate, setActiveI18n } from './activeLocale';
+export { buildClientI18n, buildClientResources } from './buildClientI18n';
+export type { ClientI18nConfig, ClientTranslations } from './buildClientI18n';
+export { clientCoreResources } from './locales/core';

package/src/i18n/locales/core/en.ts

@@ -0,0 +1,274 @@
+// Client UI-chrome catalog (English). Namespace: `core`.
+//
+// These strings ship WITH the React package so the panel renders correctly with
+// zero i18n config. Apps/plugins can override any of them (app wins) by
+// registering a `core:`-prefixed key. Distinct from the server `core` catalog,
+// which holds backend framework + validation strings.
+
+import { defaultValidationMessages } from '@maxal_studio/kratosjs/dist/validation';
+
+const en = {
+	// Validation messages (shared with the server; rendered client-side via t()).
+	...defaultValidationMessages,
+	// Generic "required" shown by react-hook-form's native required (no field label).
+	'validation.required_generic': 'This field is required',
+
+	// Common actions / labels.
+	'common.save': 'Save',
+	'common.cancel': 'Cancel',
+	'common.confirm': 'Confirm',
+	'common.delete': 'Delete',
+	'common.close': 'Close',
+	'common.submit': 'Submit',
+	'common.submitting': 'Submitting...',
+	'common.reset': 'Reset',
+	'common.retry': 'Retry',
+	'common.actions': 'Actions',
+	'common.more': 'More',
+	'common.yes': 'Yes',
+	'common.no': 'No',
+	'common.loading': 'Loading',
+	'common.search': 'Search records…',
+
+	// Panel shell.
+	'panel.loading': 'Loading KratosJs Panel...',
+	'panel.connection_error': 'Connection Error',
+	'panel.empty': 'No resources or pages available in this panel',
+	'panel.sign_out': 'Sign out',
+	'panel.open_menu': 'Open navigation menu',
+	'panel.toggle_dark': 'Switch to dark mode',
+	'panel.toggle_light': 'Switch to light mode',
+	'panel.language': 'Language',
+
+	// Tables.
+	'table.no_records': 'No records found',
+	'table.no_records_hint': 'Try adjusting your search or filters.',
+	'table.filters': 'Filters',
+	'table.row_actions': 'Row actions',
+
+	// Forms / records.
+	'form.create_title': 'Create {label}',
+	'form.edit_title': 'Edit {label}',
+	'form.editing_title': 'Editing "{title}"',
+	'form.action_failed': 'Action failed',
+	'form.create_failed': 'Failed to create record',
+	'form.update_failed': 'Failed to update record',
+	'form.confirm_bulk': 'Are you sure you want to {action} {count} items?',
+
+	// Auth / login.
+	'auth.welcome_back': 'Welcome back',
+	'auth.sign_in': 'Sign in',
+	'auth.sign_in_to': 'Sign in to {title}',
+	'auth.email': 'Email',
+	'auth.email_placeholder': 'you@company.com',
+	'auth.password': 'Password',
+	'auth.password_placeholder': 'Enter your password',
+	'auth.choose_provider': 'Choose how you would like to sign in',
+	'auth.enter_credentials': 'Enter your credentials to continue',
+	'auth.continue': 'Continue to access your account',
+	'auth.verify_identity': 'Verify your identity',
+	'auth.back_to_options': 'Back to sign-in options',
+	'auth.no_providers': 'No authentication providers are configured.',
+	'auth.login_failed': 'Login failed',
+	'auth.verification_failed': 'Verification failed',
+
+	// Common icon-button labels.
+	'common.move_up': 'Move up',
+	'common.move_down': 'Move down',
+	'common.move_left': 'Move left',
+	'common.move_right': 'Move right',
+	'common.copy_url': 'Copy URL',
+	'common.clear': 'Clear',
+	'common.create': 'Create',
+	'common.edit': 'Edit',
+	'common.view': 'View',
+	'common.apply': 'Apply',
+	'common.add': 'Add',
+	'common.remove': 'Remove',
+	'common.upload': 'Upload',
+	'common.dismiss': 'Dismiss',
+
+	// Table toolbar / pagination / actions.
+	'table.create_record': 'Create record',
+	'table.column_settings': 'Column settings',
+	'table.no_toggleable_columns': 'No toggleable columns available',
+	'table.close_filters': 'Close filters',
+	'table.view_tabs': 'Table view tabs',
+	'table.save_changes': 'Save changes',
+	'table.reset_changes': 'Reset changes',
+	'pagination.per_page': 'Results per page',
+	'pagination.previous': 'Previous page',
+	'pagination.next': 'Next page',
+
+	// Search.
+	'search.records': 'Search records',
+	'search.close': 'Close search',
+	'search.clear': 'Clear search',
+
+	// Filters.
+	'filters.from_date': 'From date...',
+	'filters.to_date': 'To date...',
+	'filters.from': 'From...',
+	'filters.to': 'To...',
+	'filters.date': 'Date...',
+	'filters.value': 'Value...',
+	'filters.range': 'Range',
+	'filters.no_rules': 'No rules added yet',
+
+	// Modals / drawers.
+	'modal.close': 'Close',
+	'modal.close_all': 'Close all',
+	'modal.stack': 'Modal stack',
+	'modal.sections': 'Record sections',
+
+	// Confirm dialogs.
+	'confirm.delete_item_title': 'Delete item',
+	'confirm.delete_item_message': 'Are you sure you want to delete this item? This cannot be undone.',
+	'confirm.delete_items_title': 'Delete items',
+	'confirm.delete_items_message': 'Are you sure you want to delete {count} items? This cannot be undone.',
+	'confirm.action_single': 'Are you sure you want to {action} this item?',
+	'confirm.action_generic': 'Are you sure you want to {action}?',
+
+	// Toasts / record results.
+	'toast.delete_failed': 'Failed to delete item',
+	'toast.deleted': 'Item deleted successfully',
+	'toast.upload_failed': 'Failed to upload file',
+	'toast.invalid_html': 'Invalid HTML. Please check your code.',
+
+	// File upload.
+	'file.uploaded': 'File uploaded',
+	'file.drop_here': 'Drop files here',
+	'file.click_to_upload': 'Click to upload',
+	'file.video': 'Video',
+	'file.audio': 'Audio',
+	'file.saved': 'Saved',
+	'file.no_image': 'No image',
+
+	// Empty / misc states.
+	'state.no_fields': 'No fields to display',
+	'state.no_data': 'No data available',
+	'state.page_not_found': 'Page not found',
+
+	// Rich editor.
+	'editor.html_placeholder': 'Enter HTML code here...',
+
+	// Tags / repeater.
+	'tags.label': 'Tags',
+	'repeater.active_tab': 'Active tab',
+
+	// Misc attribute labels.
+	'a11y.color_preview': 'Color preview',
+	'a11y.main_navigation': 'Main navigation',
+	'a11y.tab_errors': 'Has validation errors or required fields',
+
+	// Rich-text editor toolbar.
+	'editor.bold': 'Bold',
+	'editor.italic': 'Italic',
+	'editor.underline': 'Underline',
+	'editor.strikethrough': 'Strikethrough',
+	'editor.code': 'Code',
+	'editor.code_block': 'Code Block',
+	'editor.heading1': 'Heading 1',
+	'editor.heading2': 'Heading 2',
+	'editor.heading3': 'Heading 3',
+	'editor.bullet_list': 'Bullet List',
+	'editor.ordered_list': 'Ordered List',
+	'editor.blockquote': 'Blockquote',
+	'editor.undo': 'Undo',
+	'editor.redo': 'Redo',
+	'editor.link': 'Link',
+	'editor.subscript': 'Subscript',
+	'editor.superscript': 'Superscript',
+	'editor.highlight': 'Highlight',
+	'editor.align_left': 'Align Left',
+	'editor.align_center': 'Align Center',
+	'editor.align_right': 'Align Right',
+	'editor.insert_image': 'Insert Image',
+	'editor.insert_video': 'Insert Video',
+	'table.column_visibility': 'Column visibility',
+	'pagination.per_page_short': 'Per page',
+	'filters.query_builder': 'Query Builder',
+	'search.start_typing': 'Start typing to see results',
+	'common.loading_ellipsis': 'Loading...',
+	'search.subtitle': 'Search across all records in this panel',
+	'state.no_table_schema': 'No table schema available for this resource',
+	'pagination.range_compact': '{start}–{end} of {total}',
+	'pagination.showing': 'Showing {start} to {end} of {total} results',
+	'auth.preparing': 'Preparing sign in…',
+	'repeater.empty': 'No items yet. Click the button below to add one.',
+	'select.create': 'Create "{term}"',
+	'select.loading': 'Loading...',
+	'filters.add_rule_hint': 'Click "Add Rule" to start building your query',
+	'page.loading': 'Loading page...',
+	'page.no_content': 'This page has no content.',
+	'modal.view_title': 'View {label}',
+	'modal.view_record': 'View "{title}"',
+	'auth.back_to_signin': 'Back to sign in',
+	'auth.providers_load_failed': 'Failed to load authentication providers',
+	'editor.insert_audio': 'Insert Audio',
+	'editor.insert_embed': 'Insert Embed',
+	'editor.html_source': 'HTML Source',
+	'filters.preset_today': 'Today',
+	'filters.preset_yesterday': 'Yesterday',
+	'filters.preset_this_week': 'This Week',
+	'filters.preset_this_month': 'This Month',
+	'filters.preset_this_year': 'This Year',
+	'filters.preset_custom': 'Custom',
+	'common.warning': 'Warning',
+	'state.unknown_field': 'Unknown field type "{type}" for field "{name}"',
+	'state.unknown_column': 'Unknown column type: {type}',
+	'error.connect': 'Failed to connect to API',
+	'error.load_data': 'Failed to load data',
+	'error.load_schema': 'Failed to load table schema',
+	'search.nav_navigate': 'Navigate',
+	'search.nav_open': 'Open',
+	'search.nav_close': 'Close',
+	'common.clear_all': 'Clear all',
+	'common.done': 'Done',
+	'common.all': 'All',
+	'common.try_again': 'Try again',
+	'common.details': 'Details',
+	'common.widgets': 'Widgets',
+	'filters.label_from': 'From',
+	'filters.label_to': 'To',
+	'filters.no_options': 'No options available',
+	'filters.clear_all_filters': 'Clear all filters',
+	'filters.from_value': 'From {date}',
+	'filters.until_value': 'Until {date}',
+	'filters.select_range': 'Select date range...',
+	'confirm.are_you_sure': 'Are you sure?',
+	'common.item': 'Item',
+	'form.submitted': 'Form submitted successfully!',
+	'select.placeholder': 'Select...',
+	'select.create_new': 'Create New',
+	'common.record': 'Record',
+	'editor.start_typing': 'Start typing...',
+	'error.load_record': 'Failed to load record',
+	'error.load_page': 'Failed to load page',
+	'file.video_preview': 'Video Preview',
+	'common.preview': 'Preview',
+	'common.image': 'Image',
+	'common.file': 'File',
+	'editor.rich_text_view': 'Rich Text View',
+	'select.no_matching': 'No matching options found',
+	'table.switch_grid': 'Switch to grid view',
+	'table.switch_table': 'Switch to table view',
+	'table.hide_widgets': 'Hide widgets',
+	'table.show_widgets': 'Show widgets',
+	'error.action_failed': 'Failed to execute action',
+	'error.action_failed_bulk': 'Failed to execute bulk action',
+	'common.video_thumbnail': 'Video thumbnail',
+	'common.error': 'Error',
+	'widget.data_label': 'Data',
+	'filters.advanced_search': 'Advanced Search',
+	'error.fetch_form_data': 'Failed to fetch form data',
+	'error.fetch_form_data_generic': 'An error occurred while fetching form data',
+	'error.submit_form': 'Failed to submit form',
+	'error.generic': 'An error occurred',
+	'error.export_failed': 'Failed to export',
+	'error.delete_failed': 'Failed to delete',
+	'error.bulk_action_failed': 'Bulk action failed',
+};
+
+export default en;
+export type ClientCoreCatalog = typeof en;

package/src/i18n/locales/core/index.ts

@@ -0,0 +1,5 @@
+import en from './en';
+import sq from './sq';
+
+/** Client UI-chrome catalog, keyed by locale (the `core` namespace). */
+export const clientCoreResources: Record<string, Record<string, string>> = { en, sq };

package/src/i18n/locales/core/sq.ts

@@ -0,0 +1,275 @@
+// Client UI-chrome catalog (Albanian / Shqip). Namespace: `core`. Mirrors ./en.ts.
+
+const sq = {
+	// Validation messages (Albanian) — mirrors the server core sq catalog.
+	'validation.required_generic': 'Kjo fushë është e detyrueshme',
+	'validation.required': 'Fusha "{label}" është e detyrueshme',
+	'validation.email': 'Fusha "{label}" duhet të jetë një email i vlefshëm',
+	'validation.url': 'Fusha "{label}" duhet të jetë një URL e vlefshme',
+	'validation.integer': 'Fusha "{label}" duhet të jetë një numër i plotë',
+	'validation.numeric': 'Fusha "{label}" duhet të jetë numerike',
+	'validation.alpha': 'Fusha "{label}" mund të përmbajë vetëm shkronja',
+	'validation.alpha_num': 'Fusha "{label}" mund të përmbajë vetëm shkronja dhe numra',
+	'validation.alpha_dash': 'Fusha "{label}" mund të përmbajë vetëm shkronja, numra, vija dhe nënvija',
+	'validation.uuid': 'Fusha "{label}" duhet të jetë një UUID i vlefshëm',
+	'validation.json': 'Fusha "{label}" duhet të jetë JSON i vlefshëm',
+	'validation.regex': 'Fusha "{label}" nuk përputhet me modelin e kërkuar',
+	'validation.min.string': 'Fusha "{label}" duhet të ketë të paktën {param} karaktere',
+	'validation.max.string': 'Fusha "{label}" duhet të ketë më së shumti {param} karaktere',
+	'validation.min.number': 'Fusha "{label}" duhet të jetë të paktën {param}',
+	'validation.max.number': 'Fusha "{label}" duhet të jetë më së shumti {param}',
+	'validation.min_value': 'Fusha "{label}" duhet të jetë të paktën {param}',
+	'validation.max_value': 'Fusha "{label}" duhet të jetë më së shumti {param}',
+	'validation.same': 'Fusha "{label}" duhet të përputhet me {param}',
+	'validation.confirmed': 'Konfirmimi i fushës "{label}" nuk përputhet',
+	'validation.invalid': 'Fusha "{label}" është e pavlefshme',
+	'validation.type.string': 'Fusha "{label}" duhet të jetë tekst',
+	'validation.type.number': 'Fusha "{label}" duhet të jetë numër',
+	'validation.type.boolean': 'Fusha "{label}" duhet të jetë vlerë logjike',
+	'validation.type.array': 'Fusha "{label}" duhet të jetë varg',
+	'validation.type.array_items': 'Fusha "{label}" duhet të jetë një varg me tekste ose numra',
+	'validation.type.object': 'Fusha "{label}" duhet të jetë objekt',
+	'validation.type.date': 'Fusha "{label}" duhet të jetë një datë e vlefshme',
+	'validation.readonly': 'Fusha "{label}" është vetëm për lexim',
+	'validation.invalid_option': 'Fusha "{label}" ka një opsion të pavlefshëm',
+
+	'common.save': 'Ruaj',
+	'common.cancel': 'Anulo',
+	'common.confirm': 'Konfirmo',
+	'common.delete': 'Fshi',
+	'common.close': 'Mbyll',
+	'common.submit': 'Dërgo',
+	'common.submitting': 'Duke dërguar...',
+	'common.reset': 'Rivendos',
+	'common.retry': 'Provo përsëri',
+	'common.actions': 'Veprime',
+	'common.more': 'Më shumë',
+	'common.yes': 'Po',
+	'common.no': 'Jo',
+	'common.loading': 'Duke ngarkuar',
+	'common.search': 'Kërko regjistrime…',
+
+	'panel.loading': 'Duke ngarkuar panelin KratosJs...',
+	'panel.connection_error': 'Gabim lidhjeje',
+	'panel.empty': 'Nuk ka burime ose faqe në këtë panel',
+	'panel.sign_out': 'Dil',
+	'panel.open_menu': 'Hap menynë e navigimit',
+	'panel.toggle_dark': 'Kalo në modalitetin e errët',
+	'panel.toggle_light': 'Kalo në modalitetin e ndritshëm',
+	'panel.language': 'Gjuha',
+
+	'table.no_records': 'Nuk u gjetën regjistrime',
+	'table.no_records_hint': 'Provoni të ndryshoni kërkimin ose filtrat.',
+	'table.filters': 'Filtra',
+	'table.row_actions': 'Veprime rreshti',
+
+	'form.create_title': 'Krijo {label}',
+	'form.edit_title': 'Ndrysho {label}',
+	'form.editing_title': 'Duke ndryshuar "{title}"',
+	'form.action_failed': 'Veprimi dështoi',
+	'form.create_failed': 'Krijimi i regjistrimit dështoi',
+	'form.update_failed': 'Përditësimi i regjistrimit dështoi',
+	'form.confirm_bulk': 'Jeni i sigurt që doni të {action} {count} artikuj?',
+
+	'auth.welcome_back': 'Mirë se erdhe',
+	'auth.sign_in': 'Hyr',
+	'auth.sign_in_to': 'Hyr në {title}',
+	'auth.email': 'Email',
+	'auth.email_placeholder': 'ti@kompania.com',
+	'auth.password': 'Fjalëkalimi',
+	'auth.password_placeholder': 'Shkruani fjalëkalimin tuaj',
+	'auth.choose_provider': 'Zgjidhni si dëshironi të hyni',
+	'auth.enter_credentials': 'Shkruani kredencialet tuaja për të vazhduar',
+	'auth.continue': 'Vazhdoni për të hyrë në llogarinë tuaj',
+	'auth.verify_identity': 'Verifikoni identitetin tuaj',
+	'auth.back_to_options': 'Kthehu te opsionet e hyrjes',
+	'auth.no_providers': 'Nuk ka ofrues autentifikimi të konfiguruar.',
+	'auth.login_failed': 'Hyrja dështoi',
+	'auth.verification_failed': 'Verifikimi dështoi',
+
+	'common.move_up': 'Lëviz lart',
+	'common.move_down': 'Lëviz poshtë',
+	'common.move_left': 'Lëviz majtas',
+	'common.move_right': 'Lëviz djathtas',
+	'common.copy_url': 'Kopjo URL-në',
+	'common.clear': 'Pastro',
+	'common.create': 'Krijo',
+	'common.edit': 'Ndrysho',
+	'common.view': 'Shiko',
+	'common.apply': 'Apliko',
+	'common.add': 'Shto',
+	'common.remove': 'Hiq',
+	'common.upload': 'Ngarko',
+	'common.dismiss': 'Mbyll',
+
+	'table.create_record': 'Krijo regjistrim',
+	'table.column_settings': 'Cilësimet e kolonave',
+	'table.no_toggleable_columns': 'Nuk ka kolona të ndryshueshme',
+	'table.close_filters': 'Mbyll filtrat',
+	'table.view_tabs': 'Skedat e pamjes së tabelës',
+	'table.save_changes': 'Ruaj ndryshimet',
+	'table.reset_changes': 'Rivendos ndryshimet',
+	'pagination.per_page': 'Rezultate për faqe',
+	'pagination.previous': 'Faqja e mëparshme',
+	'pagination.next': 'Faqja tjetër',
+
+	'search.records': 'Kërko regjistrime',
+	'search.close': 'Mbyll kërkimin',
+	'search.clear': 'Pastro kërkimin',
+
+	'filters.from_date': 'Nga data...',
+	'filters.to_date': 'Deri më datë...',
+	'filters.from': 'Nga...',
+	'filters.to': 'Deri...',
+	'filters.date': 'Data...',
+	'filters.value': 'Vlera...',
+	'filters.range': 'Interval',
+	'filters.no_rules': 'Ende nuk ka rregulla',
+
+	'modal.close': 'Mbyll',
+	'modal.close_all': 'Mbyll të gjitha',
+	'modal.stack': 'Pirgu i dritareve',
+	'modal.sections': 'Seksionet e regjistrimit',
+
+	'confirm.delete_item_title': 'Fshi artikullin',
+	'confirm.delete_item_message': 'Jeni i sigurt që doni ta fshini këtë artikull? Kjo nuk mund të zhbëhet.',
+	'confirm.delete_items_title': 'Fshi artikujt',
+	'confirm.delete_items_message': 'Jeni i sigurt që doni të fshini {count} artikuj? Kjo nuk mund të zhbëhet.',
+	'confirm.action_single': 'Jeni i sigurt që doni të {action} këtë artikull?',
+	'confirm.action_generic': 'Jeni i sigurt që doni të {action}?',
+
+	'toast.delete_failed': 'Fshirja e artikullit dështoi',
+	'toast.deleted': 'Artikulli u fshi me sukses',
+	'toast.upload_failed': 'Ngarkimi i skedarit dështoi',
+	'toast.invalid_html': 'HTML i pavlefshëm. Ju lutemi kontrolloni kodin tuaj.',
+
+	'file.uploaded': 'Skedari u ngarkua',
+	'file.drop_here': 'Lëshoni skedarët këtu',
+	'file.click_to_upload': 'Klikoni për të ngarkuar',
+	'file.video': 'Video',
+	'file.audio': 'Audio',
+	'file.saved': 'Ruajtur',
+	'file.no_image': 'Nuk ka imazh',
+
+	'state.no_fields': 'Nuk ka fusha për të shfaqur',
+	'state.no_data': 'Nuk ka të dhëna',
+	'state.page_not_found': 'Faqja nuk u gjet',
+
+	'editor.html_placeholder': 'Shkruani kodin HTML këtu...',
+
+	'tags.label': 'Etiketa',
+	'repeater.active_tab': 'Skeda aktive',
+
+	'a11y.color_preview': 'Pamja paraprake e ngjyrës',
+	'a11y.main_navigation': 'Navigimi kryesor',
+	'a11y.tab_errors': 'Ka gabime validimi ose fusha të detyrueshme',
+
+	'editor.bold': 'Theksuar',
+	'editor.italic': 'Pjerrët',
+	'editor.underline': 'Nënvizuar',
+	'editor.strikethrough': 'Vijëzuar',
+	'editor.code': 'Kod',
+	'editor.code_block': 'Bllok kodi',
+	'editor.heading1': 'Titull 1',
+	'editor.heading2': 'Titull 2',
+	'editor.heading3': 'Titull 3',
+	'editor.bullet_list': 'Listë me pika',
+	'editor.ordered_list': 'Listë e numëruar',
+	'editor.blockquote': 'Citat',
+	'editor.undo': 'Zhbëj',
+	'editor.redo': 'Ribëj',
+	'editor.link': 'Lidhje',
+	'editor.subscript': 'Nënshkrim',
+	'editor.superscript': 'Mbishkrim',
+	'editor.highlight': 'Thekso',
+	'editor.align_left': 'Rreshto majtas',
+	'editor.align_center': 'Rreshto në qendër',
+	'editor.align_right': 'Rreshto djathtas',
+	'editor.insert_image': 'Fut imazh',
+	'editor.insert_video': 'Fut video',
+	'table.column_visibility': 'Dukshmëria e kolonave',
+	'pagination.per_page_short': 'Për faqe',
+	'filters.query_builder': 'Ndërtuesi i pyetjeve',
+	'search.start_typing': 'Filloni të shkruani për të parë rezultatet',
+	'common.loading_ellipsis': 'Duke ngarkuar...',
+	'search.subtitle': 'Kërkoni në të gjitha regjistrimet e këtij paneli',
+	'state.no_table_schema': 'Nuk ka skemë tabele për këtë burim',
+	'pagination.range_compact': '{start}–{end} nga {total}',
+	'pagination.showing': 'Duke shfaqur {start} deri {end} nga {total} rezultate',
+	'auth.preparing': 'Duke përgatitur hyrjen…',
+	'repeater.empty': 'Ende nuk ka artikuj. Klikoni butonin më poshtë për të shtuar një.',
+	'select.create': 'Krijo "{term}"',
+	'select.loading': 'Duke ngarkuar...',
+	'filters.add_rule_hint': 'Klikoni "Shto rregull" për të filluar ndërtimin e pyetjes suaj',
+	'page.loading': 'Duke ngarkuar faqen...',
+	'page.no_content': 'Kjo faqe nuk ka përmbajtje.',
+	'modal.view_title': 'Shiko {label}',
+	'modal.view_record': 'Shiko "{title}"',
+	'auth.back_to_signin': 'Kthehu te hyrja',
+	'auth.providers_load_failed': 'Ngarkimi i ofruesve të autentifikimit dështoi',
+	'editor.insert_audio': 'Fut audio',
+	'editor.insert_embed': 'Fut përmbajtje',
+	'editor.html_source': 'Burimi HTML',
+	'filters.preset_today': 'Sot',
+	'filters.preset_yesterday': 'Dje',
+	'filters.preset_this_week': 'Këtë javë',
+	'filters.preset_this_month': 'Këtë muaj',
+	'filters.preset_this_year': 'Këtë vit',
+	'filters.preset_custom': 'I personalizuar',
+	'common.warning': 'Kujdes',
+	'state.unknown_field': 'Lloj fushe i panjohur "{type}" për fushën "{name}"',
+	'state.unknown_column': 'Lloj kolone i panjohur: {type}',
+	'error.connect': 'Lidhja me API dështoi',
+	'error.load_data': 'Ngarkimi i të dhënave dështoi',
+	'error.load_schema': 'Ngarkimi i skemës së tabelës dështoi',
+	'search.nav_navigate': 'Lëviz',
+	'search.nav_open': 'Hap',
+	'search.nav_close': 'Mbyll',
+	'common.clear_all': 'Pastro të gjitha',
+	'common.done': 'U krye',
+	'common.all': 'Të gjitha',
+	'common.try_again': 'Provo përsëri',
+	'common.details': 'Detaje',
+	'common.widgets': 'Vegla',
+	'filters.label_from': 'Nga',
+	'filters.label_to': 'Deri',
+	'filters.no_options': 'Nuk ka opsione',
+	'filters.clear_all_filters': 'Pastro të gjithë filtrat',
+	'filters.from_value': 'Nga {date}',
+	'filters.until_value': 'Deri {date}',
+	'filters.select_range': 'Zgjidhni intervalin e datave...',
+	'confirm.are_you_sure': 'Jeni i sigurt?',
+	'common.item': 'Artikull',
+	'form.submitted': 'Formulari u dërgua me sukses!',
+	'select.placeholder': 'Zgjidhni...',
+	'select.create_new': 'Krijo i ri',
+	'common.record': 'Regjistrim',
+	'editor.start_typing': 'Filloni të shkruani...',
+	'error.load_record': 'Ngarkimi i regjistrimit dështoi',
+	'error.load_page': 'Ngarkimi i faqes dështoi',
+	'file.video_preview': 'Pamja paraprake e videos',
+	'common.preview': 'Pamje paraprake',
+	'common.image': 'Imazh',
+	'common.file': 'Skedar',
+	'editor.rich_text_view': 'Pamja e tekstit të pasur',
+	'select.no_matching': 'Nuk u gjetën opsione përputhëse',
+	'table.switch_grid': 'Kalo në pamjen rrjetë',
+	'table.switch_table': 'Kalo në pamjen tabelë',
+	'table.hide_widgets': 'Fshih veglat',
+	'table.show_widgets': 'Shfaq veglat',
+	'error.action_failed': 'Ekzekutimi i veprimit dështoi',
+	'error.action_failed_bulk': 'Ekzekutimi i veprimit në masë dështoi',
+	'common.video_thumbnail': 'Miniatura e videos',
+	'common.error': 'Gabim',
+	'widget.data_label': 'Të dhëna',
+	'filters.advanced_search': 'Kërkim i avancuar',
+	'error.fetch_form_data': 'Marrja e të dhënave të formularit dështoi',
+	'error.fetch_form_data_generic': 'Ndodhi një gabim gjatë marrjes së të dhënave të formularit',
+	'error.submit_form': 'Dërgimi i formularit dështoi',
+	'error.generic': 'Ndodhi një gabim',
+	'error.export_failed': 'Eksportimi dështoi',
+	'error.delete_failed': 'Fshirja dështoi',
+	'error.bulk_action_failed': 'Veprimi në masë dështoi',
+};
+
+export default sq;

package/src/i18n/useFormatter.ts

@@ -0,0 +1,42 @@
+import { useMemo } from 'react';
+import { useI18nContext } from './I18nProvider';
+
+/**
+ * Locale-aware `Intl` formatters bound to the active locale. Re-created when the
+ * locale changes so dates, numbers, currency, and relative times all localize.
+ *
+ * @example
+ * const fmt = useFormatter();
+ * fmt.date(row.createdAt);          // 6/24/2026  /  24.6.2026
+ * fmt.currency(1234.5, 'EUR');      // €1,234.50
+ * fmt.relativeTime(-3, 'day');      // 3 days ago
+ */
+export function useFormatter() {
+	const { locale } = useI18nContext();
+
+	return useMemo(
+		() => ({
+			locale,
+			date(value: Date | string | number, options?: Intl.DateTimeFormatOptions): string {
+				return new Intl.DateTimeFormat(locale, options).format(new Date(value));
+			},
+			dateTime(value: Date | string | number, options?: Intl.DateTimeFormatOptions): string {
+				return new Intl.DateTimeFormat(locale, {
+					dateStyle: 'medium',
+					timeStyle: 'short',
+					...options,
+				}).format(new Date(value));
+			},
+			number(value: number, options?: Intl.NumberFormatOptions): string {
+				return new Intl.NumberFormat(locale, options).format(value);
+			},
+			currency(value: number, currency = 'USD', options?: Intl.NumberFormatOptions): string {
+				return new Intl.NumberFormat(locale, { style: 'currency', currency, ...options }).format(value);
+			},
+			relativeTime(value: number, unit: Intl.RelativeTimeFormatUnit): string {
+				return new Intl.RelativeTimeFormat(locale, { numeric: 'auto' }).format(value, unit);
+			},
+		}),
+		[locale],
+	);
+}

package/src/i18n/useLocale.ts

@@ -0,0 +1,16 @@
+import { useI18nContext } from './I18nProvider';
+
+/**
+ * Read and change the active UI locale.
+ *
+ * @example
+ * const { locale, setLocale, locales } = useLocale();
+ */
+export function useLocale(): {
+	locale: string;
+	setLocale: (locale: string) => void;
+	locales: string[];
+} {
+	const { locale, setLocale, locales } = useI18nContext();
+	return { locale, setLocale, locales };
+}

package/src/i18n/useTranslation.ts

@@ -0,0 +1,17 @@
+import { useI18nContext } from './I18nProvider';
+
+/**
+ * Access the active-locale translator inside a component.
+ *
+ * @example
+ * const { t, locale, dir } = useTranslation();
+ * return <button>{t('core:common.save')}</button>;
+ */
+export function useTranslation(): {
+	t: (key: string, params?: Record<string, unknown>) => string;
+	locale: string;
+	dir: 'ltr' | 'rtl';
+} {
+	const { t, locale, dir } = useI18nContext();
+	return { t, locale, dir };
+}