gsheets-i18n 1.0.0

package/README.md

@@ -0,0 +1,414 @@
+# gsheets-i18n
+
+Generate i18n JSON files from a Google Spreadsheet — as a CLI tool or a Node.js library.
+
+Each tab of your spreadsheet becomes a **namespace**, each row a **translation key**, and each language column an output file. The result is one `<locale>.json` file per language, with nested keys, ready to drop into React i18next, Vue i18n, or any similar framework.
+
+---
+
+## Table of Contents
+
+- [How it works](#how-it-works)
+- [Installation](#installation)
+- [Google Setup](#google-setup)
+- [Spreadsheet Format](#spreadsheet-format)
+- [CLI Usage](#cli-usage)
+- [Programmatic API](#programmatic-api)
+- [Key Mapping](#key-mapping)
+- [Folder Mode](#folder-mode)
+- [Configuration Reference](#configuration-reference)
+
+---
+
+## How it works
+
+```
+Google Spreadsheet
+┌─────────────────────────────────────────────┐
+│ Tab: "actions"                              │
+│ key              │ EN       │ FR            │
+│ save             │ Save     │ Enregistrer   │
+│ cancel           │ Cancel   │ Annuler       │
+│                             │               │
+│ Tab: "errors"               │               │
+│ key              │ EN       │ FR            │
+│ not_found        │ Not found│ Introuvable   │
+└─────────────────────────────────────────────┘
+             │
+             ▼  gsheets-i18n
+             
+en.json                         fr.json
+{                               {
+  "actions": {                    "actions": {
+    "save": "Save",                 "save": "Enregistrer",
+    "cancel": "Cancel"              "cancel": "Annuler"
+  },                            },
+  "errors": {                     "errors": {
+    "not_found": "Not found"        "not_found": "Introuvable"
+  }                             }
+}                               }
+```
+
+In your code you then access translations with dotted paths:
+
+```ts
+t("actions.save")       // → "Save"
+t("errors.not_found")   // → "Not found"
+```
+
+---
+
+## Installation
+
+```bash
+# As a dev dependency (recommended for most projects)
+npm install --save-dev gsheets-i18n
+
+# Or globally for CLI use
+npm install -g gsheets-i18n
+```
+
+**Requirements:** Node.js ≥ 18
+
+---
+
+## Google Setup
+
+### 1. Create a Service Account
+
+1. Go to the [Google Cloud Console](https://console.cloud.google.com/)
+2. Create or select a project
+3. Go to **APIs & Services → Credentials**
+4. Click **Create Credentials → Service Account**
+5. Give it a name and click **Done**
+6. Open the service account, go to **Keys → Add Key → Create new key → JSON**
+7. Download the JSON file — this is your `service-account.json`
+
+### 2. Enable the required APIs
+
+In **APIs & Services → Enabled APIs**, enable:
+
+- **Google Sheets API**
+- **Google Drive API** ← only required for [folder mode](#folder-mode)
+
+### 3. Share your spreadsheet with the service account
+
+Open your Google Spreadsheet, click **Share**, and add the service account email (looks like `name@project.iam.gserviceaccount.com`) with **Viewer** permissions.
+
+> ⚠️ Keep `service-account.json` out of version control. Add it to `.gitignore`.
+
+---
+
+## Spreadsheet Format
+
+### Basic structure
+
+Each **tab** represents a namespace. Rows are translation keys, columns are languages.
+
+```
+┌──────────────────┬──────────────┬────────────────┬────────────────┐
+│ key              │ EN           │ FR             │ DE             │
+├──────────────────┼──────────────┼────────────────┼────────────────┤
+│ save             │ Save         │ Enregistrer    │ Speichern      │
+│ cancel           │ Cancel       │ Annuler        │ Abbrechen      │
+│ confirm          │ Confirm      │ Confirmer      │ Bestätigen     │
+└──────────────────┴──────────────┴────────────────┴────────────────┘
+```
+
+- **Row 1** — Header row: first cell is ignored (label for the key column), remaining cells are language identifiers.
+- **Column A** — Translation key. Supports **dot notation** for nesting: `modal.title` → `{ modal: { title: "…" } }`.
+- **Other columns** — One language per column. The header value is mapped to a locale code (see [Key Mapping](#key-mapping)).
+
+### Skipping tabs and columns
+
+Prefix a tab name or column header with `_` to exclude it from output:
+
+```
+Tab name "_notes"     → ignored entirely
+Column header "_dev"  → ignored entirely
+```
+
+### Dot notation in keys
+
+Use dots in your key to create nested output objects:
+
+```
+key                     │ EN
+modal.title             │ Confirm action
+modal.body              │ Are you sure?
+modal.actions.confirm   │ Yes, proceed
+modal.actions.cancel    │ Go back
+```
+
+Produces:
+
+```json
+{
+  "modal": {
+    "title": "Confirm action",
+    "body": "Are you sure?",
+    "actions": {
+      "confirm": "Yes, proceed",
+      "cancel": "Go back"
+    }
+  }
+}
+```
+
+### Multiple tabs
+
+Each tab becomes a top-level namespace in the output:
+
+```
+Tab "actions" + key "save"   → { "actions": { "save": "…" } }
+Tab "errors"  + key "404"    → { "errors":  { "404":  "…" } }
+```
+
+---
+
+## CLI Usage
+
+### Sheet mode
+
+Extract from a single spreadsheet (all non-internal tabs):
+
+```bash
+gsheets-i18n sheet \
+  --sheet-id 4BxiM*****pms \
+  --key ./service-account.json \
+  --out ./src/locales
+```
+
+Extract only one specific tab (by its numeric tab ID):
+
+```bash
+gsheets-i18n sheet \
+  --sheet-id 4BxiM*****pms \
+  --key ./service-account.json \
+  --tab-id 0 \
+  --out ./src/locales
+```
+
+> **Finding the tab ID:** Right-click a tab in your browser → "Copy link" — the URL contains `#gid=<tabId>`.
+
+### Folder mode
+
+Scan a Drive folder recursively and extract from every spreadsheet found:
+
+```bash
+gsheets-i18n folder \
+  --folder-id 1A2B3C4D5E6F7G8H9I0J \
+  --key ./service-account.json \
+  --out ./src/locales
+```
+
+### Output example
+
+```
+  ✔  Done in 1.24s
+
+  📂  /your/project/src/locales
+
+      de.json  (3 top-level keys)
+      en.json  (3 top-level keys)
+      fr.json  (3 top-level keys)
+```
+
+### Adding to package.json scripts
+
+```json
+{
+  "scripts": {
+    "i18n:pull": "gsheets-i18n sheet --sheet-id YOUR_ID --key ./service-account.json --out ./src/locales"
+  }
+}
+```
+
+---
+
+## Programmatic API
+
+```ts
+import { extract } from "gsheets-i18n";
+
+const result = await extract({
+  serviceAccountKey: "./service-account.json",
+  source: {
+    mode: "sheet",
+    spreadsheetId: "4BxiM*****pms",
+  },
+  outputDir: "./src/locales",
+});
+
+console.log(`Generated ${result.files.length} files in ${result.durationMs}ms`);
+// → Generated 3 files in 1240ms
+
+for (const file of result.files) {
+  console.log(`${file.locale}: ${file.path} (${file.keyCount} keys)`);
+}
+```
+
+The `extract()` function returns a `Promise<ExtractResult>`:
+
+```ts
+interface ExtractResult {
+  files: OutputFile[];   // One entry per generated file
+  durationMs: number;    // Total wall-clock time
+}
+
+interface OutputFile {
+  locale: string;        // e.g. "en", "fr", "zh-TW"
+  path: string;          // Absolute path to the written file
+  keyCount: number;      // Number of top-level namespace keys
+}
+```
+
+---
+
+## Key Mapping
+
+Column headers in your sheet are mapped to BCP-47 locale codes. A wide range of spellings is supported out of the box:
+
+| Header in sheet            | Output locale code |
+|----------------------------|--------------------|
+| `EN`, `ENG`, `English`     | `en`               |
+| `FR`, `FRE`, `French`, `Français` | `fr`      |
+| `DE`, `GER`, `German`, `Deutsch`  | `de`      |
+| `ZH-TW`, `CHT`, `繁體中文`  | `zh-TW`            |
+| `ZH-CN`, `CHS`, `简体中文`  | `zh-CN`            |
+| `JA`, `JPN`, `Japanese`, `日本語` | `ja`      |
+| … and many more            |                    |
+
+### Custom key map via the spreadsheet
+
+Add a tab named `_keymap` to your spreadsheet to define project-specific mappings:
+
+```
+┌──────────────┬───────┬──────┬───────┐
+│ (ignored)    │ fr    │ en   │ pt-BR │
+├──────────────┼───────┼──────┼───────┤
+│ Français     │ fr    │      │       │
+│ Anglais      │       │ en   │       │
+│ Brésilien    │       │      │ pt-BR │
+└──────────────┴───────┴──────┴───────┘
+```
+
+### Custom key map via CLI or API
+
+Pass a JSON file to the CLI:
+
+```bash
+gsheets-i18n sheet --sheet-id … --key-map ./my-key-map.json
+```
+
+Or pass an object to the API:
+
+```ts
+await extract({
+  // …
+  localeKeyMap: {
+    "Français": "fr",
+    "Anglais": "en",
+    "Brésilien": "pt-BR",
+  },
+});
+```
+
+**Priority (highest → lowest):**
+1. `_keymap` tab in the spreadsheet
+2. `localeKeyMap` option / `--key-map` file
+3. Built-in defaults
+
+---
+
+## Folder Mode
+
+In folder mode, the library recursively scans a Google Drive folder:
+
+- Each **sub-folder** name becomes a path component of the namespace
+- Each **spreadsheet** name becomes the innermost namespace component
+- Files and folders starting with `_` are **skipped**
+- A spreadsheet named `_keymap` in any folder applies its mappings to everything inside that folder
+
+**Example Drive structure:**
+
+```
+📁 my-translations/
+├── 📁 app/
+│   ├── 📄 actions      ← spreadsheet
+│   └── 📄 errors       ← spreadsheet
+└── 📄 common           ← spreadsheet
+```
+
+Produces keys structured as:
+
+```json
+{
+  "app": {
+    "actions": { "save": "…" },
+    "errors":  { "404": "…" }
+  },
+  "common": { "yes": "…" }
+}
+```
+
+---
+
+## Configuration Reference
+
+### `extract(options)` — full options
+
+| Option              | Type                        | Default                  | Description |
+|---------------------|-----------------------------|--------------------------|-------------|
+| `serviceAccountKey` | `string \| ServiceAccountKey` | *(required)*           | Path to key file or parsed key object |
+| `source`            | `SheetModeOptions \| FolderModeOptions` | *(required)* | What to extract |
+| `outputDir`         | `string`                    | `"./i18n"`               | Directory for output files |
+| `localeKeyMap`      | `Record<string, string>`    | `{}`                     | Custom header → locale mappings |
+| `includeEmpty`      | `boolean`                   | `false`                  | Write keys with empty values |
+| `indent`            | `number \| string`          | `2`                      | JSON indentation (`2`, `4`, `"\t"`) |
+
+### `SheetModeOptions`
+
+| Option          | Type     | Default | Description |
+|-----------------|----------|---------|-------------|
+| `mode`          | `"sheet"` | *(required)* | |
+| `spreadsheetId` | `string` | *(required)* | Google Spreadsheet ID |
+| `tabId`         | `number` | all tabs | Specific tab to extract |
+| `startColumn`   | `number` | `0`     | Skip leading columns |
+
+### `FolderModeOptions`
+
+| Option     | Type      | Default | Description |
+|------------|-----------|---------|-------------|
+| `mode`     | `"folder"` | *(required)* | |
+| `folderId` | `string`  | *(required)* | Google Drive folder ID |
+
+### CLI flags — `sheet` command
+
+| Flag                      | Default                  | Description |
+|---------------------------|--------------------------|-------------|
+| `-s, --sheet-id <id>`     | *(required)*             | Spreadsheet ID |
+| `-k, --key <path>`        | `./service-account.json` | Key file path |
+| `-o, --out <path>`        | `./i18n`                 | Output directory |
+| `-t, --tab-id <id>`       | all tabs                 | Numeric tab ID |
+| `--start-column <n>`      | `0`                      | Skip leading columns |
+| `--include-empty`         | `false`                  | Include empty values |
+| `--indent <n\|"tab">`     | `2`                      | JSON indentation |
+| `--key-map <path>`        | —                        | Custom key map JSON |
+
+### CLI flags — `folder` command
+
+| Flag                  | Default                  | Description |
+|-----------------------|--------------------------|-------------|
+| `-f, --folder-id <id>` | *(required)*            | Drive folder ID |
+| `-k, --key <path>`    | `./service-account.json` | Key file path |
+| `-o, --out <path>`    | `./i18n`                 | Output directory |
+| `--include-empty`     | `false`                  | Include empty values |
+| `--indent <n\|"tab">` | `2`                      | JSON indentation |
+| `--key-map <path>`    | —                        | Custom key map JSON |
+
+---
+
+## License
+
+MIT

package/dist/cjs/cli/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const index_js_1 = require("../index.js");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function parseIndent(value) {
+    if (value === "tab" || value === "\t")
+        return "\t";
+    const num = Number(value);
+    if (!Number.isNaN(num) && num >= 0 && num <= 8)
+        return num;
+    throw new Error(`Invalid indent value: "${value}". Use a number 0–8 or "tab".`);
+}
+function fatal(message) {
+    console.error(`\n  ✖  ${message}\n`);
+    process.exit(1);
+}
+// ─── CLI definition ───────────────────────────────────────────────────────────
+const program = new commander_1.Command();
+program
+    .name("sheets-i18n")
+    .description("Generate i18n JSON files from a Google Spreadsheet or Drive folder.")
+    .version("1.0.0");
+// ── sheet command ─────────────────────────────────────────────────────────────
+program
+    .command("sheet")
+    .description("Extract from a single Google Spreadsheet")
+    .requiredOption("-s, --sheet-id <spreadsheetId>", "Google Spreadsheet ID (from the URL)")
+    .requiredOption("-k, --key <path>", "Path to the Service Account JSON key file", "./service-account.json")
+    .option("-o, --out <path>", "Output directory for the generated JSON files", "./i18n")
+    .option("-t, --tab-id <id>", "Numeric tab ID to extract (default: all tabs)")
+    .option("--start-column <n>", "Zero-based column index to start reading from", "0")
+    .option("--include-empty", "Include keys with empty values in the output", false)
+    .option("--indent <value>", 'JSON indentation: a number of spaces or "tab"', "2")
+    .option("--key-map <path>", "Path to a JSON file with custom locale key mappings")
+    .action(async (opts) => {
+    let localeKeyMap;
+    if (opts.keyMap) {
+        try {
+            const raw = await (0, promises_1.readFile)((0, node_path_1.resolve)(process.cwd(), opts.keyMap), "utf-8");
+            localeKeyMap = JSON.parse(raw);
+        }
+        catch {
+            fatal(`Could not read key map file: ${opts.keyMap}`);
+            return;
+        }
+    }
+    console.log("\n  ⏳  Extracting translations…\n");
+    try {
+        const result = await (0, index_js_1.extract)({
+            serviceAccountKey: opts.key,
+            source: {
+                mode: "sheet",
+                spreadsheetId: opts.sheetId,
+                tabId: opts.tabId !== undefined ? Number(opts.tabId) : undefined,
+                startColumn: Number(opts.startColumn),
+            },
+            outputDir: opts.out,
+            localeKeyMap,
+            includeEmpty: opts.includeEmpty,
+            indent: parseIndent(opts.indent),
+        });
+        console.log(`  ✔  Done in ${(result.durationMs / 1000).toFixed(2)}s\n`);
+        console.log(`  📂  ${(0, node_path_1.resolve)(process.cwd(), opts.out)}\n`);
+        for (const file of result.files) {
+            console.log(`      ${file.locale}.json  (${file.keyCount} top-level keys)`);
+        }
+        console.log();
+    }
+    catch (err) {
+        fatal(err instanceof Error ? err.message : String(err));
+    }
+});
+// ── folder command ────────────────────────────────────────────────────────────
+program
+    .command("folder")
+    .description("Extract from all spreadsheets inside a Google Drive folder")
+    .requiredOption("-f, --folder-id <folderId>", "Google Drive folder ID (from the URL)")
+    .requiredOption("-k, --key <path>", "Path to the Service Account JSON key file", "./service-account.json")
+    .option("-o, --out <path>", "Output directory for the generated JSON files", "./i18n")
+    .option("--include-empty", "Include keys with empty values in the output", false)
+    .option("--indent <value>", 'JSON indentation: a number of spaces or "tab"', "2")
+    .option("--key-map <path>", "Path to a JSON file with custom locale key mappings")
+    .action(async (opts) => {
+    let localeKeyMap;
+    if (opts.keyMap) {
+        try {
+            const raw = await (0, promises_1.readFile)((0, node_path_1.resolve)(process.cwd(), opts.keyMap), "utf-8");
+            localeKeyMap = JSON.parse(raw);
+        }
+        catch {
+            fatal(`Could not read key map file: ${opts.keyMap}`);
+            return;
+        }
+    }
+    console.log("\n  ⏳  Extracting translations…\n");
+    try {
+        const result = await (0, index_js_1.extract)({
+            serviceAccountKey: opts.key,
+            source: {
+                mode: "folder",
+                folderId: opts.folderId,
+            },
+            outputDir: opts.out,
+            localeKeyMap,
+            includeEmpty: opts.includeEmpty,
+            indent: parseIndent(opts.indent),
+        });
+        console.log(`  ✔  Done in ${(result.durationMs / 1000).toFixed(2)}s\n`);
+        console.log(`  📂  ${(0, node_path_1.resolve)(process.cwd(), opts.out)}\n`);
+        for (const file of result.files) {
+            console.log(`      ${file.locale}.json  (${file.keyCount} top-level keys)`);
+        }
+        console.log();
+    }
+    catch (err) {
+        fatal(err instanceof Error ? err.message : String(err));
+    }
+});
+// ─── Parse ────────────────────────────────────────────────────────────────────
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cjs/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extract = extract;
+const auth_js_1 = require("./lib/auth.js");
+const sheetExtractor_js_1 = require("./lib/sheetExtractor.js");
+const folderExtractor_js_1 = require("./lib/folderExtractor.js");
+const writer_js_1 = require("./lib/writer.js");
+/**
+ * Extracts translations from Google Sheets and writes one JSON file per locale.
+ *
+ * @example
+ * ```ts
+ * import { extract } from "sheets-i18n";
+ *
+ * await extract({
+ *   serviceAccountKey: "./service-account.json",
+ *   source: {
+ *     mode: "sheet",
+ *     spreadsheetId: "4BxiM********upms",
+ *   },
+ *   outputDir: "./src/locales",
+ * });
+ * ```
+ */
+async function extract(options) {
+    const startTime = Date.now();
+    const { serviceAccountKey, source, outputDir = "./i18n", localeKeyMap, includeEmpty = false, indent = 2, } = options;
+    // 1. Authenticate
+    const auth = await (0, auth_js_1.createAuthClient)(serviceAccountKey);
+    // 2. Extract translations
+    let translations;
+    if (source.mode === "sheet") {
+        translations = await (0, sheetExtractor_js_1.extractFromSheet)({
+            auth,
+            spreadsheetId: source.spreadsheetId,
+            tabId: source.tabId,
+            startColumn: source.startColumn,
+            includeEmpty,
+            userKeyMap: localeKeyMap,
+        });
+    }
+    else {
+        translations = await (0, folderExtractor_js_1.extractFromFolder)({
+            auth,
+            folderId: source.folderId,
+            includeEmpty,
+            userKeyMap: localeKeyMap,
+        });
+    }
+    // 3. Write files
+    const files = await (0, writer_js_1.writeTranslationFiles)(translations, outputDir, indent);
+    return {
+        files,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;AAoCA,0BA2CC;AA/ED,2CAAiD;AACjD,+DAA2D;AAC3D,iEAA6D;AAC7D,+CAAwD;AAgBxD;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,OAAO,CAAC,OAAuB;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,MAAM,EACJ,iBAAiB,EACjB,MAAM,EACN,SAAS,GAAG,QAAQ,EACpB,YAAY,EACZ,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,CAAC,GACX,GAAG,OAAO,CAAC;IAEZ,kBAAkB;IAClB,MAAM,IAAI,GAAG,MAAM,IAAA,0BAAgB,EAAC,iBAAiB,CAAC,CAAC;IAEvD,0BAA0B;IAC1B,IAAI,YAAY,CAAC;IAEjB,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,YAAY,GAAG,MAAM,IAAA,oCAAgB,EAAC;YACpC,IAAI;YACJ,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY;YACZ,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,MAAM,IAAA,sCAAiB,EAAC;YACrC,IAAI;YACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY;YACZ,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,MAAM,KAAK,GAAG,MAAM,IAAA,iCAAqB,EAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3E,OAAO;QACL,KAAK;QACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACnC,CAAC;AACJ,CAAC"}

package/dist/cjs/lib/auth.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAuthClient = createAuthClient;
+const googleapis_1 = require("googleapis");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const SCOPES = [
+    "https://www.googleapis.com/auth/spreadsheets.readonly",
+    "https://www.googleapis.com/auth/drive.readonly",
+];
+/**
+ * Builds an authenticated Google JWT client from a Service Account key.
+ *
+ * @param keySource - Either a file-system path to the key JSON, or the parsed object.
+ */
+async function createAuthClient(keySource) {
+    let key;
+    if (typeof keySource === "string") {
+        const absolutePath = (0, node_path_1.resolve)(process.cwd(), keySource);
+        const raw = await (0, promises_1.readFile)(absolutePath, "utf-8");
+        key = JSON.parse(raw);
+    }
+    else {
+        key = keySource;
+    }
+    const client = new googleapis_1.google.auth.JWT({
+        email: key.client_email,
+        key: key.private_key,
+        scopes: SCOPES,
+    });
+    await client.authorize();
+    return client;
+}
+//# sourceMappingURL=auth.js.map

package/dist/cjs/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/lib/auth.ts"],"names":[],"mappings":";;AAeA,4CAqBC;AApCD,2CAAoC;AACpC,+CAA4C;AAC5C,yCAAoC;AAGpC,MAAM,MAAM,GAAG;IACb,uDAAuD;IACvD,gDAAgD;CACjD,CAAC;AAEF;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CACpC,SAAqC;IAErC,IAAI,GAAsB,CAAC;IAE3B,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAQ,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,mBAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACjC,KAAK,EAAE,GAAG,CAAC,YAAY;QACvB,GAAG,EAAE,GAAG,CAAC,WAAW;QACpB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC"}