@saidksi/localizer-cli 0.1.1

package/dist/utils/json.d.ts

@@ -0,0 +1,3 @@
+/** Flatten a nested JSON object to { "dot.notation.key": "value" } pairs. */
+export declare function flattenJson(obj: Record<string, unknown>, prefix?: string): Record<string, string>;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,SAAK,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB"}

package/dist/utils/json.js

@@ -0,0 +1,15 @@
+/** Flatten a nested JSON object to { "dot.notation.key": "value" } pairs. */
+export function flattenJson(obj, prefix = "") {
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${k}` : k;
+        if (typeof v === "object" && v !== null && !Array.isArray(v)) {
+            Object.assign(result, flattenJson(v, fullKey));
+        }
+        else if (typeof v === "string") {
+            result[fullKey] = v;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,MAAM,GAAG,EAAE;IAEX,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAA4B,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,28 @@
+export declare const logger: {
+    success: (msg: string) => void;
+    error: (msg: string) => void;
+    warn: (msg: string) => void;
+    info: (msg: string) => void;
+    dim: (msg: string) => void;
+    blank: () => void;
+    raw: (msg: string) => void;
+    /** Pipeline step header: [1/4] Scanning... */
+    step: (n: number, total: number, msg: string) => void;
+    /** Indented detail line below a step */
+    detail: (msg: string) => void;
+    /** Bold section header */
+    header: (msg: string) => void;
+    /** Fatal error — prints message and exits with code 1 */
+    fatal: (msg: string) => never;
+};
+/**
+ * Render a coverage bar for the validate / status command output.
+ *
+ * progressBar("fr", 100, 312, 0)
+ * → "  fr    ████████████████████  100%  (312 keys)"
+ *
+ * progressBar("ar", 57, 312, 134)
+ * → "  ar    ███████████░░░░░░░░░   57%  (178 keys)  ← 134 missing"
+ */
+export declare function progressBar(lang: string, percent: number, totalKeys: number, missingCount: number): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM;mBACF,MAAM;iBACN,MAAM;gBACN,MAAM;gBACN,MAAM;eACN,MAAM;;eAEN,MAAM;IAErB,8CAA8C;cACpC,MAAM,SAAS,MAAM,OAAO,MAAM;IAG5C,wCAAwC;kBAC1B,MAAM;IAEpB,0BAA0B;kBACZ,MAAM;IAEpB,yDAAyD;iBAC5C,MAAM,KAAG,KAAK;CAI5B,CAAC;AAQF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR"}

package/dist/utils/logger.js

@@ -0,0 +1,48 @@
+import chalk from "chalk";
+// ─── Core output helpers ──────────────────────────────────────────────────────
+export const logger = {
+    success: (msg) => console.log(chalk.green("  ✔"), msg),
+    error: (msg) => console.error(chalk.red("  ✖"), msg),
+    warn: (msg) => console.warn(chalk.yellow("  ⚠"), msg),
+    info: (msg) => console.log(chalk.blue("  ℹ"), msg),
+    dim: (msg) => console.log(chalk.dim(`    ${msg}`)),
+    blank: () => console.log(),
+    raw: (msg) => console.log(msg),
+    /** Pipeline step header: [1/4] Scanning... */
+    step: (n, total, msg) => console.log(chalk.cyan(`\n  [${n}/${total}]`), chalk.bold(msg)),
+    /** Indented detail line below a step */
+    detail: (msg) => console.log(`        ${msg}`),
+    /** Bold section header */
+    header: (msg) => console.log(chalk.bold(`\n${msg}`)),
+    /** Fatal error — prints message and exits with code 1 */
+    fatal: (msg) => {
+        console.error(chalk.red.bold("\n  Error:"), msg);
+        process.exit(1);
+    },
+};
+// ─── Coverage progress bar ────────────────────────────────────────────────────
+const BAR_WIDTH = 20;
+const FILLED = "█";
+const EMPTY = "░";
+/**
+ * Render a coverage bar for the validate / status command output.
+ *
+ * progressBar("fr", 100, 312, 0)
+ * → "  fr    ████████████████████  100%  (312 keys)"
+ *
+ * progressBar("ar", 57, 312, 134)
+ * → "  ar    ███████████░░░░░░░░░   57%  (178 keys)  ← 134 missing"
+ */
+export function progressBar(lang, percent, totalKeys, missingCount) {
+    const filled = Math.round((percent / 100) * BAR_WIDTH);
+    const bar = FILLED.repeat(filled) + EMPTY.repeat(BAR_WIDTH - filled);
+    const pct = `${percent}%`.padStart(4);
+    const langPad = lang.padEnd(6);
+    const presentKeys = totalKeys - missingCount;
+    const keyInfo = `(${presentKeys} keys)`;
+    const missing = missingCount > 0
+        ? chalk.yellow(`  ← ${missingCount} missing`)
+        : chalk.green("  ✔");
+    return `  ${langPad}  ${bar}  ${pct}  ${keyInfo}${missing}`;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/prompt.d.ts

@@ -0,0 +1,18 @@
+export interface SelectChoice<T extends string = string> {
+    name: string;
+    value: T;
+    description?: string;
+}
+/** Free-text input with optional default value. */
+export declare function promptInput(message: string, defaultValue?: string): Promise<string>;
+/** Yes/No confirmation, defaults to No (safe default). */
+export declare function promptConfirm(message: string, defaultValue?: boolean): Promise<boolean>;
+/** Single-selection list. */
+export declare function promptSelect<T extends string>(message: string, choices: SelectChoice<T>[]): Promise<T>;
+/** Multi-selection checkbox list. */
+export declare function promptMultiselect<T extends string>(message: string, choices: SelectChoice<T>[]): Promise<T[]>;
+/** Masked password / API key input. */
+export declare function promptSecret(message: string): Promise<string>;
+/** Ask "Apply these changes? (y/N)" — used by rewrite + run commands. */
+export declare function promptApplyChanges(file: string): Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,YAAY,UAAQ,GACnB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,6BAA6B;AAC7B,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EACjD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED,qCAAqC;AACrC,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACtD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,EAAE,CAAC,CAYd;AAED,uCAAuC;AACvC,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQnE;AAID,yEAAyE;AACzE,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvE"}

package/dist/utils/prompt.js

@@ -0,0 +1,65 @@
+import prompts from "prompts";
+/** Free-text input with optional default value. */
+export async function promptInput(message, defaultValue) {
+    const response = await prompts({
+        type: 'text',
+        name: 'value',
+        message,
+        initial: defaultValue,
+    });
+    return response.value || '';
+}
+/** Yes/No confirmation, defaults to No (safe default). */
+export async function promptConfirm(message, defaultValue = false) {
+    const response = await prompts({
+        type: 'confirm',
+        name: 'value',
+        message,
+        initial: defaultValue,
+    });
+    return response.value || false;
+}
+/** Single-selection list. */
+export async function promptSelect(message, choices) {
+    const response = await prompts({
+        type: 'select',
+        name: 'value',
+        message,
+        choices: choices.map((c) => ({
+            title: c.name,
+            value: c.value,
+            description: c.description,
+        })),
+    });
+    return response.value;
+}
+/** Multi-selection checkbox list. */
+export async function promptMultiselect(message, choices) {
+    const response = await prompts({
+        type: 'multiselect',
+        name: 'value',
+        message,
+        choices: choices.map((c) => ({
+            title: c.name,
+            value: c.value,
+            description: c.description,
+        })),
+    });
+    return response.value;
+}
+/** Masked password / API key input. */
+export async function promptSecret(message) {
+    const response = await prompts({
+        type: 'password',
+        name: 'value',
+        message,
+        mask: '*',
+    });
+    return response.value || '';
+}
+// ─── Convenience ─────────────────────────────────────────────────────────────
+/** Ask "Apply these changes? (y/N)" — used by rewrite + run commands. */
+export async function promptApplyChanges(file) {
+    return promptConfirm(`Apply changes to ${file}?`, false);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAY9B,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,YAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO;QACb,OAAO;QACP,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,YAAY,GAAG,KAAK;IAEpB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,OAAO;QACP,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC;AACjC,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,OAA0B;IAE1B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,KAAK,EAAE,CAAC,CAAC,IAAI;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAU,CAAC;AAC7B,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,OAA0B;IAE1B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,OAAO;QACb,OAAO;QACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,KAAK,EAAE,CAAC,CAAC,IAAI;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAY,CAAC;AAC/B,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,OAAO;QACb,OAAO;QACP,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,gFAAgF;AAEhF,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,OAAO,aAAa,CAAC,oBAAoB,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC"}

package/dist/utils/reporter.d.ts

@@ -0,0 +1,17 @@
+import type { ScanReport } from "@saidksi/localizer-core";
+/**
+ * Write any serializable value to a JSON report file.
+ * Used by audit --output, scan --output, diff --output.
+ */
+export declare function writeReport(outputPath: string, data: unknown): Promise<void>;
+/**
+ * Write a ScanReport to disk with metadata.
+ * Auto-generates filename if outputPath is a directory.
+ * Auto-creates .localize/scan/ if needed.
+ * Prompts for confirmation if file exists.
+ *
+ * Transforms results to be grouped by file with relative paths,
+ * and removes column/surroundingCode fields.
+ */
+export declare function writeScanReport(outputPath: string, report: ScanReport, sourceFilePath?: string, cwd?: string): Promise<string>;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/utils/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/utils/reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAoC,MAAM,yBAAyB,CAAC;AAK5F;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAGf;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,EAClB,cAAc,CAAC,EAAE,MAAM,EACvB,GAAG,SAAgB,GAClB,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/utils/reporter.js

@@ -0,0 +1,87 @@
+import { writeFile, mkdir, access } from "fs/promises";
+import { resolve, basename, relative } from "path";
+import { promptConfirm } from "./prompt.js";
+// ─── JSON report writer ───────────────────────────────────────────────────────
+/**
+ * Write any serializable value to a JSON report file.
+ * Used by audit --output, scan --output, diff --output.
+ */
+export async function writeReport(outputPath, data) {
+    const absolute = resolve(outputPath);
+    await writeFile(absolute, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+/**
+ * Check if a file exists.
+ */
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate filename from a file or directory path.
+ * E.g., "src/pages/Login.tsx" → "login-scan.json"
+ * E.g., "src/pages" → "pages-scan.json"
+ */
+function generateScanFileName(filePath) {
+    const name = basename(filePath).replace(/\.(tsx?|jsx?)$/, "");
+    return `${name.toLowerCase()}-scan.json`;
+}
+/**
+ * Write a ScanReport to disk with metadata.
+ * Auto-generates filename if outputPath is a directory.
+ * Auto-creates .localize/scan/ if needed.
+ * Prompts for confirmation if file exists.
+ *
+ * Transforms results to be grouped by file with relative paths,
+ * and removes column/surroundingCode fields.
+ */
+export async function writeScanReport(outputPath, report, sourceFilePath, cwd = process.cwd()) {
+    const scanDir = resolve(cwd, ".localize", "scan");
+    await mkdir(scanDir, { recursive: true });
+    // If outputPath is just a flag with no value, auto-generate filename
+    let finalPath = resolve(scanDir, sourceFilePath ? generateScanFileName(sourceFilePath) : "scan-report.json");
+    // If outputPath is explicitly provided, use it (resolve relative to .localize/scan/)
+    if (outputPath && outputPath !== "true") {
+        finalPath = resolve(scanDir, outputPath);
+    }
+    // Check if file exists and prompt for confirmation
+    if (await fileExists(finalPath)) {
+        const overwrite = await promptConfirm(`File ${basename(finalPath)} already exists. Overwrite?`, false);
+        if (!overwrite) {
+            throw new Error("Aborted — file not overwritten.");
+        }
+    }
+    // Group results by file (with relative paths) and remove column/surroundingCode
+    const resultsByFile = {};
+    for (const result of report.results) {
+        // Convert to relative path with forward slashes (cross-platform)
+        const displayPath = relative(cwd, result.file).replace(/\\/g, "/");
+        if (!resultsByFile[displayPath]) {
+            resultsByFile[displayPath] = [];
+        }
+        resultsByFile[displayPath].push({
+            line: result.line,
+            value: result.value,
+            context: result.context,
+        });
+    }
+    // Add metadata to the report
+    const reportWithMetadata = {
+        metadata: {
+            generatedAt: new Date().toISOString(),
+            totalStrings: report.results.length,
+            uniqueStrings: new Set(report.results.map((r) => r.value)).size,
+            untranslatedStrings: report.results.filter((r) => !r.alreadyTranslated).length,
+            filesScanned: Object.keys(resultsByFile).length,
+        },
+        results: resultsByFile,
+    };
+    await writeFile(finalPath, JSON.stringify(reportWithMetadata, null, 2) + "\n", "utf-8");
+    return finalPath;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/utils/reporter.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@saidksi/localizer-cli",
+  "version": "0.1.1",
+  "description": "CLI tool for automating i18n workflows in JavaScript/TypeScript projects with localizer",
+  "type": "module",
+  "bin": {
+    "localize": "dist/bin/localize.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "bin"],
+  "scripts": {
+    "build": "tsc && chmod +x dist/bin/localize.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "localization",
+    "cli",
+    "automation",
+    "typescript"
+  ],
+  "author": "SaidKSI",
+  "license": "MIT",
+  "packageManager": "pnpm@10.33.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SaidKSI/localize-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SaidKSI/localize-cli/issues"
+  },
+  "homepage": "https://github.com/SaidKSI/localize-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@saidksi/localizer-core": "^0.1.1",
+    "commander": "^11.1.0",
+    "cosmiconfig": "^8.3.6",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "@vitest/coverage-v8": "^2.1.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=8.0.0"
+  }
+}