sheet-i18n 1.10.2 → 1.10.3

package/README.md

@@ -15,19 +15,25 @@ It serves as a bridge between your translation data and your application, offeri
 
 The `sheet-i18n` ecosystem is divided into three main packages:
 
-- `sheet-i18n/react`
+- `@sheet-i18n/react`
 - `@sheet-i18n/cli`
-- `sheet-i18n/importer`
+- `@sheet-i18n/importer`
 
 ### Installation
 
 ```shell
-npm install sheet-i18n
+# React client
+npm install @sheet-i18n/react
+
+# CLI tool (dev dependency)
 npm install @sheet-i18n/cli -D
+
+# Optional: only if using the server-side Google Sheets importer
+npm install @sheet-i18n/importer
 ```
 
 <details open>
-<summary><strong>⚛️ Frontend Translation Provider - sheet-i18n/react</strong></summary>
+<summary><strong>⚛️ Frontend Translation Provider - @sheet-i18n/react</strong></summary>
 
 ### `@sheet-i18n/react`
 
@@ -561,11 +567,7 @@ export default function App() {
 }
 ```
 
-## 🌐 Advanced Interpolation Strategies
-
-sheet-i18n provides advanced interpolation strategies for different rendering environments. These strategies ensure optimal performance and user experience across various deployment scenarios.
-
-### 🖥️ Client-Side Rendering (CSR) Interpolation
+## 🖥️ Persistent Locale Settings
 
 For client-side applications, sheet-i18n offers `StorageBasedIntlProvider` with `LocaleStorageManager` to handle **persistent locale settings** and interpolation seamlessly.
 
@@ -797,6 +799,56 @@ const { t } = useTranslation('userSheet');
 const translatedText = t.rule('ageRule', { age: 25 }); // 'You are an adult. Your age is 25'
 ```
 
+## 🌐 Monorepo Support
+
+### **Render Prop Support (Monorepo-Friendly)**
+
+Both `StorageBasedIntlProvider` and `IntlProvider` accept either regular children
+or a render function. When a function is provided, the current locale is injected
+as the first argument. This is useful in monorepos where:
+
+```text
+┌───────────────┐          ┌───────────────────────┐
+│ workspace app │ ───────> │ app i18n context      │
+└───────────────┘          │ (Store A)             │
+                           └───────────────────────┘
+
+┌───────────────┐          ┌───────────────────────┐
+│ packages/ui   │ ───────> │ ui i18n context       │
+└───────────────┘          │ (Store B)             │
+                           └───────────────────────┘
+
+             locale bridge (A -> B)
+
+The contexts stay separate (for example, different packages can point to
+different sheets), while the current locale can still be bridged.
+```
+
+```tsx
+// packages/ui: export its own IntlProvider
+export { IntlProvider as PackageUIIntlProvider } from './src/i18n/i18nContext';
+
+// workspace: bridge the locale to the package provider
+import { PackageUIIntlProvider } from '@packages/ui';
+import {
+  localeStorageManager,
+  StorageBasedIntlProvider,
+} from '@/i18n/i18nContext';
+
+export default function LocaleProvider({ children }: PropsWithChildren) {
+  return (
+    <StorageBasedIntlProvider storageManager={localeStorageManager}>
+      // currentLocale: automatically injected
+      {(currentLocale) => (
+        <PackageUIIntlProvider currentLocale={currentLocale}>
+          {children}
+        </PackageUIIntlProvider>
+      )}
+    </StorageBasedIntlProvider>
+  );
+}
+```
+
 </details>
 
 ---
@@ -1015,7 +1067,7 @@ When watch mode is started, the CLI will detect changes of "useTranslation" and
 
 ```tsx
 //translationContext.tsx
-import { createI18nContext } from 'sheet-i18n/react';
+import { createI18nContext } from '@sheet-i18n/react';
 
 export const { IntlProvider, useTranslation } = createI18nContext(i18nStore);
 
@@ -1176,16 +1228,16 @@ The configuration of export command is based on **`sheet.config.ts`** on your ro
 ---
 
 <details open>
-<summary><strong>🌍 Server Export Function - sheet-i18n/importer</strong></summary>
+<summary><strong>🌍 Server Export Function - @sheet-i18n/importer</strong></summary>
 
-### `sheet-i18n/importer`
+### `@sheet-i18n/importer`
 
 [![npm package](https://img.shields.io/npm/v/@sheet-i18n/importer)](https://npmjs.com/package/@sheet-i18n/importer)
 
 The **server-side importer** subpackage allows you to interact with Google Sheets and export translations directly into your project. This is primarily used in server-side environments, such as Next.js API routes or other backend frameworks, where you want to fetch and store translations from a Google Spreadsheet to be served to clients or used within your server application.
 
 ```jsx
-import { googleSheetImporter } from 'sheet-i18n/importer';
+import { googleSheetImporter } from '@sheet-i18n/importer';
 
 const importer = await googleSheetImporter({
   credentials: {

package/dist/index.d.ts

@@ -1,3 +1,2 @@
-export { SheetConfig } from '@sheet-i18n/typescript';
-import '@sheet-i18n/react';
-import '@sheet-i18n/importer';
+
+export { }

package/dist/index.js

@@ -1,18 +1 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 = {};
-module.exports = __toCommonJS(src_exports);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sheet-i18n",
-  "description": "All-in-one i18n toolchain: seamlessly integrate Google Sheets, CLI, and react-i18n for easy translation workflows.",
-  "version": "1.10.2",
+  "description": "Core i18n toolchain for sheet-i18n: configuration types and server-side importer for Google Sheets workflows.",
+  "version": "1.10.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/chltjdrhd777/sheet-i18n"
@@ -17,16 +17,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
-    },
-    "./importer": {
-      "require": "./dist/importer/index.js",
-      "import": "./dist/importer/index.mjs",
-      "types": "./dist/importer/index.d.ts"
-    },
-    "./react": {
-      "require": "./dist/react/index.js",
-      "import": "./dist/react/index.mjs",
-      "types": "./dist/react/index.d.ts"
     }
   },
   "keywords": [
@@ -49,11 +39,7 @@
   },
   "license": "ISC",
   "homepage": "https://github.com/chltjdrhd777/sheet-i18n",
-  "dependencies": {
-    "@sheet-i18n/react": "1.6.1",
-    "@sheet-i18n/importer": "1.9.6",
-    "@sheet-i18n/typescript": "0.3.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "tsup": "^6.0.0",
     "typescript": "^5.0.0",

package/dist/importer/index.d.ts

@@ -1 +0,0 @@
-export * from '@sheet-i18n/importer';

package/dist/importer/index.js

@@ -1,24 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/importer/index.ts
-var importer_exports = {};
-module.exports = __toCommonJS(importer_exports);
-__reExport(importer_exports, require("@sheet-i18n/importer"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require("@sheet-i18n/importer")
-});

package/dist/importer/index.mjs

@@ -1,2 +0,0 @@
-// src/importer/index.ts
-export * from "@sheet-i18n/importer";

package/dist/react/index.d.ts

@@ -1 +0,0 @@
-export * from '@sheet-i18n/react';

package/dist/react/index.js

@@ -1,24 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/react/index.ts
-var react_exports = {};
-module.exports = __toCommonJS(react_exports);
-__reExport(react_exports, require("@sheet-i18n/react"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require("@sheet-i18n/react")
-});

package/dist/react/index.mjs

@@ -1,2 +0,0 @@
-// src/react/index.ts
-export * from "@sheet-i18n/react";