gooseworks 0.2.2 → 0.2.5

package/dist/lib/graphics-api.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * HTTP client for the Gooseworks graphics API.
+ *
+ * Uses the global fetch (Node 18+) and FormData/Blob for multipart uploads.
+ * Endpoint shapes are documented in gooseworks-app GOOSE-1468.
+ */
+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.NetworkError = exports.ApiError = void 0;
+exports.listStyles = listStyles;
+exports.listFormats = listFormats;
+exports.getStyleRecord = getStyleRecord;
+exports.getFormatRecord = getFormatRecord;
+exports.getStyleDesignMd = getStyleDesignMd;
+exports.getFormatSpecMd = getFormatSpecMd;
+exports.publishStyle = publishStyle;
+exports.updateStyle = updateStyle;
+exports.deleteStyle = deleteStyle;
+exports.publishFormat = publishFormat;
+exports.updateFormat = updateFormat;
+exports.deleteFormat = deleteFormat;
+exports.downloadBytes = downloadBytes;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class ApiError extends Error {
+    status;
+    code;
+    body;
+    constructor(status, code, message, body) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.body = body;
+        this.name = 'ApiError';
+    }
+}
+exports.ApiError = ApiError;
+class NetworkError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+function authHeaders(apiKey) {
+    return apiKey ? { Authorization: `Bearer ${apiKey}` } : {};
+}
+async function readJsonSafe(res) {
+    const text = await res.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function extractMessage(body, fallback) {
+    if (body && typeof body === 'object') {
+        const env = body;
+        if (typeof env.message === 'string')
+            return env.message;
+        if (typeof env.error === 'string')
+            return env.error;
+    }
+    return fallback;
+}
+async function asApiError(res, defaultMessage) {
+    const body = await readJsonSafe(res);
+    let code = null;
+    if (body && typeof body === 'object' && typeof body.error === 'string') {
+        code = body.error || null;
+    }
+    return new ApiError(res.status, code, extractMessage(body, defaultMessage), body);
+}
+async function safeFetch(url, init) {
+    try {
+        return await fetch(url, init);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new NetworkError(message, err);
+    }
+}
+function buildQuery(q) {
+    const params = new URLSearchParams();
+    if (q.q)
+        params.set('q', q.q);
+    if (q.mood)
+        params.set('mood', q.mood);
+    if (q.tag)
+        params.set('tag', q.tag);
+    if (q.featured)
+        params.set('featured', 'true');
+    if (q.limit !== undefined)
+        params.set('limit', String(q.limit));
+    if (q.offset !== undefined)
+        params.set('offset', String(q.offset));
+    const s = params.toString();
+    return s ? `?${s}` : '';
+}
+async function getJsonEnvelope(url, apiKey) {
+    const res = await safeFetch(url, {
+        method: 'GET',
+        headers: { Accept: 'application/json', ...authHeaders(apiKey) },
+    });
+    if (!res.ok)
+        throw await asApiError(res, `request failed (${res.status})`);
+    const body = (await readJsonSafe(res));
+    if (!body || body.status !== 'success') {
+        throw new ApiError(res.status, null, 'unexpected response shape', body);
+    }
+    return body;
+}
+async function listStyles(opts, query = {}) {
+    const url = `${opts.apiBase}/api/graphics/styles${buildQuery(query)}`;
+    return getJsonEnvelope(url, opts.apiKey);
+}
+async function listFormats(opts, query = {}) {
+    const url = `${opts.apiBase}/api/graphics/formats${buildQuery(query)}`;
+    return getJsonEnvelope(url, opts.apiKey);
+}
+async function fetchRecord(url, apiKey, etag) {
+    const headers = {
+        Accept: 'application/json',
+        ...authHeaders(apiKey),
+    };
+    if (etag)
+        headers['If-None-Match'] = etag;
+    const res = await safeFetch(url, { method: 'GET', headers });
+    if (res.status === 304) {
+        return { status: 304, envelope: null, etag };
+    }
+    if (!res.ok)
+        throw await asApiError(res, `request failed (${res.status})`);
+    const body = (await readJsonSafe(res));
+    if (!body || body.status !== 'success') {
+        throw new ApiError(res.status, null, 'unexpected response shape', body);
+    }
+    return {
+        status: 200,
+        envelope: body,
+        etag: res.headers.get('etag'),
+    };
+}
+async function getStyleRecord(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}`;
+    return fetchRecord(url, opts.apiKey, etag);
+}
+async function getFormatRecord(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}`;
+    return fetchRecord(url, opts.apiKey, etag);
+}
+async function fetchMarkdown(url, apiKey, etag) {
+    const headers = {
+        Accept: 'text/plain',
+        ...authHeaders(apiKey),
+    };
+    if (etag)
+        headers['If-None-Match'] = etag;
+    const res = await safeFetch(url, { method: 'GET', headers });
+    if (res.status === 304) {
+        return { status: 304, body: null, etag };
+    }
+    if (!res.ok)
+        throw await asApiError(res, `request failed (${res.status})`);
+    const body = await res.text();
+    return { status: 200, body, etag: res.headers.get('etag') };
+}
+async function getStyleDesignMd(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}/design.md`;
+    return fetchMarkdown(url, opts.apiKey, etag);
+}
+async function getFormatSpecMd(opts, slug, etag = null) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}/spec.md`;
+    return fetchMarkdown(url, opts.apiKey, etag);
+}
+function buildMultipart(manifest, files) {
+    const fd = new FormData();
+    fd.append('manifest', JSON.stringify(manifest));
+    for (const f of files) {
+        const buf = fs.readFileSync(f.absolutePath);
+        // Node's Blob accepts a Uint8Array. We use the file's basename as the
+        // filename, but the field name carries the manifest reference (with "./"
+        // stripped) so the server can match it back to the manifest entry.
+        const ab = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+        const blob = new Blob([ab]);
+        fd.append(f.fieldName, blob, path.basename(f.absolutePath));
+    }
+    return fd;
+}
+async function readWriteResponse(res) {
+    const body = (await readJsonSafe(res));
+    if (!body || body.status !== 'success' || !body.data?.slug || !body.data.id) {
+        throw new ApiError(res.status, null, 'unexpected write response shape', body);
+    }
+    return { slug: body.data.slug, id: body.data.id };
+}
+async function postMultipart(url, apiKey, manifest, files, method) {
+    const fd = buildMultipart(manifest, files);
+    const res = await safeFetch(url, {
+        method,
+        headers: authHeaders(apiKey),
+        body: fd,
+    });
+    if (!res.ok)
+        throw await asApiError(res, `${method} ${url} failed (${res.status})`);
+    return readWriteResponse(res);
+}
+async function publishStyle(opts, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/styles`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'POST');
+}
+async function updateStyle(opts, slug, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'PATCH');
+}
+async function deleteStyle(opts, slug) {
+    const url = `${opts.apiBase}/api/graphics/styles/${encodeURIComponent(slug)}`;
+    const res = await safeFetch(url, {
+        method: 'DELETE',
+        headers: authHeaders(opts.apiKey),
+    });
+    if (!res.ok)
+        throw await asApiError(res, `DELETE ${url} failed (${res.status})`);
+}
+async function publishFormat(opts, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/formats`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'POST');
+}
+async function updateFormat(opts, slug, manifest, files) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}`;
+    return postMultipart(url, opts.apiKey, manifest, files, 'PATCH');
+}
+async function deleteFormat(opts, slug) {
+    const url = `${opts.apiBase}/api/graphics/formats/${encodeURIComponent(slug)}`;
+    const res = await safeFetch(url, {
+        method: 'DELETE',
+        headers: authHeaders(opts.apiKey),
+    });
+    if (!res.ok)
+        throw await asApiError(res, `DELETE ${url} failed (${res.status})`);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Example PNG download (for `get --include-examples`)
+async function downloadBytes(url) {
+    const res = await safeFetch(url, { method: 'GET' });
+    if (!res.ok)
+        throw await asApiError(res, `download failed (${res.status})`);
+    const ab = await res.arrayBuffer();
+    return Buffer.from(ab);
+}
+//# sourceMappingURL=graphics-api.js.map

package/dist/lib/graphics-api.js.map

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

package/dist/lib/graphics-cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ETag-keyed disk cache for the graphics design.md/spec.md endpoints.
+ *
+ * Layout:
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md.etag
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json.etag
+ *   ~/.gooseworks/cache/graphics/formats/<slug>.md
+ *   …
+ *
+ * Freshness is implicit (HTTP ETag handles it); there's no fixed TTL.
+ */
+export type Resource = 'styles' | 'formats';
+export type Variant = 'md' | 'json';
+export interface CacheEntry {
+    body: string;
+    etag: string | null;
+}
+export declare function readCache(resource: Resource, slug: string, variant: Variant): CacheEntry | null;
+/**
+ * Atomically writes the cache body and (optionally) etag. Each file is
+ * written via a PID-suffixed temp file then renamed, so a crash mid-write
+ * never leaves a torn body file readable. Concurrent writers can still
+ * race on body-vs-etag consistency, but that race is self-healing on the
+ * next fetch (mismatched etag → 200 with fresh body → both rewritten).
+ */
+export declare function writeCache(resource: Resource, slug: string, variant: Variant, body: string, etag: string | null): void;
+/** Test seam — exposes the resolved cache root for unit tests. */
+export declare function getCacheRoot(): string;
+//# sourceMappingURL=graphics-cache.d.ts.map

package/dist/lib/graphics-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics-cache.d.ts","sourceRoot":"","sources":["../../src/lib/graphics-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAsBpC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,UAAU,GAAG,IAAI,CAcnB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,IAAI,CAeN;AAQD,kEAAkE;AAClE,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/lib/graphics-cache.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * ETag-keyed disk cache for the graphics design.md/spec.md endpoints.
+ *
+ * Layout:
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.md.etag
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json
+ *   ~/.gooseworks/cache/graphics/styles/<slug>.json.etag
+ *   ~/.gooseworks/cache/graphics/formats/<slug>.md
+ *   …
+ *
+ * Freshness is implicit (HTTP ETag handles it); there's no fixed TTL.
+ */
+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.readCache = readCache;
+exports.writeCache = writeCache;
+exports.getCacheRoot = getCacheRoot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const graphics_manifest_1 = require("./graphics-manifest");
+function getCacheRootInternal() {
+    return (process.env.GOOSEWORKS_GRAPHICS_CACHE_DIR ||
+        path.join(os.homedir(), '.gooseworks', 'cache', 'graphics'));
+}
+/**
+ * Returns the cache file path for a slug, or null if the slug fails the
+ * public grammar. Returning null instead of throwing means a malformed user
+ * arg falls through to the network layer (which will reject it with a
+ * normal 404), rather than crashing the CLI before any request is made.
+ * The check also blocks path traversal via slugs sourced from server JSON.
+ */
+function pathFor(resource, slug, variant) {
+    if (!graphics_manifest_1.SLUG_RE.test(slug))
+        return null;
+    const ext = variant === 'md' ? '.md' : '.json';
+    return path.join(getCacheRootInternal(), resource, `${slug}${ext}`);
+}
+function readCache(resource, slug, variant) {
+    const bodyPath = pathFor(resource, slug, variant);
+    if (!bodyPath)
+        return null;
+    if (!fs.existsSync(bodyPath))
+        return null;
+    try {
+        const body = fs.readFileSync(bodyPath, 'utf-8');
+        const etagPath = `${bodyPath}.etag`;
+        const etag = fs.existsSync(etagPath)
+            ? fs.readFileSync(etagPath, 'utf-8').trim() || null
+            : null;
+        return { body, etag };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Atomically writes the cache body and (optionally) etag. Each file is
+ * written via a PID-suffixed temp file then renamed, so a crash mid-write
+ * never leaves a torn body file readable. Concurrent writers can still
+ * race on body-vs-etag consistency, but that race is self-healing on the
+ * next fetch (mismatched etag → 200 with fresh body → both rewritten).
+ */
+function writeCache(resource, slug, variant, body, etag) {
+    const bodyPath = pathFor(resource, slug, variant);
+    if (!bodyPath)
+        return;
+    fs.mkdirSync(path.dirname(bodyPath), { recursive: true });
+    atomicWrite(bodyPath, body);
+    const etagPath = `${bodyPath}.etag`;
+    if (etag) {
+        atomicWrite(etagPath, etag);
+    }
+    else if (fs.existsSync(etagPath)) {
+        try {
+            fs.unlinkSync(etagPath);
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+function atomicWrite(target, contents) {
+    const tmp = `${target}.tmp.${process.pid}.${Date.now()}`;
+    fs.writeFileSync(tmp, contents, 'utf-8');
+    fs.renameSync(tmp, target);
+}
+/** Test seam — exposes the resolved cache root for unit tests. */
+function getCacheRoot() {
+    return getCacheRootInternal();
+}
+//# sourceMappingURL=graphics-cache.js.map

package/dist/lib/graphics-cache.js.map

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

package/dist/lib/graphics-manifest.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Client-side validators for gooseworks-style.json and gooseworks-format.json.
+ *
+ * Mirrors the server-side Zod schema in gooseworks-app:
+ *   backend/src/schemas/graphics-manifest.ts
+ *
+ * If the server schema changes, update this file to match. The CLI runs
+ * pre-flight validation here for fast feedback before uploading bytes.
+ */
+export interface StyleExample {
+    format: string;
+    isHero?: boolean;
+    file: string;
+    caption?: string;
+}
+export interface PaletteEntry {
+    hex: string;
+    role?: string;
+}
+export interface StyleManifest {
+    name: string;
+    slug?: string;
+    description: string;
+    designMd: string;
+    moodGroup?: string;
+    tags?: string[];
+    palette?: PaletteEntry[];
+    examples: StyleExample[];
+}
+export interface FormatExample {
+    file: string;
+    styleSlug?: string;
+}
+export interface FormatManifest {
+    name: string;
+    slug?: string;
+    description: string;
+    width: number;
+    height: number;
+    contentRulesMd: string;
+    tags?: string[];
+    examples: FormatExample[];
+}
+export declare const VALID_MOOD_GROUPS: readonly ["Dark & Moody", "Light & Editorial", "Organic & Warm", "Bold & Energetic", "Retro & Cinematic", "Structural & Technical", "Friendly Corporate"];
+export declare const STYLE_MANIFEST_FILENAME = "gooseworks-style.json";
+export declare const FORMAT_MANIFEST_FILENAME = "gooseworks-format.json";
+export interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare const SLUG_RE: RegExp;
+/**
+ * Throws if the string does not match the public slug grammar. Use before
+ * interpolating any externally-sourced slug (CLI arg, server response) into
+ * a filesystem path.
+ */
+export declare function assertSafeSlug(slug: string, source?: string): void;
+export declare function validateStyleManifest(m: unknown): ValidationResult;
+export declare function validateFormatManifest(m: unknown): ValidationResult;
+/**
+ * Read a manifest file from disk. Returns the parsed object or throws a
+ * ManifestParseError with a clear message.
+ */
+export declare class ManifestParseError extends Error {
+    constructor(message: string);
+}
+export declare class ManifestMissingFileError extends Error {
+    readonly missing: string;
+    constructor(missing: string);
+}
+export declare class ManifestEscapingPathError extends Error {
+    readonly ref: string;
+    constructor(ref: string);
+}
+export declare function readManifestFile(filePath: string): unknown;
+export interface ResolvedExampleFile {
+    /** The relative path as referenced in the manifest, e.g. "./poster.png". */
+    manifestRef: string;
+    /**
+     * Field name to use in multipart upload. Always a forward-slash relative
+     * path within the manifest directory — no `..`, no leading slash, no
+     * absolute paths. Safe to send to the server as a multipart field name.
+     */
+    fieldName: string;
+    /** Absolute path on disk. */
+    absolutePath: string;
+}
+/**
+ * Resolve example file references against the publish directory. Throws
+ * ManifestMissingFileError if a referenced file doesn't exist, and
+ * ManifestEscapingPathError if it resolves outside `manifestDir`.
+ */
+export declare function resolveExampleFiles(manifestDir: string, examples: ReadonlyArray<{
+    file: string;
+}>): ResolvedExampleFile[];
+//# sourceMappingURL=graphics-manifest.d.ts.map

package/dist/lib/graphics-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics-manifest.d.ts","sourceRoot":"","sources":["../../src/lib/graphics-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,2JAQpB,CAAC;AAEX,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,OAAO,QAAiB,CAAC;AAGtC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,IAAI,CAIlE;AAUD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,CA+FlE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAmEnE;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAI5C;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAIxC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAmB1D;AAED,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACxC,mBAAmB,EAAE,CAkBvB"}