@zc-ui/locale 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ZC UI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("vue");function t(e,n=``){let r={};for(let[i,a]of Object.entries(e)){let e=n?`${n}.${i}`:i;typeof a==`object`&&a&&!Array.isArray(a)?Object.assign(r,t(a,e)):r[e]=String(a)}return r}function n(e,t){return t?e.replace(/\{(\w+)\}/g,(e,n)=>n in t?String(t[n]):e):e}var r={"common.confirm":`确定`,"common.cancel":`取消`,"common.loading":`加载中...`,"common.empty":`暂无数据`,"common.ok":`确定`,"common.save":`保存`,"common.delete":`删除`,"common.close":`关闭`,"zc.pagination.total":`共 {total} 条`,"zc.pagination.goto":`前往`,"zc.pagination.pageClassifier":`页`,"zc.empty.description":`暂无数据`,"zc.select.placeholder":`请选择`,"zc.select.noData":`暂无数据`,"zc.select.noMatch":`无匹配数据`,"zc.timePicker.placeholder":`请选择时间`,"zc.timePicker.startPlaceholder":`开始时间`,"zc.timePicker.endPlaceholder":`结束时间`,"zc.timePicker.rangeSeparator":`至`,"zc.autoComplete.placeholder":`请输入`,"zc.autoComplete.noData":`暂无数据`,"zc.autoComplete.searching":`搜索中...`,"zc.treeSelect.placeholder":`请选择`,"zc.treeSelect.searchPlaceholder":`搜索`,"zc.treeSelect.noData":`暂无数据`,"zc.cascader.placeholder":`请选择`,"zc.carousel.prev":`上一张`,"zc.carousel.next":`下一张`,"zc.carousel.indicator":`切换到第 {index} 张`,"zc.alert.close":`关闭`,"zc.backtop.backToTop":`返回顶部`,"zc.datePicker.placeholder":`请选择日期`,"zc.datePicker.startPlaceholder":`开始日期`,"zc.datePicker.endPlaceholder":`结束日期`,"zc.datePicker.year":`年`,"zc.datePicker.weekdays.sun":`日`,"zc.datePicker.weekdays.mon":`一`,"zc.datePicker.weekdays.tue":`二`,"zc.datePicker.weekdays.wed":`三`,"zc.datePicker.weekdays.thu":`四`,"zc.datePicker.weekdays.fri":`五`,"zc.datePicker.weekdays.sat":`六`,"zc.datePicker.months.jan":`一月`,"zc.datePicker.months.feb":`二月`,"zc.datePicker.months.mar":`三月`,"zc.datePicker.months.apr":`四月`,"zc.datePicker.months.may":`五月`,"zc.datePicker.months.jun":`六月`,"zc.datePicker.months.jul":`七月`,"zc.datePicker.months.aug":`八月`,"zc.datePicker.months.sep":`九月`,"zc.datePicker.months.oct":`十月`,"zc.datePicker.months.nov":`十一月`,"zc.datePicker.months.dec":`十二月`,"zc.mention.placeholder":`请输入内容`,"zc.upload.dragTip":`将文件拖到此处，或`,"zc.upload.clickToUpload":`点击上传`,"zc.form.required":`该字段为必填项`,"zc.form.min":`长度不能少于 {min}`,"zc.form.max":`长度不能超过 {max}`,"zc.form.pattern":`格式不正确`,"zc.form.validateFailed":`校验失败`,"zc.image.preview":`图片预览`,"zc.image.closePreview":`关闭预览`,"zc.image.zoomIn":`放大`,"zc.image.zoomOut":`缩小`,"zc.image.rotateLeft":`向左旋转`,"zc.image.rotateRight":`向右旋转`,"zc.rate.texts.1":`极差`,"zc.rate.texts.2":`失望`,"zc.rate.texts.3":`一般`,"zc.rate.texts.4":`满意`,"zc.rate.texts.5":`惊喜`,"zc.transfer.titleLeft":`列表 1`,"zc.transfer.titleRight":`列表 2`,"zc.transfer.filterPlaceholder":`请输入搜索内容`,"zc.transfer.noData":`暂无数据`,"zc.table.emptyText":`暂无数据`,"zc.tag.close":`移除标签`},i={"common.confirm":`Confirm`,"common.cancel":`Cancel`,"common.loading":`Loading...`,"common.empty":`No data`,"common.ok":`OK`,"common.save":`Save`,"common.delete":`Delete`,"common.close":`Close`,"zc.pagination.total":`Total {total}`,"zc.pagination.goto":`Go to`,"zc.pagination.pageClassifier":``,"zc.pagination.label":`Pagination`,"zc.empty.description":`No Data`,"zc.select.placeholder":`Please select`,"zc.select.noData":`No data`,"zc.select.noMatch":`No matching data`,"zc.timePicker.placeholder":`Select time`,"zc.timePicker.startPlaceholder":`Start time`,"zc.timePicker.endPlaceholder":`End time`,"zc.timePicker.rangeSeparator":`To`,"zc.autoComplete.placeholder":`Please input`,"zc.autoComplete.noData":`No data`,"zc.autoComplete.searching":`Searching...`,"zc.treeSelect.placeholder":`Please select`,"zc.treeSelect.searchPlaceholder":`Search`,"zc.treeSelect.noData":`No data`,"zc.cascader.placeholder":`Please select`,"zc.carousel.prev":`Previous`,"zc.carousel.next":`Next`,"zc.carousel.indicator":`Go to slide {index}`,"zc.alert.close":`Close`,"zc.backtop.backToTop":`Back to top`,"zc.datePicker.placeholder":`Select date`,"zc.datePicker.startPlaceholder":`Start date`,"zc.datePicker.endPlaceholder":`End date`,"zc.datePicker.year":``,"zc.datePicker.weekdays.sun":`Su`,"zc.datePicker.weekdays.mon":`Mo`,"zc.datePicker.weekdays.tue":`Tu`,"zc.datePicker.weekdays.wed":`We`,"zc.datePicker.weekdays.thu":`Th`,"zc.datePicker.weekdays.fri":`Fr`,"zc.datePicker.weekdays.sat":`Sa`,"zc.datePicker.months.jan":`January`,"zc.datePicker.months.feb":`February`,"zc.datePicker.months.mar":`March`,"zc.datePicker.months.apr":`April`,"zc.datePicker.months.may":`May`,"zc.datePicker.months.jun":`June`,"zc.datePicker.months.jul":`July`,"zc.datePicker.months.aug":`August`,"zc.datePicker.months.sep":`September`,"zc.datePicker.months.oct":`October`,"zc.datePicker.months.nov":`November`,"zc.datePicker.months.dec":`December`,"zc.mention.placeholder":`Please enter content`,"zc.upload.dragTip":`Drop files here, or `,"zc.upload.clickToUpload":`click to upload`,"zc.form.required":`This field is required`,"zc.form.min":`Length cannot be less than {min}`,"zc.form.max":`Length cannot be greater than {max}`,"zc.form.pattern":`Invalid format`,"zc.form.validateFailed":`Validation failed`,"zc.image.preview":`Image Preview`,"zc.image.closePreview":`Close preview`,"zc.image.zoomIn":`Zoom In`,"zc.image.zoomOut":`Zoom Out`,"zc.image.rotateLeft":`Rotate Left`,"zc.image.rotateRight":`Rotate Right`,"zc.rate.texts.1":`Very Bad`,"zc.rate.texts.2":`Disappointed`,"zc.rate.texts.3":`Normal`,"zc.rate.texts.4":`Satisfied`,"zc.rate.texts.5":`Surprised`,"zc.transfer.titleLeft":`List 1`,"zc.transfer.titleRight":`List 2`,"zc.transfer.filterPlaceholder":`Enter search content`,"zc.transfer.noData":`No data`,"zc.table.emptyText":`No Data`,"zc.tag.close":`Remove tag`},a=(0,e.ref)(`zh-CN`),o=(0,e.ref)(`zh-CN`),s=(0,e.reactive)({"zh-CN":{...r},"en-US":{...i}});function c(e){a.value=e}function l(){return a.value}function u(e){o.value=e}function d(){return o.value}function f(e,t){var r,i;let c=s[a.value],l=s[o.value];return n((r=(i=c==null?void 0:c[e])==null?l==null?void 0:l[e]:i)==null?e:r,t)}function p(e,n){let r=t(n);s[e]={...s[e],...r}}var m=Symbol(`zcLocale`);function h(){return(0,e.inject)(m,null)||{locale:(0,e.readonly)(a),t:f,setLocale:c,getLocale:l,setFallbackLocale:u,getFallbackLocale:d,register:p}}function g(t){return{install(n){if(t!=null&&t.locale&&c(t.locale),t!=null&&t.fallbackLocale&&u(t.fallbackLocale),t!=null&&t.messages)for(let[e,n]of Object.entries(t.messages))p(e,n);let r={locale:(0,e.readonly)(a),t:f,setLocale:c,getLocale:l,setFallbackLocale:u,getFallbackLocale:d,register:p};n.provide(m,r)}}}exports.createLocale=g,exports.getFallbackLocale=d,exports.getLocale=l,exports.localeInjectionKey=m,exports.register=p,exports.setFallbackLocale=u,exports.setLocale=c,exports.t=f,exports.useLocale=h;

package/dist/index.mjs

@@ -0,0 +1,235 @@
+import { inject as e, reactive as t, readonly as n, ref as r } from "vue";
+//#region src/dictionary.ts
+function i(e, t = "") {
+	let n = {};
+	for (let [r, a] of Object.entries(e)) {
+		let e = t ? `${t}.${r}` : r;
+		typeof a == "object" && a && !Array.isArray(a) ? Object.assign(n, i(a, e)) : n[e] = String(a);
+	}
+	return n;
+}
+//#endregion
+//#region src/translate.ts
+function a(e, t) {
+	return t ? e.replace(/\{(\w+)\}/g, (e, n) => n in t ? String(t[n]) : e) : e;
+}
+//#endregion
+//#region src/index.ts
+var o = {
+	"common.confirm": "确定",
+	"common.cancel": "取消",
+	"common.loading": "加载中...",
+	"common.empty": "暂无数据",
+	"common.ok": "确定",
+	"common.save": "保存",
+	"common.delete": "删除",
+	"common.close": "关闭",
+	"zc.pagination.total": "共 {total} 条",
+	"zc.pagination.goto": "前往",
+	"zc.pagination.pageClassifier": "页",
+	"zc.empty.description": "暂无数据",
+	"zc.select.placeholder": "请选择",
+	"zc.select.noData": "暂无数据",
+	"zc.select.noMatch": "无匹配数据",
+	"zc.timePicker.placeholder": "请选择时间",
+	"zc.timePicker.startPlaceholder": "开始时间",
+	"zc.timePicker.endPlaceholder": "结束时间",
+	"zc.timePicker.rangeSeparator": "至",
+	"zc.autoComplete.placeholder": "请输入",
+	"zc.autoComplete.noData": "暂无数据",
+	"zc.autoComplete.searching": "搜索中...",
+	"zc.treeSelect.placeholder": "请选择",
+	"zc.treeSelect.searchPlaceholder": "搜索",
+	"zc.treeSelect.noData": "暂无数据",
+	"zc.cascader.placeholder": "请选择",
+	"zc.carousel.prev": "上一张",
+	"zc.carousel.next": "下一张",
+	"zc.carousel.indicator": "切换到第 {index} 张",
+	"zc.alert.close": "关闭",
+	"zc.backtop.backToTop": "返回顶部",
+	"zc.datePicker.placeholder": "请选择日期",
+	"zc.datePicker.startPlaceholder": "开始日期",
+	"zc.datePicker.endPlaceholder": "结束日期",
+	"zc.datePicker.year": "年",
+	"zc.datePicker.weekdays.sun": "日",
+	"zc.datePicker.weekdays.mon": "一",
+	"zc.datePicker.weekdays.tue": "二",
+	"zc.datePicker.weekdays.wed": "三",
+	"zc.datePicker.weekdays.thu": "四",
+	"zc.datePicker.weekdays.fri": "五",
+	"zc.datePicker.weekdays.sat": "六",
+	"zc.datePicker.months.jan": "一月",
+	"zc.datePicker.months.feb": "二月",
+	"zc.datePicker.months.mar": "三月",
+	"zc.datePicker.months.apr": "四月",
+	"zc.datePicker.months.may": "五月",
+	"zc.datePicker.months.jun": "六月",
+	"zc.datePicker.months.jul": "七月",
+	"zc.datePicker.months.aug": "八月",
+	"zc.datePicker.months.sep": "九月",
+	"zc.datePicker.months.oct": "十月",
+	"zc.datePicker.months.nov": "十一月",
+	"zc.datePicker.months.dec": "十二月",
+	"zc.mention.placeholder": "请输入内容",
+	"zc.upload.dragTip": "将文件拖到此处，或",
+	"zc.upload.clickToUpload": "点击上传",
+	"zc.form.required": "该字段为必填项",
+	"zc.form.min": "长度不能少于 {min}",
+	"zc.form.max": "长度不能超过 {max}",
+	"zc.form.pattern": "格式不正确",
+	"zc.form.validateFailed": "校验失败",
+	"zc.image.preview": "图片预览",
+	"zc.image.closePreview": "关闭预览",
+	"zc.image.zoomIn": "放大",
+	"zc.image.zoomOut": "缩小",
+	"zc.image.rotateLeft": "向左旋转",
+	"zc.image.rotateRight": "向右旋转",
+	"zc.rate.texts.1": "极差",
+	"zc.rate.texts.2": "失望",
+	"zc.rate.texts.3": "一般",
+	"zc.rate.texts.4": "满意",
+	"zc.rate.texts.5": "惊喜",
+	"zc.transfer.titleLeft": "列表 1",
+	"zc.transfer.titleRight": "列表 2",
+	"zc.transfer.filterPlaceholder": "请输入搜索内容",
+	"zc.transfer.noData": "暂无数据",
+	"zc.table.emptyText": "暂无数据",
+	"zc.tag.close": "移除标签"
+}, s = {
+	"common.confirm": "Confirm",
+	"common.cancel": "Cancel",
+	"common.loading": "Loading...",
+	"common.empty": "No data",
+	"common.ok": "OK",
+	"common.save": "Save",
+	"common.delete": "Delete",
+	"common.close": "Close",
+	"zc.pagination.total": "Total {total}",
+	"zc.pagination.goto": "Go to",
+	"zc.pagination.pageClassifier": "",
+	"zc.pagination.label": "Pagination",
+	"zc.empty.description": "No Data",
+	"zc.select.placeholder": "Please select",
+	"zc.select.noData": "No data",
+	"zc.select.noMatch": "No matching data",
+	"zc.timePicker.placeholder": "Select time",
+	"zc.timePicker.startPlaceholder": "Start time",
+	"zc.timePicker.endPlaceholder": "End time",
+	"zc.timePicker.rangeSeparator": "To",
+	"zc.autoComplete.placeholder": "Please input",
+	"zc.autoComplete.noData": "No data",
+	"zc.autoComplete.searching": "Searching...",
+	"zc.treeSelect.placeholder": "Please select",
+	"zc.treeSelect.searchPlaceholder": "Search",
+	"zc.treeSelect.noData": "No data",
+	"zc.cascader.placeholder": "Please select",
+	"zc.carousel.prev": "Previous",
+	"zc.carousel.next": "Next",
+	"zc.carousel.indicator": "Go to slide {index}",
+	"zc.alert.close": "Close",
+	"zc.backtop.backToTop": "Back to top",
+	"zc.datePicker.placeholder": "Select date",
+	"zc.datePicker.startPlaceholder": "Start date",
+	"zc.datePicker.endPlaceholder": "End date",
+	"zc.datePicker.year": "",
+	"zc.datePicker.weekdays.sun": "Su",
+	"zc.datePicker.weekdays.mon": "Mo",
+	"zc.datePicker.weekdays.tue": "Tu",
+	"zc.datePicker.weekdays.wed": "We",
+	"zc.datePicker.weekdays.thu": "Th",
+	"zc.datePicker.weekdays.fri": "Fr",
+	"zc.datePicker.weekdays.sat": "Sa",
+	"zc.datePicker.months.jan": "January",
+	"zc.datePicker.months.feb": "February",
+	"zc.datePicker.months.mar": "March",
+	"zc.datePicker.months.apr": "April",
+	"zc.datePicker.months.may": "May",
+	"zc.datePicker.months.jun": "June",
+	"zc.datePicker.months.jul": "July",
+	"zc.datePicker.months.aug": "August",
+	"zc.datePicker.months.sep": "September",
+	"zc.datePicker.months.oct": "October",
+	"zc.datePicker.months.nov": "November",
+	"zc.datePicker.months.dec": "December",
+	"zc.mention.placeholder": "Please enter content",
+	"zc.upload.dragTip": "Drop files here, or ",
+	"zc.upload.clickToUpload": "click to upload",
+	"zc.form.required": "This field is required",
+	"zc.form.min": "Length cannot be less than {min}",
+	"zc.form.max": "Length cannot be greater than {max}",
+	"zc.form.pattern": "Invalid format",
+	"zc.form.validateFailed": "Validation failed",
+	"zc.image.preview": "Image Preview",
+	"zc.image.closePreview": "Close preview",
+	"zc.image.zoomIn": "Zoom In",
+	"zc.image.zoomOut": "Zoom Out",
+	"zc.image.rotateLeft": "Rotate Left",
+	"zc.image.rotateRight": "Rotate Right",
+	"zc.rate.texts.1": "Very Bad",
+	"zc.rate.texts.2": "Disappointed",
+	"zc.rate.texts.3": "Normal",
+	"zc.rate.texts.4": "Satisfied",
+	"zc.rate.texts.5": "Surprised",
+	"zc.transfer.titleLeft": "List 1",
+	"zc.transfer.titleRight": "List 2",
+	"zc.transfer.filterPlaceholder": "Enter search content",
+	"zc.transfer.noData": "No data",
+	"zc.table.emptyText": "No Data",
+	"zc.tag.close": "Remove tag"
+}, c = r("zh-CN"), l = r("zh-CN"), u = t({
+	"zh-CN": { ...o },
+	"en-US": { ...s }
+});
+function d(e) {
+	c.value = e;
+}
+function f() {
+	return c.value;
+}
+function p(e) {
+	l.value = e;
+}
+function m() {
+	return l.value;
+}
+function h(e, t) {
+	var n, r;
+	let i = u[c.value], o = u[l.value];
+	return a((n = (r = i == null ? void 0 : i[e]) == null ? o == null ? void 0 : o[e] : r) == null ? e : n, t);
+}
+function g(e, t) {
+	let n = i(t);
+	u[e] = {
+		...u[e],
+		...n
+	};
+}
+var _ = Symbol("zcLocale");
+function v() {
+	return e(_, null) || {
+		locale: n(c),
+		t: h,
+		setLocale: d,
+		getLocale: f,
+		setFallbackLocale: p,
+		getFallbackLocale: m,
+		register: g
+	};
+}
+function y(e) {
+	return { install(t) {
+		if (e != null && e.locale && d(e.locale), e != null && e.fallbackLocale && p(e.fallbackLocale), e != null && e.messages) for (let [t, n] of Object.entries(e.messages)) g(t, n);
+		let r = {
+			locale: n(c),
+			t: h,
+			setLocale: d,
+			getLocale: f,
+			setFallbackLocale: p,
+			getFallbackLocale: m,
+			register: g
+		};
+		t.provide(_, r);
+	} };
+}
+//#endregion
+export { y as createLocale, m as getFallbackLocale, f as getLocale, _ as localeInjectionKey, g as register, p as setFallbackLocale, d as setLocale, h as t, v as useLocale };

package/dist/types/__tests__/composable.spec.d.ts

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

package/dist/types/__tests__/composable.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composable.spec.d.ts","sourceRoot":"","sources":["../../../src/__tests__/composable.spec.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/dictionary.spec.d.ts

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

package/dist/types/__tests__/dictionary.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.spec.d.ts","sourceRoot":"","sources":["../../../src/__tests__/dictionary.spec.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/index.spec.d.ts

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

package/dist/types/__tests__/index.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.spec.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.spec.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/translate.spec.d.ts

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

package/dist/types/__tests__/translate.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.spec.d.ts","sourceRoot":"","sources":["../../../src/__tests__/translate.spec.ts"],"names":[],"mappings":""}

package/dist/types/dictionary.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Recursively flatten a nested dictionary into dot-notation keys.
+ *
+ * Both nested objects (`{ button: { confirm: '确定' } }`) and already-flat
+ * keys (`{ 'button.confirm': '确定' }`) are supported. The result is always
+ * a flat `Record<string, string>`.
+ *
+ * @example
+ * flatten({ button: { confirm: '确定' } })
+ * // → { 'button.confirm': '确定' }
+ */
+export declare function flatten(dict: Record<string, unknown>, prefix?: string): Record<string, string>;
+//# sourceMappingURL=dictionary.d.ts.map

package/dist/types/dictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../../src/dictionary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,SAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAc1F"}

package/dist/types/index.d.ts

@@ -0,0 +1,108 @@
+import { Ref, InjectionKey, Plugin } from 'vue';
+/** Language code. Defaults to 'zh-CN' / 'en-US'; any string is valid. */
+export type Language = string;
+/** Dictionary value: a string or a nested dictionary object. */
+export interface LocaleDictionary {
+    [key: string]: string | LocaleDictionary;
+}
+/** Named interpolation parameters. */
+export type TranslateOptions = Record<string, string | number>;
+/** Locale context exposed via provide/inject and useLocale(). */
+export interface LocaleContext {
+    /** Reactive current language (read-only) */
+    locale: Readonly<Ref<Language>>;
+    /** Translate a key with optional named parameters */
+    t: (key: string, options?: TranslateOptions) => string;
+    /** Set the current language */
+    setLocale: (lang: Language) => void;
+    /** Get the current language */
+    getLocale: () => Language;
+    /** Set the fallback language (used when a key is missing in current locale) */
+    setFallbackLocale: (lang: Language) => void;
+    /** Get the fallback language */
+    getFallbackLocale: () => Language;
+    /** Register/extend a language pack */
+    register: (lang: Language, dict: LocaleDictionary) => void;
+}
+/**
+ * Set the current language (reactive).
+ */
+export declare function setLocale(lang: Language): void;
+/**
+ * Get the current language.
+ */
+export declare function getLocale(): Language;
+/**
+ * Set the fallback language used when a key is missing in the current locale.
+ * Defaults to 'zh-CN'.
+ */
+export declare function setFallbackLocale(lang: Language): void;
+/**
+ * Get the fallback language.
+ */
+export declare function getFallbackLocale(): Language;
+/**
+ * Translate a key for the current language.
+ *
+ * Lookup order:
+ * 1. Current locale dictionary
+ * 2. Fallback locale dictionary (default: 'zh-CN')
+ * 3. The key itself (raw)
+ *
+ * Supports named parameter interpolation via options.
+ *
+ * @example
+ * t('common.confirm')                     // '确定'
+ * t('welcome', { name: '张三' })          // '欢迎, 张三'
+ */
+export declare function t(key: string, options?: TranslateOptions): string;
+/**
+ * Register or extend a language pack.
+ * Nested objects are flattened to dot-notation keys.
+ * If the language already exists, new keys are merged in.
+ *
+ * @example
+ * register('ja-JP', { common: { confirm: '確認' } })
+ * register('zh-CN', { 'custom.key': '自定义' })
+ */
+export declare function register(lang: Language, dict: LocaleDictionary): void;
+/** Injection key for locale context */
+export declare const localeInjectionKey: InjectionKey<LocaleContext>;
+/**
+ * Access the locale context within a component.
+ *
+ * **Must be called inside a component `setup()` function.** When called
+ * within a provide tree (i.e. after `app.use(createLocale())`), it returns
+ * the injected context. As a fallback for non-component usage (e.g. in
+ * utility modules), it returns the module-level singleton context — note
+ * that this fallback will trigger a Vue dev-mode warning about `inject()`
+ * being called outside setup, which can be safely ignored.
+ *
+ * @example
+ * // In a component setup:
+ * const { t, locale, setLocale } = useLocale()
+ * t('common.confirm')   // '确定'
+ * setLocale('en-US')    // reactive switch
+ */
+export declare function useLocale(): LocaleContext;
+/**
+ * Create a locale plugin with optional initial configuration.
+ *
+ * @example
+ * import { createLocale } from '@zc-ui/locale'
+ * app.use(createLocale({ locale: 'en-US' }))
+ *
+ * @example
+ * // With custom messages and fallback
+ * app.use(createLocale({
+ *   locale: 'en-US',
+ *   fallbackLocale: 'zh-CN',
+ *   messages: { 'ja-JP': { common: { ok: 'OK' } } }
+ * }))
+ */
+export declare function createLocale(options?: {
+    locale?: Language;
+    fallbackLocale?: Language;
+    messages?: Record<Language, LocaleDictionary>;
+}): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAmC,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,KAAK,CAAA;AAClF,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAA;AAQtC,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAA;CACzC;AAED,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAE9D,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC/B,qDAAqD;IACrD,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAA;IACtD,+BAA+B;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,QAAQ,CAAA;IACzB,+EAA+E;IAC/E,iBAAiB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC3C,gCAAgC;IAChC,iBAAiB,EAAE,MAAM,QAAQ,CAAA;IACjC,sCAAsC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAC3D;AAqMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAEpC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,QAAQ,CAE5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAKjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAGrE;AAMD,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,aAAa,CAAsB,CAAA;AAMjF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAazC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACrC,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,cAAc,CAAC,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;CAC9C,GAAG,MAAM,CA4BT"}

package/dist/types/translate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Replace `{name}` placeholders in a template string with provided values.
+ *
+ * Placeholders not present in `options` are left as-is.
+ *
+ * @example
+ * interpolate('Hello, {name}!', { name: 'World' })  // 'Hello, World!'
+ */
+export declare function interpolate(template: string, options?: Record<string, string | number>): string;
+//# sourceMappingURL=translate.d.ts.map

package/dist/types/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../src/translate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAM/F"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@zc-ui/locale",
+  "version": "0.0.1",
+  "description": "ZC UI internationalization (i18n)",
+  "license": "MIT",
+  "author": "ZC UI Team",
+  "homepage": "https://zc-ui.github.io/zc-ui",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zc-ui/zc-ui.git",
+    "directory": "packages/locale"
+  },
+  "bugs": {
+    "url": "https://github.com/zc-ui/zc-ui/issues"
+  },
+  "keywords": [
+    "vue",
+    "ui",
+    "i18n",
+    "locale",
+    "internationalization",
+    "zc-ui"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json"
+  }
+}