@sheet-i18n/react-client 0.1.1-canary.0

package/README.md

@@ -0,0 +1,3 @@
+# React
+
+This is the `react` utility package.

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { I18nStore } from '@sheet-i18n/react-core';
+import * as react from 'react';
+import { MessageDescriptor, IntlShape } from 'react-intl';
+
+type IntlProviderProps<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>> = {
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet>;
+    currentLocale: TSupportedLocales[number];
+    children: React.ReactNode;
+};
+declare function IntlProvider<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>>({ i18nStore, currentLocale, children, }: IntlProviderProps<TSupportedLocales, TLocaleSet>): react_jsx_runtime.JSX.Element;
+
+type UseIntlParams<D = MessageDescriptor> = Parameters<IntlShape['$t']> extends [D, ...infer R] ? [...R, Omit<D, 'id'>] : never;
+type $TParams = Partial<UseIntlParams>;
+interface UseTranslationParams<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>, TSheetTitle = keyof TLocaleSet[TSupportedLocales[number]]> {
+    sheetTitle: TSheetTitle;
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet>;
+}
+declare function useTranslation<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>, TSheetTitle extends keyof TLocaleSet[TSupportedLocales[number]], TMessageId extends keyof TLocaleSet[TSupportedLocales[number]][TSheetTitle]>({ sheetTitle, }: UseTranslationParams<TSupportedLocales, TLocaleSet, TSheetTitle>): {
+    t: <TValues extends $TParams["0"], TOpts extends $TParams["1"], T_Descriptor extends $TParams["2"]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: T_Descriptor) => string | number | bigint | boolean | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | react.ReactPortal | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | (string | number | bigint | boolean | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | react.ReactPortal | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | null | undefined)[] | null | undefined;
+};
+
+interface I18nContextState<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>> {
+    supportedLocales: Readonly<TSupportedLocales>;
+    defaultLocale: TSupportedLocales[number];
+    localeSet: TLocaleSet;
+}
+declare function createI18nContext<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>>(i18nStore: I18nStore<TSupportedLocales, TLocaleSet>): {
+    IntlProvider: ({ currentLocale, children, }: Omit<IntlProviderProps<TSupportedLocales, TLocaleSet>, "i18nStore">) => react_jsx_runtime.JSX.Element;
+    useTranslation: <SheetTitle extends keyof TLocaleSet[TSupportedLocales[number]]>(sheetTitle: SheetTitle) => ReturnType<typeof useTranslation<TSupportedLocales, TLocaleSet, SheetTitle, keyof TLocaleSet[TSupportedLocales[number]][SheetTitle]>>;
+};
+
+export { type I18nContextState, IntlProvider, type IntlProviderProps, createI18nContext, useTranslation };

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { I18nStore } from '@sheet-i18n/react-core';
+import * as react from 'react';
+import { MessageDescriptor, IntlShape } from 'react-intl';
+
+type IntlProviderProps<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>> = {
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet>;
+    currentLocale: TSupportedLocales[number];
+    children: React.ReactNode;
+};
+declare function IntlProvider<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>>({ i18nStore, currentLocale, children, }: IntlProviderProps<TSupportedLocales, TLocaleSet>): react_jsx_runtime.JSX.Element;
+
+type UseIntlParams<D = MessageDescriptor> = Parameters<IntlShape['$t']> extends [D, ...infer R] ? [...R, Omit<D, 'id'>] : never;
+type $TParams = Partial<UseIntlParams>;
+interface UseTranslationParams<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>, TSheetTitle = keyof TLocaleSet[TSupportedLocales[number]]> {
+    sheetTitle: TSheetTitle;
+    i18nStore: I18nStore<TSupportedLocales, TLocaleSet>;
+}
+declare function useTranslation<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>, TSheetTitle extends keyof TLocaleSet[TSupportedLocales[number]], TMessageId extends keyof TLocaleSet[TSupportedLocales[number]][TSheetTitle]>({ sheetTitle, }: UseTranslationParams<TSupportedLocales, TLocaleSet, TSheetTitle>): {
+    t: <TValues extends $TParams["0"], TOpts extends $TParams["1"], T_Descriptor extends $TParams["2"]>(id: TMessageId, values?: TValues, opts?: TOpts, _descriptor?: T_Descriptor) => string | number | bigint | boolean | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | react.ReactPortal | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | (string | number | bigint | boolean | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | react.ReactPortal | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | null | undefined)[] | null | undefined;
+};
+
+interface I18nContextState<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>> {
+    supportedLocales: Readonly<TSupportedLocales>;
+    defaultLocale: TSupportedLocales[number];
+    localeSet: TLocaleSet;
+}
+declare function createI18nContext<TSupportedLocales extends readonly string[], TLocaleSet extends Record<TSupportedLocales[number], Record<string, any>>>(i18nStore: I18nStore<TSupportedLocales, TLocaleSet>): {
+    IntlProvider: ({ currentLocale, children, }: Omit<IntlProviderProps<TSupportedLocales, TLocaleSet>, "i18nStore">) => react_jsx_runtime.JSX.Element;
+    useTranslation: <SheetTitle extends keyof TLocaleSet[TSupportedLocales[number]]>(sheetTitle: SheetTitle) => ReturnType<typeof useTranslation<TSupportedLocales, TLocaleSet, SheetTitle, keyof TLocaleSet[TSupportedLocales[number]][SheetTitle]>>;
+};
+
+export { type I18nContextState, IntlProvider, type IntlProviderProps, createI18nContext, useTranslation };

package/dist/index.js

@@ -0,0 +1,126 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  IntlProvider: () => IntlProvider,
+  createI18nContext: () => createI18nContext,
+  useTranslation: () => useTranslation
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/createI18nContext.tsx
+var import_shared_utils = require("@sheet-i18n/shared-utils");
+var import_react_core = require("@sheet-i18n/react-core");
+
+// src/IntlProvider.tsx
+var import_react_intl = require("react-intl");
+var import_jsx_runtime = require("react/jsx-runtime");
+function IntlProvider({
+  i18nStore,
+  currentLocale,
+  children
+}) {
+  const { defaultLocale, localeSet } = i18nStore;
+  const locale = currentLocale != null ? currentLocale : defaultLocale;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_react_intl.IntlProvider,
+    {
+      locale,
+      messages: localeSet[currentLocale],
+      children
+    }
+  );
+}
+
+// src/useTranslation.ts
+var import_react_intl2 = require("react-intl");
+var intlCache = (0, import_react_intl2.createIntlCache)();
+function useTranslation({
+  sheetTitle
+}) {
+  const currentIntl = (0, import_react_intl2.useIntl)();
+  const totalMessages = currentIntl.messages;
+  const targetMessages = totalMessages[sheetTitle];
+  const newIntl = (0, import_react_intl2.createIntl)(
+    __spreadProps(__spreadValues({}, currentIntl), { messages: targetMessages }),
+    intlCache
+  );
+  const t = (id, values, opts, _descriptor) => {
+    const descriptor = __spreadProps(__spreadValues({}, _descriptor != null ? _descriptor : {}), { id });
+    return newIntl.$t(descriptor, values, opts);
+  };
+  return { t };
+}
+
+// src/Errors.ts
+var import_errors = require("@sheet-i18n/errors");
+var InvalidI18nContextStateError = class extends import_errors.CustomError {
+};
+var IsNotInstanceOfI18nStoreError = class extends import_errors.CustomError {
+};
+
+// src/createI18nContext.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function createI18nContext(i18nStore) {
+  if (import_shared_utils.validator.isNullish(i18nStore)) {
+    throw new InvalidI18nContextStateError(
+      "\u26A0\uFE0F no i18nStore provided. To use createI18nContext, you must provide an i18nStore as a parameter"
+    );
+  }
+  if (i18nStore instanceof import_react_core.I18nStore !== true) {
+    throw new IsNotInstanceOfI18nStoreError(
+      "\u26A0\uFE0F The provided i18nStore is invalid. Please ensure a store instance you passed is an instance of I18nStore."
+    );
+  }
+  const IntlProviderImpl = ({
+    currentLocale,
+    children
+  }) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(IntlProvider, { currentLocale, i18nStore, children });
+  const useTranslationImpl = (sheetTitle) => useTranslation({ sheetTitle, i18nStore });
+  return {
+    IntlProvider: IntlProviderImpl,
+    useTranslation: useTranslationImpl
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IntlProvider,
+  createI18nContext,
+  useTranslation
+});

package/dist/index.mjs

@@ -0,0 +1,104 @@
+"use client";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+// src/createI18nContext.tsx
+import { validator } from "@sheet-i18n/shared-utils";
+import { I18nStore } from "@sheet-i18n/react-core";
+
+// src/IntlProvider.tsx
+import { IntlProvider as ReactIntlProvider } from "react-intl";
+import { jsx } from "react/jsx-runtime";
+function IntlProvider({
+  i18nStore,
+  currentLocale,
+  children
+}) {
+  const { defaultLocale, localeSet } = i18nStore;
+  const locale = currentLocale != null ? currentLocale : defaultLocale;
+  return /* @__PURE__ */ jsx(
+    ReactIntlProvider,
+    {
+      locale,
+      messages: localeSet[currentLocale],
+      children
+    }
+  );
+}
+
+// src/useTranslation.ts
+import {
+  createIntlCache,
+  createIntl,
+  useIntl
+} from "react-intl";
+var intlCache = createIntlCache();
+function useTranslation({
+  sheetTitle
+}) {
+  const currentIntl = useIntl();
+  const totalMessages = currentIntl.messages;
+  const targetMessages = totalMessages[sheetTitle];
+  const newIntl = createIntl(
+    __spreadProps(__spreadValues({}, currentIntl), { messages: targetMessages }),
+    intlCache
+  );
+  const t = (id, values, opts, _descriptor) => {
+    const descriptor = __spreadProps(__spreadValues({}, _descriptor != null ? _descriptor : {}), { id });
+    return newIntl.$t(descriptor, values, opts);
+  };
+  return { t };
+}
+
+// src/Errors.ts
+import { CustomError } from "@sheet-i18n/errors";
+var InvalidI18nContextStateError = class extends CustomError {
+};
+var IsNotInstanceOfI18nStoreError = class extends CustomError {
+};
+
+// src/createI18nContext.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+function createI18nContext(i18nStore) {
+  if (validator.isNullish(i18nStore)) {
+    throw new InvalidI18nContextStateError(
+      "\u26A0\uFE0F no i18nStore provided. To use createI18nContext, you must provide an i18nStore as a parameter"
+    );
+  }
+  if (i18nStore instanceof I18nStore !== true) {
+    throw new IsNotInstanceOfI18nStoreError(
+      "\u26A0\uFE0F The provided i18nStore is invalid. Please ensure a store instance you passed is an instance of I18nStore."
+    );
+  }
+  const IntlProviderImpl = ({
+    currentLocale,
+    children
+  }) => /* @__PURE__ */ jsx2(IntlProvider, { currentLocale, i18nStore, children });
+  const useTranslationImpl = (sheetTitle) => useTranslation({ sheetTitle, i18nStore });
+  return {
+    IntlProvider: IntlProviderImpl,
+    useTranslation: useTranslationImpl
+  };
+}
+export {
+  IntlProvider,
+  createI18nContext,
+  useTranslation
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@sheet-i18n/react-client",
+  "version": "0.1.1-canary.0",
+  "description": "a client package for react modules used by sheet-i18n",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [],
+  "author": {
+    "name": "devAnderson",
+    "email": "chltjdrhd777@gmail.com",
+    "url": "https://github.com/chltjdrhd777"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-intl": "^7.0.4",
+    "@sheet-i18n/shared-utils": "0.2.2-canary.3",
+    "@sheet-i18n/errors": "0.2.2-canary.3",
+    "@sheet-i18n/react-core": "0.1.1-canary.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@sheet-i18n/typescript-config": "0.2.2-canary.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}