@yozora-tech/qfluent 0.1.1 → 0.1.2

package/lib/qfluent/context.qwik.mjs

@@ -1,173 +1,177 @@
-import { createContextId, useContext, componentQrl, inlinedQrl, useSignal, useContextProvider, useOnDocument, _captures, useTaskQrl, noSerialize, isServer, _jsxSorted, Slot } from "@qwik.dev/core";
+import { Slot, _captures, _jsxSorted, componentQrl, createContextId, inlinedQrl, isServer, noSerialize, useContext, useContextProvider, useOnDocument, useSignal, useTaskQrl } from "@qwik.dev/core";
 import { FluentBundle, FluentResource } from "@fluent/bundle";
-const FluentLocalesId = createContextId("QwikFluentLocales");
-const FluentResourcesId = createContextId("QwikFluentResources");
-const FluentBundlesId = createContextId("QwikFluentBundles");
-const FluentErrorsId = createContextId("QwikFluentErrors");
-function useFluentLocales() {
-  return useContext(FluentLocalesId);
+/** @internal */ var FluentLocalesId = createContextId("QwikFluentLocales");
+/** @internal */ var FluentResourcesId = createContextId("QwikFluentResources");
+/** @internal */ var FluentBundlesId = createContextId("QwikFluentBundles");
+/** @internal */ var FluentErrorsId = createContextId("QwikFluentErrors");
+/**
+* Signal to list of preferred locales. Translations are picked from these languages, with fallbacks as needed.
+*
+* Normally you want to set this to `preferred_languages.concat(navigator.languages)`.
+*
+* ```tsx
+* const locales = useFluentLocales();
+* return (
+*   <select onChange$={(event, select) => {
+*     locales.value = [select.value].concat(navigator.languages);
+*   }}>
+*     <option value="ar">Arabic</option>
+*     <option value="en">English</option>
+*     <option value="ja">Japanese</option>
+*     ...
+*   </select>
+* );
+* ```
+*/ function useFluentLocales() {
+	return useContext(FluentLocalesId);
 }
-function useFluentResources() {
-  return useContext(FluentResourcesId);
+/**
+* Includes your resources and compiled FluentBundles by locales.
+*
+* You can make use of your custom resource properties with this.
+*/ function useFluentResources() {
+	return useContext(FluentResourcesId);
 }
-function useFluentErrors() {
-  return useContext(FluentErrorsId);
+/**
+* Useful for debugging errors in resources.
+*
+* You can clear the errors after use.
+*/ function useFluentErrors() {
+	return useContext(FluentErrorsId);
 }
 function ataToUtf8(pathname) {
-  const label = ";base64,";
-  const a = pathname.indexOf(label);
-  if (a === -1) {
-    throw new Error("Invalid ata url pathname: " + pathname);
-  }
-  const binaryString = atob(pathname.slice(a + label.length));
-  const bytes = new Uint8Array(binaryString.length);
-  for (let i = 0; i < binaryString.length; i++) {
-    bytes[i] = binaryString.charCodeAt(i);
-  }
-  return new TextDecoder().decode(bytes);
+	const a = pathname.indexOf(";base64,");
+	if (a === -1) throw new Error("Invalid ata url pathname: " + pathname);
+	const binaryString = atob(pathname.slice(a + 8));
+	const bytes = new Uint8Array(binaryString.length);
+	for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
+	return new TextDecoder().decode(bytes);
 }
-const FluentProvider = /* @__PURE__ */ componentQrl(/* @__PURE__ */ inlinedQrl((_rawProps) => {
-  const locales = useSignal(_rawProps.acceptLanguage ?? [
-    "en"
-  ]);
-  const bunmap = useSignal({});
-  const resmap = useSignal({});
-  const errors = useSignal([]);
-  useContextProvider(FluentLocalesId, locales);
-  useContextProvider(FluentBundlesId, bunmap);
-  useContextProvider(FluentResourcesId, resmap);
-  useContextProvider(FluentErrorsId, errors);
-  const ssr = useSignal(true);
-  useOnDocument("load", /* @__PURE__ */ inlinedQrl(() => {
-    const locales2 = _captures[0], ssr2 = _captures[1];
-    if (!ssr2.value) return;
-    ssr2.value = false;
-    locales2.value = navigator.languages.concat();
-  }, "FluentProvider_component_useOnDocument_9BL0L0WgLlY", [
-    locales,
-    ssr
-  ]));
-  useTaskQrl(/* @__PURE__ */ inlinedQrl((_rawProps1) => {
-    const _rawProps2 = _captures[0], bunmap2 = _captures[1], errors2 = _captures[2], locales2 = _captures[3], resmap2 = _captures[4], ssr2 = _captures[5];
-    _rawProps1.track(locales2);
-    _rawProps1.track(ssr2);
-    if (!bunmap2.value) {
-      bunmap2.value = {};
-    }
-    if (!resmap2.value) {
-      resmap2.value = {};
-    }
-    if (!errors2.value) {
-      errors2.value = [];
-    }
-    const res = noSerialize(resmap2.value);
-    const bun = noSerialize(bunmap2.value);
-    const promises = [];
-    const whitelist = locales2.value;
-    let has_errors = false;
-    for (const r of _rawProps2.resources) {
-      let ok = false;
-      for (const x of r.locales) {
-        if (res[x]) {
-          break;
-        }
-        if (whitelist.includes(x)) {
-          ok = true;
-          break;
-        }
-      }
-      if (!ok) {
-        continue;
-      }
-      const b = new FluentBundle(r.locales);
-      for (const x of r.locales) {
-        res[x] = r;
-        bun[x] = b;
-      }
-      for (const url of r.resources) {
-        let promise;
-        if (isServer) {
-          let path = url.toString().slice(1);
-          {
-            path = new URL(path, new URL("../dist/", _rawProps2.origin));
-          }
-          if (path.protocol === "ata:") {
-            promise = new Promise((resolve, reject) => {
-              try {
-                resolve(ataToUtf8(path.pathname));
-              } catch (err) {
-                reject(err);
-              }
-            });
-          } else {
-            promise = import("node:fs/promises").then((fs) => fs.readFile(path.pathname)).then((buf) => new TextDecoder().decode(buf));
-          }
-        } else {
-          promise = fetch(url).then((resp) => resp.text());
-        }
-        promises.push(promise.then((s) => {
-          const errset = b.addResource(new FluentResource(s));
-          if (errset.length) {
-            errors2.value.push({
-              resource: r,
-              errors: errset
-            });
-            has_errors = true;
-            console.error(`[qfluent] Errors in resource ${url}:`, errset);
-          }
-        }));
-      }
-    }
-    return Promise.all(promises).then(() => {
-      bunmap2.trigger();
-      resmap2.trigger();
-      if (has_errors) {
-        errors2.trigger();
-      }
-    });
-  }, "FluentProvider_component_useTask_0r0LUJYLJnU", [
-    _rawProps,
-    bunmap,
-    errors,
-    locales,
-    resmap,
-    ssr
-  ]));
-  useTaskQrl(/* @__PURE__ */ inlinedQrl(({ track }) => {
-    const locales2 = _captures[0], resmap2 = _captures[1], ssr2 = _captures[2];
-    if (track(ssr2)) return;
-    if (!track(resmap2)) return;
-    track(locales2);
-    const root = document.querySelector("html");
-    if (!root) return;
-    for (const l of locales2.value) {
-      const b = resmap2.value[l];
-      if (!b) {
-        continue;
-      }
-      root.lang = l;
-      const dir = b.dir;
-      if (dir) {
-        root.dir = dir;
-      } else {
-        root.dir = "";
-      }
-      break;
-    }
-  }, "FluentProvider_component_useTask_1_GdWGQNUVI4g", [
-    locales,
-    resmap,
-    ssr
-  ]));
-  return /* @__PURE__ */ _jsxSorted(Slot, null, null, null, 3, "76_0");
+/**
+* Use this in `src/root.tsx`.
+*
+* ```tsx
+* <body>
+*   <FluentProvider resources={...}>
+*     <RouterOutlet />
+*   </FluentProvider>
+* </body>
+* ```
+*/ var FluentProvider = /*#__PURE__*/ componentQrl(/*#__PURE__*/ inlinedQrl((_rawProps) => {
+	const locales = useSignal(_rawProps.acceptLanguage ?? ["en"]);
+	const bunmap = useSignal(noSerialize({}));
+	const resmap = useSignal(noSerialize({}));
+	const errors = useSignal(noSerialize([]));
+	useContextProvider(FluentLocalesId, locales);
+	useContextProvider(FluentBundlesId, bunmap);
+	useContextProvider(FluentResourcesId, resmap);
+	useContextProvider(FluentErrorsId, errors);
+	const ssr = useSignal(true);
+	useOnDocument("load", /*#__PURE__*/ inlinedQrl(() => {
+		const locales = _captures[0], ssr = _captures[1];
+		if (!ssr.value) return;
+		ssr.value = false;
+		locales.value = navigator.languages.concat();
+	}, "FluentProvider_component_useOnDocument_9BL0L0WgLlY", [locales, ssr]));
+	useTaskQrl(/*#__PURE__*/ inlinedQrl((_rawProps1) => {
+		const _rawProps = _captures[0], bunmap = _captures[1], errors = _captures[2], locales = _captures[3], resmap = _captures[4], ssr = _captures[5];
+		_rawProps1.track(locales);
+		_rawProps1.track(ssr);
+		if (!bunmap.value) bunmap.value = noSerialize({});
+		if (!resmap.value) resmap.value = noSerialize({});
+		if (!errors.value) errors.value = noSerialize([]);
+		const res = noSerialize(resmap.value);
+		const bun = noSerialize(bunmap.value);
+		const promises = [];
+		const whitelist = locales.value;
+		let has_errors = false;
+		for (const r of _rawProps.resources) {
+			let ok = false;
+			for (const x of r.locales) {
+				if (res[x]) break;
+				if (whitelist.includes(x)) {
+					ok = true;
+					break;
+				}
+			}
+			if (!ok) continue;
+			const b = new FluentBundle(r.locales);
+			for (const x of r.locales) {
+				res[x] = r;
+				bun[x] = b;
+			}
+			for (const url of r.resources) {
+				let promise;
+				if (isServer) {
+					const rel = url.toString().slice(1);
+					const candidates = [new URL("../dist/", _rawProps.origin), _rawProps.origin].map((base) => new URL(rel, base));
+					const ata = candidates.find((c) => c.protocol === "ata:");
+					if (ata) promise = new Promise((resolve, reject) => {
+						try {
+							resolve(ataToUtf8(ata.pathname));
+						} catch (err) {
+							reject(err);
+						}
+					});
+					else promise = import("node:fs/promises").then(async (fs) => {
+						const { fileURLToPath } = await import("node:url");
+						let firstError;
+						for (const c of candidates) try {
+							const buf = await fs.readFile(c.protocol === "file:" ? fileURLToPath(c) : c.pathname);
+							return new TextDecoder().decode(buf);
+						} catch (err) {
+							if (firstError === void 0) firstError = err;
+						}
+						throw firstError;
+					});
+				} else promise = fetch(url).then((resp) => resp.text());
+				promises.push(promise.then((s) => {
+					const errset = b.addResource(new FluentResource(s));
+					if (errset.length) {
+						errors.value.push({
+							resource: r,
+							errors: errset
+						});
+						has_errors = true;
+						console.error(`[qfluent] Errors in resource ${url}:`, errset);
+					}
+				}));
+			}
+		}
+		return Promise.all(promises).then(() => {
+			bunmap.trigger();
+			resmap.trigger();
+			if (has_errors) errors.trigger();
+		});
+	}, "FluentProvider_component_useTask_0r0LUJYLJnU", [
+		_rawProps,
+		bunmap,
+		errors,
+		locales,
+		resmap,
+		ssr
+	]));
+	useTaskQrl(/*#__PURE__*/ inlinedQrl(({ track }) => {
+		const locales = _captures[0], resmap = _captures[1], ssr = _captures[2];
+		if (track(ssr)) return;
+		if (!track(resmap)) return;
+		track(locales);
+		const root = document.querySelector("html");
+		if (!root) return;
+		for (const l of locales.value) {
+			const b = resmap.value[l];
+			if (!b) continue;
+			root.lang = l;
+			const dir = b.dir;
+			if (dir) root.dir = dir;
+			else root.dir = "";
+			break;
+		}
+	}, "FluentProvider_component_useTask_1_GdWGQNUVI4g", [
+		locales,
+		resmap,
+		ssr
+	]));
+	return /*#__PURE__*/ _jsxSorted(Slot, null, null, null, 3, "76_0");
 }, "FluentProvider_component_LWfKAJ3jVqM"));
-export {
-  FluentBundlesId,
-  FluentErrorsId,
-  FluentLocalesId,
-  FluentProvider,
-  FluentResourcesId,
-  useFluentErrors,
-  useFluentLocales,
-  useFluentResources
-};
+export { FluentBundlesId, FluentErrorsId, FluentLocalesId, FluentProvider, FluentResourcesId, useFluentErrors, useFluentLocales, useFluentResources };

package/lib/qfluent/tools.qwik.cjs

@@ -1,13 +1,18 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-function parseAcceptLanguage(header) {
-  return header.split(",").map((entry) => {
-    const [locale, ...params] = entry.split(";");
-    const q = params.find((p) => p.trim().startsWith("q="));
-    return {
-      locale: locale.trim(),
-      q: q ? parseFloat(q.split("=")[1]) : 1
-    };
-  }).filter((x) => x.locale).sort((a, b) => b.q - a.q).map((x) => x.locale);
+/**
+* Parse an `Accept-Language` header as array of locales, sorted by quality value.
+*
+* ```ts
+* parseAcceptLanguage("en-US;q=0.3, ja, zh-CN;q=0.9, zh;q=0.7")
+* // [ "ja", "zh-CN", "zh", "en-US" ]
+* ```
+*/ function parseAcceptLanguage(header) {
+	return header.split(",").map((entry) => {
+		const [locale, ...params] = entry.split(";");
+		const q = params.find((p) => p.trim().startsWith("q="));
+		return {
+			locale: locale.trim(),
+			q: q ? parseFloat(q.split("=")[1]) : 1
+		};
+	}).filter((x) => x.locale).sort((a, b) => b.q - a.q).map((x) => x.locale);
 }
 exports.parseAcceptLanguage = parseAcceptLanguage;

package/lib/qfluent/tools.qwik.mjs

@@ -1,13 +1,18 @@
-function parseAcceptLanguage(header) {
-  return header.split(",").map((entry) => {
-    const [locale, ...params] = entry.split(";");
-    const q = params.find((p) => p.trim().startsWith("q="));
-    return {
-      locale: locale.trim(),
-      q: q ? parseFloat(q.split("=")[1]) : 1
-    };
-  }).filter((x) => x.locale).sort((a, b) => b.q - a.q).map((x) => x.locale);
+/**
+* Parse an `Accept-Language` header as array of locales, sorted by quality value.
+*
+* ```ts
+* parseAcceptLanguage("en-US;q=0.3, ja, zh-CN;q=0.9, zh;q=0.7")
+* // [ "ja", "zh-CN", "zh", "en-US" ]
+* ```
+*/ function parseAcceptLanguage(header) {
+	return header.split(",").map((entry) => {
+		const [locale, ...params] = entry.split(";");
+		const q = params.find((p) => p.trim().startsWith("q="));
+		return {
+			locale: locale.trim(),
+			q: q ? parseFloat(q.split("=")[1]) : 1
+		};
+	}).filter((x) => x.locale).sort((a, b) => b.q - a.q).map((x) => x.locale);
 }
-export {
-  parseAcceptLanguage
-};
+export { parseAcceptLanguage };

package/lib/qfluent/translate.qwik.cjs

@@ -1,87 +1,86 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const core = require("@qwik.dev/core");
-const context = require("./context.qwik.cjs");
+const require_context = require("./context.qwik.cjs");
+let _qwik_dev_core = require("@qwik.dev/core");
 function wrapArgs(args) {
-  switch (typeof args) {
-    case "string":
-    case "number":
-    case "bigint":
-    case "boolean":
-      return {
-        x: args
-      };
-    case "undefined":
-      return {
-        x: "undefined"
-      };
-    case "object":
-      if (args === null) {
-        return {
-          x: "null"
-        };
-      }
-      return args;
-    default:
-      return {
-        x: String(args)
-      };
-  }
+	switch (typeof args) {
+		case "string":
+		case "number":
+		case "bigint":
+		case "boolean": return { x: args };
+		case "undefined": return { x: "undefined" };
+		case "object":
+			if (args === null) return { x: "null" };
+			return args;
+		default: return { x: String(args) };
+	}
 }
 function dummyT(s, args) {
-  return s + (args ? " + " + args : "");
+	return s + (args ? " + " + args : "");
 }
-function useT(s, args) {
-  const locales = context.useFluentLocales();
-  const bundles = core.useContext(context.FluentBundlesId);
-  const message = core.useComputedQrl(/* @__PURE__ */ core.inlinedQrl(() => {
-    const args2 = core._captures[0], bundles2 = core._captures[1], locales2 = core._captures[2], s2 = core._captures[3];
-    const value = args2?.value;
-    const placeholder = dummyT(s2, value);
-    const wargs = wrapArgs(value);
-    if (!bundles2.value) {
-      return placeholder;
-    }
-    for (const k of locales2.value) {
-      const b = bundles2.value[k];
-      if (!b) {
-        continue;
-      }
-      const m = b.getMessage(s2);
-      if (!m || !m.value) {
-        continue;
-      }
-      return b.formatPattern(m.value, wargs);
-    }
-    return placeholder;
-  }, "useT_message_useComputed_S0G7htNeJXI", [
-    args,
-    bundles,
-    locales,
-    s
-  ]));
-  return message;
+/**
+* Return a reactive signal to a translated string.
+*
+* Useful for non-DOM use cases (like `document.title`, see `useLocalizedTitle`).
+*
+* ```ts
+* const t = useT("my-title");
+* useTask$(({ track }) => {
+*   track(t);
+*   document.title = t.value;
+* });
+* ```
+*/ function useT(s, args) {
+	const locales = require_context.useFluentLocales();
+	const bundles = (0, _qwik_dev_core.useContext)(require_context.FluentBundlesId);
+	return (0, _qwik_dev_core.useComputedQrl)(/*#__PURE__*/ (0, _qwik_dev_core.inlinedQrl)(() => {
+		const args = _qwik_dev_core._captures[0], bundles = _qwik_dev_core._captures[1], locales = _qwik_dev_core._captures[2], s = _qwik_dev_core._captures[3];
+		const value = args?.value;
+		const placeholder = dummyT(s, value);
+		const wargs = wrapArgs(value);
+		if (!bundles.value) return placeholder;
+		for (const k of locales.value) {
+			const b = bundles.value[k];
+			if (!b) continue;
+			const m = b.getMessage(s);
+			if (!m || !m.value) continue;
+			return b.formatPattern(m.value, wargs);
+		}
+		return placeholder;
+	}, "useT_message_useComputed_S0G7htNeJXI", [
+		args,
+		bundles,
+		locales,
+		s
+	]));
 }
-const T = /* @__PURE__ */ core.componentQrl(/* @__PURE__ */ core.inlinedQrl((_rawProps) => {
-  return useT(_rawProps.s, _rawProps.args).value;
+/**
+* Translate a string in TSX idiom.
+*
+* Pass a signal for `args`.
+*
+* ```tsx
+* const x = useSignal(1);
+* return <T s="x-apples" args={x} />;
+* ```
+*/ var T = /*#__PURE__*/ (0, _qwik_dev_core.componentQrl)(/*#__PURE__*/ (0, _qwik_dev_core.inlinedQrl)((_rawProps) => {
+	return useT(_rawProps.s, _rawProps.args).value;
 }, "T_component_g8a5BXhl0hY"));
-function useLocalizedTitle(s, args) {
-  const t = useT(s, args);
-  core.useOnDocument("qidle", /* @__PURE__ */ core.inlinedQrl(() => {
-    const t2 = core._captures[0];
-    if (typeof document === "undefined") return;
-    document.title = t2.value;
-  }, "useLocalizedTitle_useOnDocument_VXsb0xE3U2c", [
-    t
-  ]));
-  core.useTaskQrl(/* @__PURE__ */ core.inlinedQrl(({ track }) => {
-    const t2 = core._captures[0];
-    track(t2);
-    if (typeof document === "undefined") return;
-    document.title = t2.value;
-  }, "useLocalizedTitle_useTask_MxJmwSF2dkE", [
-    t
-  ]));
+/**
+* Make the document title (`<title>` element in `<head>`) translated, and follow locale changes.
+*
+* Note: Only effective after resumption on clients. Title generated during SSG is untouched.
+*/ function useLocalizedTitle(s, args) {
+	const t = useT(s, args);
+	(0, _qwik_dev_core.useOnDocument)("qidle", /*#__PURE__*/ (0, _qwik_dev_core.inlinedQrl)(() => {
+		const t = _qwik_dev_core._captures[0];
+		if (typeof document === "undefined") return;
+		document.title = t.value;
+	}, "useLocalizedTitle_useOnDocument_VXsb0xE3U2c", [t]));
+	(0, _qwik_dev_core.useTaskQrl)(/*#__PURE__*/ (0, _qwik_dev_core.inlinedQrl)(({ track }) => {
+		const t = _qwik_dev_core._captures[0];
+		track(t);
+		if (typeof document === "undefined") return;
+		document.title = t.value;
+	}, "useLocalizedTitle_useTask_MxJmwSF2dkE", [t]));
 }
 exports.T = T;
 exports.useLocalizedTitle = useLocalizedTitle;