gooseworks 0.2.2 → 0.2.5

package/dist/commands/graphics/get-flow.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Generic `get <slug>` flow shared by styles + formats.
+ *
+ * Default output: hits the markdown endpoint (design.md or spec.md), prints
+ * the body to stdout, with ETag-keyed disk cache and offline fallback.
+ *
+ * --json: hits the JSON record endpoint and prints it to stdout.
+ *
+ * --include-examples: also downloads example PNGs from the JSON record into
+ * ./<slug>/<format>.png (current working directory).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGetFlow = runGetFlow;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const graphics_api_1 = require("../../lib/graphics-api");
+const graphics_api_2 = require("../../lib/graphics-api");
+const graphics_cache_1 = require("../../lib/graphics-cache");
+const graphics_manifest_1 = require("../../lib/graphics-manifest");
+const shared_1 = require("./shared");
+async function runGetFlow(cfg, slug, opts) {
+    if (opts.json) {
+        await emitJson(cfg, slug, !!opts.includeExamples, !!opts.noCache);
+        return;
+    }
+    await emitMarkdown(cfg, slug, !!opts.noCache);
+    if (opts.includeExamples) {
+        await downloadExamples(cfg, slug);
+    }
+}
+async function emitMarkdown(cfg, slug, noCache) {
+    const cached = noCache ? null : (0, graphics_cache_1.readCache)(cfg.resource, slug, 'md');
+    const etag = cached?.etag ?? null;
+    try {
+        const res = await cfg.fetchMarkdown(slug, etag);
+        if (res.status === 304 && cached) {
+            process.stdout.write(cached.body);
+            if (!cached.body.endsWith('\n'))
+                process.stdout.write('\n');
+            return;
+        }
+        if (res.status === 200 && res.body !== null) {
+            if (!noCache)
+                (0, graphics_cache_1.writeCache)(cfg.resource, slug, 'md', res.body, res.etag);
+            process.stdout.write(res.body);
+            if (!res.body.endsWith('\n'))
+                process.stdout.write('\n');
+            return;
+        }
+        // 304 with no cached body shouldn't happen in practice — fall through.
+        process.stderr.write('Unexpected 304 with no cached body.\n');
+        process.exit(1);
+    }
+    catch (err) {
+        if (cached && (err instanceof graphics_api_1.NetworkError || isTransientApiError(err))) {
+            process.stderr.write(`Warning: ${describeFetchError(err)} — serving cached copy.\n`);
+            process.stdout.write(cached.body);
+            if (!cached.body.endsWith('\n'))
+                process.stdout.write('\n');
+            return;
+        }
+        (0, shared_1.reportApiErrorAndExit)(err);
+    }
+}
+async function emitJson(cfg, slug, includeExamples, noCache) {
+    const cached = noCache ? null : (0, graphics_cache_1.readCache)(cfg.resource, slug, 'json');
+    const cachedEtag = cached?.etag ?? null;
+    let recordData;
+    try {
+        const res = await cfg.fetchRecord(slug, cachedEtag);
+        if (res.status === 304 && cached) {
+            recordData = JSON.parse(cached.body).data;
+        }
+        else if (res.status === 200 && res.envelope) {
+            recordData = res.envelope.data;
+            if (!noCache) {
+                (0, graphics_cache_1.writeCache)(cfg.resource, slug, 'json', JSON.stringify(res.envelope, null, 2), res.etag);
+            }
+        }
+        else {
+            process.stderr.write('Unexpected 304 with no cached body.\n');
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        if (cached && (err instanceof graphics_api_1.NetworkError || isTransientApiError(err))) {
+            process.stderr.write(`Warning: ${describeFetchError(err)} — serving cached copy.\n`);
+            // The cached body is the full envelope; print just `.data` to match
+            // the freshly-fetched output shape.
+            try {
+                const parsed = JSON.parse(cached.body);
+                process.stdout.write(JSON.stringify(parsed.data, null, 2));
+            }
+            catch {
+                process.stdout.write(cached.body);
+            }
+            process.stdout.write('\n');
+            return;
+        }
+        (0, shared_1.reportApiErrorAndExit)(err);
+    }
+    process.stdout.write(JSON.stringify(recordData, null, 2));
+    process.stdout.write('\n');
+    if (includeExamples) {
+        await downloadExamplesFromRecord(recordData, slug);
+    }
+}
+async function downloadExamples(cfg, slug) {
+    let recordData;
+    try {
+        const res = await cfg.fetchRecord(slug, null);
+        if (res.status !== 200 || !res.envelope) {
+            process.stderr.write('Could not download examples: empty record response.\n');
+            return;
+        }
+        recordData = res.envelope.data;
+    }
+    catch (err) {
+        process.stderr.write(`Could not download examples: ${describeFetchError(err)}\n`);
+        return;
+    }
+    await downloadExamplesFromRecord(recordData, slug);
+}
+async function downloadExamplesFromRecord(record, slug) {
+    const examples = (record.examples ?? []);
+    if (examples.length === 0) {
+        process.stderr.write('No examples to download.\n');
+        return;
+    }
+    // The directory name comes from the user-supplied CLI slug, not record.slug,
+    // and we re-validate before using it as a path component.
+    if (!graphics_manifest_1.SLUG_RE.test(slug)) {
+        process.stderr.write(`Refusing to write examples: slug '${slug}' is not a valid slug.\n`);
+        return;
+    }
+    const targetDir = path.resolve(process.cwd(), slug);
+    fs.mkdirSync(targetDir, { recursive: true });
+    for (const ex of examples) {
+        const url = ex.url || ex.imageUrl;
+        if (!url)
+            continue;
+        if (!isSafeDownloadUrl(url)) {
+            process.stderr.write(`  skipped ${url}: only http(s) URLs are downloaded\n`);
+            continue;
+        }
+        const format = typeof ex.format === 'string' && graphics_manifest_1.SLUG_RE.test(ex.format) ? ex.format : 'example';
+        const fileName = `${format}.png`;
+        try {
+            const bytes = await (0, graphics_api_2.downloadBytes)(url);
+            const dest = path.join(targetDir, fileName);
+            fs.writeFileSync(dest, bytes);
+            process.stderr.write(`  saved ${path.relative(process.cwd(), dest)}\n`);
+        }
+        catch (err) {
+            process.stderr.write(`  failed to download ${url}: ${describeFetchError(err)}\n`);
+        }
+    }
+}
+function isSafeDownloadUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'https:' || parsed.protocol === 'http:';
+    }
+    catch {
+        return false;
+    }
+}
+function isTransientApiError(err) {
+    return err instanceof graphics_api_1.ApiError && err.status >= 500;
+}
+function describeFetchError(err) {
+    if (err instanceof graphics_api_1.NetworkError)
+        return `network unreachable (${err.message})`;
+    if (err instanceof graphics_api_1.ApiError)
+        return `server error ${err.status}`;
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=get-flow.js.map

package/dist/commands/graphics/get-flow.js.map

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

package/dist/commands/graphics/publish-flow.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generic publish/update orchestration shared by the styles and formats
+ * commands.  Handles manifest read + validate + slug overlay, multipart
+ * upload, and the 409 slug-collision retry loop.
+ */
+import { type ValidationResult, type ResolvedExampleFile } from '../../lib/graphics-manifest';
+import { type WriteResult } from '../../lib/graphics-api';
+export interface PublishConfig {
+    manifestFilename: string;
+    validate: (manifest: unknown) => ValidationResult;
+    /** Hub URL to print on success, e.g. `https://app.gooseworks.ai/styles/<slug>`. */
+    hubUrl: (slug: string) => string;
+    /** Resource label used in user-facing messages: 'style' or 'format'. */
+    label: 'style' | 'format';
+    /** Performs the create/update upload. Returns the new slug + id. */
+    upload: (manifest: Record<string, unknown>, files: ResolvedExampleFile[]) => Promise<WriteResult>;
+}
+export interface PublishOptions {
+    /** Defaults to process.cwd(). */
+    dir?: string;
+    /** Override the manifest's slug at publish time. */
+    slug?: string;
+    /** Skip interactive prompts. */
+    yes?: boolean;
+}
+export declare function runPublishFlow(cfg: PublishConfig, opts: PublishOptions): Promise<void>;
+export declare function runUpdateFlow(cfg: PublishConfig, opts: PublishOptions): Promise<void>;
+//# sourceMappingURL=publish-flow.d.ts.map

package/dist/commands/graphics/publish-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-flow.d.ts","sourceRoot":"","sources":["../../../src/commands/graphics/publish-flow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOpE,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,gBAAgB,CAAC;IAClD,mFAAmF;IACnF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,wEAAwE;IACxE,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,oEAAoE;IACpE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACnG;AAED,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAyBD,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/commands/graphics/publish-flow.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * Generic publish/update orchestration shared by the styles and formats
+ * commands.  Handles manifest read + validate + slug overlay, multipart
+ * upload, and the 409 slug-collision retry loop.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPublishFlow = runPublishFlow;
+exports.runUpdateFlow = runUpdateFlow;
+const path = __importStar(require("path"));
+const graphics_manifest_1 = require("../../lib/graphics-manifest");
+const graphics_api_1 = require("../../lib/graphics-api");
+const shared_1 = require("./shared");
+function formatValidationErrors(errors) {
+    return errors.map((e) => `  • ${e}`).join('\n');
+}
+function formatServerValidationErrors(body) {
+    if (!body?.errors)
+        return '';
+    return body.errors
+        .map((e) => {
+        if (typeof e === 'string')
+            return `  • ${e}`;
+        if (e.path)
+            return `  • ${e.path}: ${e.message ?? 'invalid'}`;
+        return `  • ${e.message ?? 'invalid'}`;
+    })
+        .join('\n');
+}
+async function runPublishFlow(cfg, opts) {
+    await runWriteFlow(cfg, opts, /* allowSlugRetry */ true);
+}
+async function runUpdateFlow(cfg, opts) {
+    // Update has no slug-collision retry — the slug is already locked.
+    await runWriteFlow(cfg, opts, /* allowSlugRetry */ false);
+}
+async function runWriteFlow(cfg, opts, allowSlugRetry) {
+    const dir = path.resolve(opts.dir ?? process.cwd());
+    const manifestPath = path.join(dir, cfg.manifestFilename);
+    let manifest;
+    try {
+        manifest = (0, graphics_manifest_1.readManifestFile)(manifestPath);
+    }
+    catch (err) {
+        if (err instanceof graphics_manifest_1.ManifestParseError) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        throw err;
+    }
+    if (typeof manifest !== 'object' || manifest === null || Array.isArray(manifest)) {
+        process.stderr.write(`${cfg.manifestFilename} must contain a JSON object.\n`);
+        process.exit(shared_1.EXIT_USER_ERROR);
+    }
+    if (opts.slug) {
+        manifest.slug = opts.slug;
+    }
+    validateOrExit(cfg, manifest);
+    const examples = manifest.examples ?? [];
+    let files;
+    try {
+        files = (0, graphics_manifest_1.resolveExampleFiles)(dir, examples);
+    }
+    catch (err) {
+        if (err instanceof graphics_manifest_1.ManifestMissingFileError) {
+            process.stderr.write(`Manifest references file '${err.missing}' but it doesn't exist in ${dir}.\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        if (err instanceof graphics_manifest_1.ManifestEscapingPathError) {
+            process.stderr.write(`Manifest references file '${err.ref}' which escapes the manifest directory ${dir}.\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        throw err;
+    }
+    const result = await uploadOrExit(cfg, opts, manifest, files, allowSlugRetry);
+    process.stdout.write(`${cfg.label === 'style' ? 'Published style' : 'Published format'}: ${result.slug}\n` +
+        `${cfg.hubUrl(result.slug)}\n`);
+}
+function validateOrExit(cfg, manifest) {
+    const validation = cfg.validate(manifest);
+    if (!validation.ok) {
+        process.stderr.write(`Manifest validation failed:\n${formatValidationErrors(validation.errors)}\n`);
+        process.exit(shared_1.EXIT_USER_ERROR);
+    }
+}
+async function uploadOrExit(cfg, opts, manifest, files, allowSlugRetry) {
+    try {
+        return await cfg.upload(manifest, files);
+    }
+    catch (err) {
+        if (!(err instanceof graphics_api_1.ApiError))
+            (0, shared_1.reportApiErrorAndExit)(err);
+        const body = (err.body || {});
+        if (err.status === 400 && body.error === 'validation_failed') {
+            const lines = formatServerValidationErrors(body);
+            process.stderr.write(`Server validation failed${lines ? `:\n${lines}` : ''}\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        if (err.status === 400 && body.error === 'missing_file') {
+            process.stderr.write(`Server says file '${body.file ?? '?'}' is missing from the upload.\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        if (err.status === 400 && body.error === 'manifest_parse') {
+            process.stderr.write(`Server could not parse manifest: ${body.message ?? 'unknown'}\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        if (err.status === 413) {
+            process.stderr.write(`File too large: ${body.file ?? 'one of the uploaded files'} (max 10 MB).\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        if (err.status === 403) {
+            process.stderr.write(`You don't own this ${cfg.label}. Only its author can update or delete it.\n`);
+            process.exit(shared_1.EXIT_USER_ERROR);
+        }
+        if (err.status === 409 && body.error === 'slug_taken' && allowSlugRetry) {
+            return await retryWithSuggestedSlug(cfg, opts, manifest, files, body);
+        }
+        (0, shared_1.reportApiErrorAndExit)(err);
+    }
+}
+async function retryWithSuggestedSlug(cfg, opts, manifest, files, body) {
+    const suggested = body.suggested_slug;
+    if (!suggested) {
+        process.stderr.write(`Slug taken and the server didn't suggest an alternative.\n`);
+        process.exit(shared_1.EXIT_USER_ERROR);
+    }
+    const accept = opts.yes ||
+        (await (0, shared_1.promptYesNo)(`Slug '${manifest.slug ?? '?'}' is taken. Use '${suggested}' instead?`, true));
+    if (!accept) {
+        process.stderr.write(`Aborted: slug collision unresolved.\n`);
+        process.exit(shared_1.EXIT_USER_ERROR);
+    }
+    manifest.slug = suggested;
+    // Re-run client validation: the server's suggestion could in principle
+    // fail our slug grammar, and shipping a broken value to the server
+    // produces an opaque second error rather than a clean local message.
+    validateOrExit(cfg, manifest);
+    try {
+        return await cfg.upload(manifest, files);
+    }
+    catch (retryErr) {
+        (0, shared_1.reportApiErrorAndExit)(retryErr);
+    }
+}
+//# sourceMappingURL=publish-flow.js.map

package/dist/commands/graphics/publish-flow.js.map

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

package/dist/commands/graphics/shared.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared helpers for the styles/formats command families.
+ *
+ * Exit codes follow the spec:
+ *   0 = success
+ *   1 = transient or auth error (network, 401, 5xx)
+ *   2 = user error (bad input, 400, 403, 404, declined 409)
+ */
+import { type Credentials } from '../../auth/credentials';
+export declare const EXIT_OK = 0;
+export declare const EXIT_TRANSIENT = 1;
+export declare const EXIT_USER_ERROR = 2;
+export declare function requireCredentials(): Credentials;
+export declare function getOptionalCredentials(): Credentials | null;
+/**
+ * Build the api-client options for read-only commands. Falls back to the
+ * compiled-in API_BASE when the user is not logged in, so anonymous reads
+ * still work.
+ */
+export declare function clientOpts(): {
+    apiBase: string;
+    apiKey: string | null;
+};
+/** Build api-client options for commands that require auth (publish/update/delete). */
+export declare function authedClientOpts(): {
+    apiBase: string;
+    apiKey: string;
+};
+/**
+ * Parse a non-negative integer command-line option. Exits with the user-error
+ * code if the value is malformed.
+ */
+export declare function parseIntOpt(value: string | undefined, name: string): number | undefined;
+/**
+ * Translate a thrown error from the API client into a stderr message + exit
+ * code. Never re-throws.
+ */
+export declare function reportApiErrorAndExit(err: unknown): never;
+export declare function promptYesNo(question: string, defaultYes?: boolean): Promise<boolean>;
+interface ColumnDef<T> {
+    header: string;
+    get: (row: T) => string;
+    pad?: 'left' | 'right';
+}
+export declare function renderTable<T>(rows: T[], columns: ColumnDef<T>[]): string;
+export declare function truncate(s: string | null | undefined, max: number): string;
+export {};
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/graphics/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/graphics/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK1E,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,wBAAgB,kBAAkB,IAAI,WAAW,CAOhD;AAED,wBAAgB,sBAAsB,IAAI,WAAW,GAAG,IAAI,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAMvE;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGtE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQvF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CA8BzD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBlF;AAED,UAAU,SAAS,CAAC,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAkBzE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI1E"}