formatferry 0.1.3 → 1.0.0

package/dist/entitlement.js

@@ -0,0 +1,91 @@
+/**
+ * CLI startup license validation with caching (Design §5.5)
+ * Validates: Requirements 10.1–10.7
+ */
+import { readConfig, writeConfig, clearConfig } from './config-store.js';
+import { FreeEntitlementProvider, CachedEntitlementProvider, } from '../../../src/shared/entitlement-service.js';
+const LICENSE_SERVER_URL = 'https://formatferry.vibingfun.com';
+const VALIDATE_ENDPOINT = `${LICENSE_SERVER_URL}/v1/licenses/validate`;
+const STARTUP_TIMEOUT_MS = 2_000;
+const STALE_CACHE_DAYS = 7;
+/**
+ * Resolve the entitlement provider for the current CLI session.
+ * Called once at CLI startup before any command runs.
+ */
+export async function resolveEntitlement() {
+    // Req 10.7: Corrupted ConfigStore → silently discard, free tier
+    let config;
+    try {
+        config = readConfig();
+    }
+    catch {
+        return new FreeEntitlementProvider();
+    }
+    if (!config || !config.licenseKey) {
+        return new FreeEntitlementProvider();
+    }
+    const { licenseKey, lastValidated } = config;
+    // Req 10.1: Ping License Server with 2s timeout
+    let data = null;
+    let networkError = false;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), STARTUP_TIMEOUT_MS);
+        const response = await fetch(VALIDATE_ENDPOINT, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ key: licenseKey }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        data = (await response.json());
+    }
+    catch {
+        networkError = true;
+    }
+    if (!networkError && data !== null) {
+        // Req 10.6: Revoked → delete key, downgrade to free
+        if (data.revoked) {
+            clearConfig();
+            return new FreeEntitlementProvider();
+        }
+        if (!data.valid) {
+            return new FreeEntitlementProvider();
+        }
+        // Req 10.2 + 10.4: valid → update cache with fresh data + ISO 8601 timestamp
+        const freshState = {
+            tier: data.tier ?? 'premium',
+            features: (data.features ?? []),
+            expiresAt: data.expiresAt ?? null,
+            lastValidated: new Date().toISOString(),
+        };
+        writeConfig({
+            ...config,
+            tier: freshState.tier,
+            features: freshState.features,
+            expiresAt: freshState.expiresAt,
+            lastValidated: freshState.lastValidated,
+        });
+        return new CachedEntitlementProvider(freshState);
+    }
+    // Req 10.3 + 10.5: Network error/timeout — check cache age
+    const cacheAgeMs = lastValidated
+        ? Date.now() - new Date(lastValidated).getTime()
+        : Infinity;
+    const staleCacheMs = STALE_CACHE_DAYS * 24 * 60 * 60 * 1000;
+    if (cacheAgeMs < staleCacheMs) {
+        // Req 10.3: Fresh cache → use cached entitlements
+        const cachedState = {
+            tier: config.tier ?? 'free',
+            features: (config.features ?? []),
+            expiresAt: config.expiresAt ?? null,
+            lastValidated: lastValidated ?? '',
+        };
+        return new CachedEntitlementProvider(cachedState);
+    }
+    // Req 10.5: Stale cache + unreachable → warn stderr, free tier
+    process.stderr.write('Warning: Could not reach license server and cached license is older than 7 days. ' +
+        'Operating in free tier. Please reconnect to validate your license.\n');
+    return new FreeEntitlementProvider();
+}
+//# sourceMappingURL=entitlement.js.map

package/dist/entitlement.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import './shim.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,CAAC"}

package/dist/index.js

@@ -20984,7 +20984,7 @@ h${level}. ${trimmed}
       case "commonmark":
         service = this.commonmarkService;
         break;
-      case "custom":
+      case "gdocs":
         service = this.customService;
         options.customRules.forEach((rule) => {
           service.addRule(rule.name, {
@@ -21074,9 +21074,9 @@ h${level}. ${trimmed}
         description: "Strict CommonMark specification with indented code blocks"
       },
       {
-        value: "custom",
+        value: "gdocs",
         label: "Custom Rules",
-        description: "GitHub base with additional custom conversion rules"
+        description: "Optimized for Google Docs structure"
       }
     ];
   }
@@ -21957,16 +21957,17 @@ function clearConfig() {
   }
 }
 
-// ../../src/shared/entitlement-service.ts
+// ../../src/shared/entitlement-service.js
 var FreeEntitlementProvider = class {
   getState() {
     return { tier: "free", features: [], expiresAt: null, lastValidated: "" };
   }
-  hasFeature(_feature) {
+  hasFeature() {
     return false;
   }
 };
 var CachedEntitlementProvider = class {
+  state;
   constructor(state) {
     this.state = state;
   }
@@ -22521,7 +22522,7 @@ var VALID_FORMATS = [
   "discord",
   "reddit",
   "confluence",
-  "custom",
+  "gdocs",
   "rmarkdown"
 ];
 function detectInputType(filePath) {
@@ -22557,13 +22558,13 @@ Supported formats: ${VALID_FORMATS.join(", ")}
   process.exit(1);
 }
 function readStdin() {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (chunk) => {
       data += chunk;
     });
-    process.stdin.on("end", () => resolve(data));
+    process.stdin.on("end", () => resolve2(data));
     process.stdin.on("error", reject);
   });
 }
@@ -23101,15 +23102,34 @@ function handleLogout() {
 }
 
 // src/index.ts
-var VERSION = "0.1.0";
-program.name("formatferry").version(VERSION).description("Convert HTML, DOCX, PDF, XLSX, CSV to Markdown").option("-i, --input <path>", "Input file path").option("-o, --output <path>", "Output file path").option("-f, --format <format>", "Markdown format (github, commonmark, slack, discord, reddit, confluence, custom, rmarkdown)", "github").option("--url <url>", "Fetch article from URL").option("--batch <glob>", "Batch convert files (Premium)").option("--output-dir <dir>", "Output directory for batch").option("--toonify", "Compress output to TOON format (Premium)").option("--offline", "Skip entitlement check (use cached or free tier)").option("--timeout <ms>", "License server timeout in milliseconds (default: 2000)", "2000").action(async (options) => {
+import { readFileSync as readFileSync4 } from "fs";
+import { resolve, dirname as dirname3 } from "path";
+import { fileURLToPath } from "url";
+var getVersion = () => {
+  if ("1.0.0") {
+    return "1.0.0";
+  }
+  try {
+    const __dirname = dirname3(fileURLToPath(import.meta.url));
+    const packageJson = JSON.parse(
+      readFileSync4(resolve(__dirname, "..", "package.json"), "utf-8")
+    );
+    return packageJson.version || "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+};
+var VERSION = getVersion();
+program.name("formatferry").version(VERSION).description("Convert HTML, DOCX, PDF, XLSX, CSV to Markdown").option("-i, --input <path>", "Input file path").option("-o, --output <path>", "Output file path").option("-f, --format <format>", "Markdown format (github, commonmark, slack, discord, reddit, confluence, gdocs, rmarkdown)", "github").option("--url <url>", "Fetch article from URL").option("--batch <glob>", "Batch convert files (Premium)").option("--output-dir <dir>", "Output directory for batch").option("--toonify", "Compress output to TOON format (Premium)").option("--offline", "Skip entitlement check (use cached or free tier)").option("--timeout <ms>", "License server timeout in milliseconds (default: 2000)", "2000").action(async (options) => {
   if (options.batch) {
     await batchCommand(options);
   } else {
     await convertCommand(options);
   }
 });
-program.command("auth").description("Manage license key and API key authentication").option("--license-key <key>", "Activate a license key").option("--api-key <key>", "Activate an API key").option("--status", "Show current license status").option("--logout", "Remove stored license key").action(authCommand);
+program.command("auth").description("Manage license key and API key authentication").option("--license-key <key>", "Activate a license key").option("--api-key <key>", "Activate an API key").option("--status", "Show current license status").option("--logout", "Remove stored license key").action(async (options) => {
+  await authCommand(options);
+});
 program.parse();
 /*! Bundled license information:
 

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,kDAAkD;AAClD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;KACjD,MAAM,CAAC,uBAAuB,EAAE,kEAAkE,EAAE,QAAQ,CAAC;KAC7G,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC;KAC/C,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;KACzD,MAAM,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;KAC1D,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,kBAAkB;AAClB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;KACvD,MAAM,CAAC,UAAU,EAAE,6BAA6B,CAAC;KACjD,MAAM,CAAC,UAAU,EAAE,2BAA2B,CAAC;KAC/C,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/packages/cli/src/commands/auth.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI auth command — license key management.
+ *
+ * Sub-commands (via options):
+ *   formatferry auth --license-key <KEY>   Validate + store license key (Req 9.1, 9.3, 9.4)
+ *   formatferry auth --status              Show current tier/expiry/features (Req 9.6)
+ *   formatferry auth --logout              Remove stored license key (Req 9.7)
+ *
+ * License Server: POST https://formatferry.vibingfun.com/v1/licenses/validate
+ */
+export interface AuthOptions {
+    licenseKey?: string;
+    status?: boolean;
+    logout?: boolean;
+}
+export declare function authCommand(options: AuthOptions): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/packages/cli/src/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrE"}

package/dist/packages/cli/src/commands/auth.js

@@ -0,0 +1,102 @@
+/**
+ * CLI auth command — license key management.
+ *
+ * Sub-commands (via options):
+ *   formatferry auth --license-key <KEY>   Validate + store license key (Req 9.1, 9.3, 9.4)
+ *   formatferry auth --status              Show current tier/expiry/features (Req 9.6)
+ *   formatferry auth --logout              Remove stored license key (Req 9.7)
+ *
+ * License Server: POST https://formatferry.vibingfun.com/v1/licenses/validate
+ */
+import { readConfig, writeConfig, clearConfig } from '../config-store.js';
+const LICENSE_SERVER_URL = 'https://formatferry.vibingfun.com';
+const VALIDATE_ENDPOINT = `${LICENSE_SERVER_URL}/v1/licenses/validate`;
+const TIMEOUT_MS = 10_000;
+export async function authCommand(options) {
+    if (options.licenseKey) {
+        await handleLicenseKey(options.licenseKey);
+    }
+    else if (options.status) {
+        handleStatus();
+    }
+    else if (options.logout) {
+        handleLogout();
+    }
+    else {
+        handleStatus();
+    }
+}
+// ─── --license-key ────────────────────────────────────────────────────────────
+async function handleLicenseKey(key) {
+    let data;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        const response = await fetch(VALIDATE_ENDPOINT, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ key }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        data = (await response.json());
+        if (!response.ok && !data.valid) {
+            process.stderr.write(`Error: Invalid license key. Please check your key and try again.\n`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: Could not reach license server — ${msg}\n`);
+        process.exit(1);
+    }
+    if (data.revoked) {
+        process.stderr.write(`Error: This license key has been revoked.\n`);
+        process.exit(1);
+    }
+    if (!data.valid) {
+        process.stderr.write(`Error: Invalid license key. Please check your key and try again.\n`);
+        process.exit(1);
+    }
+    writeConfig({
+        licenseKey: key,
+        tier: data.tier ?? 'premium',
+        features: data.features ?? [],
+        expiresAt: data.expiresAt ?? null,
+        lastValidated: new Date().toISOString(),
+    });
+    const features = data.features ?? [];
+    process.stdout.write(`License activated successfully!\n`);
+    process.stdout.write(`Tier: ${data.tier ?? 'premium'}\n`);
+    if (data.expiresAt) {
+        process.stdout.write(`Expires: ${data.expiresAt}\n`);
+    }
+    if (features.length > 0) {
+        process.stdout.write(`Unlocked features: ${features.join(', ')}\n`);
+    }
+}
+// ─── --status ─────────────────────────────────────────────────────────────────
+function handleStatus() {
+    const config = readConfig();
+    if (!config || !config.licenseKey) {
+        process.stdout.write(`Tier: free\n`);
+        process.stdout.write(`No license key configured.\n`);
+        return;
+    }
+    const tier = config.tier ?? 'free';
+    const features = config.features ?? [];
+    const expiresAt = config.expiresAt ?? null;
+    process.stdout.write(`Tier: ${tier}\n`);
+    if (expiresAt) {
+        process.stdout.write(`Expires: ${expiresAt}\n`);
+    }
+    if (features.length > 0) {
+        process.stdout.write(`Features: ${features.join(', ')}\n`);
+    }
+}
+// ─── --logout ─────────────────────────────────────────────────────────────────
+function handleLogout() {
+    clearConfig();
+    process.stdout.write(`Logged out. License key removed.\n`);
+}
+//# sourceMappingURL=auth.js.map

package/dist/packages/cli/src/commands/auth.js.map

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

package/dist/packages/cli/src/commands/batch.d.ts

@@ -0,0 +1,10 @@
+export interface BatchOptions {
+    batch?: string;
+    outputDir?: string;
+    format?: string;
+    [key: string]: unknown;
+}
+/** Derive the output .md path. Req 8.2 (same dir) / Req 8.3 (outputDir) */
+export declare function getOutputPath(filePath: string, outputDir?: string): string;
+export declare function batchCommand(options: BatchOptions): Promise<void>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/packages/cli/src/commands/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../../../src/commands/batch.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAkCD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCvE"}

package/dist/packages/cli/src/commands/batch.js

@@ -0,0 +1,92 @@
+/**
+ * CLI batch command
+ *
+ * Batch-converts files matching a glob pattern to Markdown.
+ * Supports --output-dir for writing all outputs to a single directory.
+ * Gated behind the 'batch' Premium entitlement.
+ *
+ * Requirements: 8.1, 8.2, 8.3, 8.4, 8.5, 8.6
+ */
+import fg from 'fast-glob';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { extname, basename, dirname, join } from 'path';
+import { resolveEntitlement } from '../entitlement.js';
+import { ConversionEngine } from '../../../../src/shared/conversion-engine.js';
+import { sanitizeHTML } from '../../../../src/shared/input-sanitizer.js';
+import { docxAdapter } from '../../../../src/shared/adapters/docx-adapter.js';
+import { pdfAdapter } from '../../../../src/shared/adapters/pdf-adapter.js';
+import { spreadsheetAdapter } from '../../../../src/shared/adapters/spreadsheet-adapter.js';
+const SUPPORTED_EXTENSIONS = new Set(['.html', '.htm', '.docx', '.pdf', '.xlsx', '.csv']);
+/** Derive the output .md path. Req 8.2 (same dir) / Req 8.3 (outputDir) */
+export function getOutputPath(filePath, outputDir) {
+    const ext = extname(filePath);
+    const stem = basename(filePath, ext);
+    if (outputDir)
+        return join(outputDir, `${stem}.md`);
+    return join(dirname(filePath), `${stem}.md`);
+}
+async function convertFile(filePath, format) {
+    const ext = extname(filePath).toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.has(ext))
+        throw new Error(`Unsupported file type: ${ext}`);
+    const buffer = readFileSync(filePath);
+    const engine = new ConversionEngine();
+    if (ext === '.html' || ext === '.htm') {
+        const result = await engine.convert(sanitizeHTML(buffer.toString('utf8')), {
+            format, preserveTables: true, preserveLists: true, customRules: [],
+        });
+        return result.markdown;
+    }
+    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    if (ext === '.docx') {
+        const r = await docxAdapter.parseToHtml(arrayBuffer);
+        const c = await engine.convert(sanitizeHTML(r.html), { format, preserveTables: true, preserveLists: true, customRules: [] });
+        return c.markdown;
+    }
+    if (ext === '.pdf') {
+        const r = await pdfAdapter.parseToText(arrayBuffer);
+        const c = await engine.convert(sanitizeHTML(r.html), { format, preserveTables: true, preserveLists: true, customRules: [] });
+        return c.markdown;
+    }
+    // .xlsx / .csv
+    const r = await spreadsheetAdapter.parseToHtml(arrayBuffer, ext.slice(1), 0);
+    const c = await engine.convert(sanitizeHTML(r.html), { format, preserveTables: true, preserveLists: true, customRules: [] });
+    return c.markdown;
+}
+export async function batchCommand(options) {
+    // Req 8.4: entitlement check
+    const provider = await resolveEntitlement();
+    if (!provider.hasFeature('batch')) {
+        process.stderr.write('Error: Batch processing requires a Premium license.\n' +
+            'Run `formatferry auth --license-key <KEY>` to activate your license.\n');
+        process.exit(1);
+    }
+    const glob = options.batch;
+    if (!glob) {
+        process.stderr.write('Error: --batch <glob> is required\n');
+        process.exit(1);
+    }
+    const files = await fg(glob, { absolute: true });
+    if (files.length === 0) {
+        process.stderr.write(`No files matched: ${glob}\n`);
+        process.exit(1);
+    }
+    const format = options.format ?? 'github';
+    if (options.outputDir)
+        mkdirSync(options.outputDir, { recursive: true });
+    let successful = 0, failed = 0;
+    for (const filePath of files) {
+        try {
+            const markdown = await convertFile(filePath, format);
+            writeFileSync(getOutputPath(filePath, options.outputDir), markdown, 'utf8');
+            successful++;
+        }
+        catch (err) {
+            process.stderr.write(`Error processing ${filePath}: ${err instanceof Error ? err.message : String(err)}\n`);
+            failed++;
+        }
+    }
+    // Req 8.5: summary
+    process.stderr.write(`\nBatch complete: ${successful} succeeded, ${failed} failed, ${files.length} total\n`);
+}
+//# sourceMappingURL=batch.js.map

package/dist/packages/cli/src/commands/batch.js.map

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

package/dist/packages/cli/src/commands/convert.d.ts

@@ -0,0 +1,26 @@
+import { type MarkdownFormat } from '../../../../src/shared/conversion-engine.js';
+/** Supported input file types */
+type InputType = 'html' | 'docx' | 'pdf' | 'xlsx' | 'csv';
+/**
+ * Detect input type from file extension.
+ * Writes error to stderr and exits with code 1 on unsupported extension.
+ */
+export declare function detectInputType(filePath: string): InputType;
+/**
+ * Validate the --format flag value.
+ * Writes error to stderr and exits with code 1 on unknown format.
+ */
+export declare function validateFormat(format: string): MarkdownFormat;
+/** Options passed by Commander to the convert action */
+export interface ConvertOptions {
+    input?: string;
+    output?: string;
+    format?: string;
+}
+/**
+ * Main convert command action.
+ * Called by Commander when the user runs `formatferry [options]`.
+ */
+export declare function convertCommand(options: ConvertOptions): Promise<void>;
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/packages/cli/src/commands/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../../../src/commands/convert.ts"],"names":[],"mappings":"AAUA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAQtF,iCAAiC;AACjC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAW1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAkB3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAQ7D;AA8FD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE3E"}