@meshy-ai/cli 0.4.1 → 0.4.2

package/dist/root.js

@@ -17,6 +17,7 @@ import { animateCommand } from "./cmd/animate.js";
 import { animationCatalogCommand } from "./cmd/animation-catalog.js";
 import { apiCommand } from "./cmd/api.js";
 import { authCommand } from "./cmd/auth.js";
+import { autoSplitCommand } from "./cmd/auto-split.js";
 import { balanceCommand } from "./cmd/balance.js";
 import { convertCommand } from "./cmd/convert.js";
 import { creativeLabCommand } from "./cmd/creative-lab.js";
@@ -42,6 +43,7 @@ import { slicerCommand } from "./cmd/slicer.js";
 import { textTo3dCommand } from "./cmd/text-to-3d.js";
 import { textToImageCommand } from "./cmd/text-to-image.js";
 import { textToMotionCommand } from "./cmd/text-to-motion.js";
+import { usageCommand } from "./cmd/usage.js";
 import { uvUnwrapCommand } from "./cmd/uv-unwrap.js";
 /**
  * Commands added in S1. They only speak the v1 envelope; the error exit uses
@@ -58,6 +60,8 @@ export const V1_ONLY_COMMANDS = new Set([
     "mesh",
     "slicer",
     "doctor",
+    "auto-split",
+    "usage",
 ]);
 /**
  * Commands that never need the authenticated API. The background update check
@@ -71,7 +75,6 @@ export const LOCAL_COMMANDS = new Set([
     "slicer",
     "doctor",
     "download",
-    "animation-catalog",
     REFRESH_COMMAND,
 ]);
 const ROOT_LONG = `meshy-cli — command-line interface for the Meshy AI API.
@@ -92,7 +95,7 @@ EXAMPLES:
     meshy resources                                # index of every command
     meshy text-to-3d create --mode preview --prompt "a red sports car"
     meshy image-to-3d get <task-id>
-    meshy delete <task-id>                         # unified: works for any task
+    meshy delete <task-id>                         # any task except Creative Lab
 
     # escape hatch for endpoints without a dedicated subcommand
     meshy api GET /balance
@@ -194,6 +197,8 @@ export function buildRootCommand() {
         meshCommand,
         slicerCommand,
         doctorCommand,
+        autoSplitCommand,
+        usageCommand,
     ]) {
         program.addCommand(cmd, { hidden: true });
     }

package/dist/root.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meshy-ai/cli",
-  "version": "0.4.1",
-  "description": "Official command-line interface for the Meshy AI API — text-to-3D, image-to-3D, text-to-motion, remesh, UV unwrap, rigging, animate, retexture, 2D images, multi-color print, Creative Lab, balance — plus selective downloads, project folders, face checks, OBJ print preparation and slicer launch.",
+  "version": "0.4.2",
+  "description": "Official command-line interface for the Meshy AI API — text-to-3D, image-to-3D, text-to-motion, remesh, UV unwrap, rigging, animate, retexture, 2D images, printability, auto split, multi-color print, Creative Lab, balance and usage — plus selective downloads, project folders, face checks, OBJ print preparation and slicer launch.",
   "license": "MIT",
   "type": "module",
   "packageManager": "pnpm@11.24.0",

package/skills/meshy-cli/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: meshy-cli
-description: "Generate 3D models, motion clips, 2D images and Creative Lab print products with the Meshy API through the meshy-cli command — text-to-3D, image-to-3D, text-to-motion, remesh, UV unwrap, rigging, animation, retexture, printability, selective downloads, project folders, face checks, OBJ print preparation and slicer launch. Use for any Meshy asset or 3D-printing request."
+description: "Generate 3D models, motion clips, 2D images and Creative Lab print products with the Meshy API through the meshy-cli command — text-to-3D, image-to-3D, text-to-motion, remesh, UV unwrap, rigging, animation, retexture, printability, auto split into printable parts, per-task credit usage, selective downloads, project folders, face checks, OBJ print preparation and slicer launch. Use for any Meshy asset or 3D-printing request."
 license: MIT
 compatibility: Requires meshy-cli on PATH (Node 22.12+, no Python) and a stored credential, MESHY_API_KEY or --api-key-file for API commands; network access to api.meshy.ai. Local helpers work offline.
 metadata:
-  version: "1.1.0"
+  version: "1.2.0"
   cli-help: "meshy --help"
 ---
 
@@ -22,14 +22,10 @@ network; `meshy doctor --check-api` makes one free balance call.
 
 ## Always ask for the stable envelope
 
-Add `--output-schema v1 --format json` to every command you parse. `--format` is
-not optional politeness: untyped, it renders `pretty` for a human at a terminal
-and `json` everywhere else. You will almost always be on the `json` side — a
-subprocess pipe is not a TTY — and a typed `--output-schema v1` alone already
-means JSON even in a pseudo-terminal, but say both and the shape is yours
-regardless of how you are spawned. `pretty` is a human view that drops fields,
-so never parse it. `json` and `ndjson` never carry terminal colour codes, so
-you never need to strip escapes. stdout is then
+Add `--output-schema v1 --format json` to every command you parse. Untyped,
+`--format` is `pretty` at a terminal and `json` elsewhere; say both and the
+shape is fixed however you are spawned. `pretty` is a human view that drops
+fields, so never parse it; `json` and `ndjson` carry no colour codes. stdout is then
 exactly one JSON object with six keys — `schema_version, command, ok, result,
 error, warnings` — and nothing else. Progress goes to stderr as plain lines
 (none under `ndjson`); it is for people, so read ids from stdout, not from it. `ok` is whether the
@@ -37,7 +33,8 @@ CLI operation completed; `result.task.status` is the server's task state (a `get
 of a FAILED task is `ok:true`). Fields the server did not send are `null` —
 never treat a `null` `face_count` or `consumed_credits` as 0. `error.code` and
 the exit code (below) are stable; `error.recovery.command`, when present, is a
-command you can run verbatim.
+command you can run verbatim, once a `<dir>`/`<file>` placeholder in it (download
+recoveries) is replaced with a real path.
 
 ## One model, one command
 
@@ -55,8 +52,8 @@ verbatim rather than starting over, or the finished step is paid for twice.
 
 ## Everything else
 
-`meshy resources --output-schema v1` indexes every command (kind `task`, `query`
-or `local`); each task resource carries the same verbs:
+`meshy resources --output-schema v1` indexes every command (kind `task`, `query`,
+`action` or `local`); each task resource carries the same verbs:
 
 ```bash
 meshy <resource> create [flags] [--data '<json>'] [--async] [--timeout <s>] [--operation-id <id>] --output-schema v1
@@ -80,7 +77,7 @@ meshy <resource> list [--page-size <n>] --output-schema v1
   is refused a replay (`credential_unverified`) — run `meshy auth login` once first.
 - **An error after `create` was accepted still names the task**: read
   `result.task_id` / `result.submission.task_id` and `result.next` from any
-  non-zero exit (11 local I/O, 1 polling failure, 130 interrupt) before deciding
+  non-zero exit (11 local I/O, 8 timeout, 130 interrupt) before deciding
   anything; never create again because a later step failed.
 - `--save-json <file>` stores the raw API task (use it as the input of `download`,
   `inspect faces` and `project record`); `--include-raw` puts the raw response under
@@ -94,17 +91,23 @@ meshy <resource> list [--page-size <n>] --output-schema v1
 
 ```bash
 meshy uv-unwrap create --input-task-id <id> --async --output-schema v1              # GLB only, ≤40k faces (server enforces)
-meshy creative-lab <figure|lamp|keychain|fridge-magnet> prototype create --image-url ./photo.png --name demo --async --output-schema v1
+meshy creative-lab <figure|vinyl-figure|brick-figure|lamp|keychain|fridge-magnet|keycap|fidget-pixel> prototype create --image-url ./photo.png --name demo --async --output-schema v1
 meshy creative-lab <product> build create --input-task-id <prototype-id> [--model-format …] [--options '<json>'] --async --output-schema v1
-meshy animation-catalog list --category DailyActions --search wave --output-schema v1   # public, no key; search is local
+meshy creative-lab fidget-collapsible create --image-url ./photo.png --async --output-schema v1   # one stage → STL
+meshy animation-catalog list --category DailyActions --search wave --output-schema v1   # free; search is server-side
+meshy auto-split create --input-task-id <id> --mode by_parts --prompt "head, torso" --async --output-schema v1   # printable parts
+meshy usage tasks --start-time 2026-08-01T00:00:00Z --output-schema v1                 # Studio/Enterprise; credits per task
 meshy showcases list --search car --page-size 3 --output-schema v1                      # Enterprise only; EVERY request is billed
 ```
 
-Prototype meanings differ: figure/keychain/fridge-magnet yield a concept image,
-lamp also yields a lampshade GLB. Build consumes a SUCCEEDED prototype made
-through this API with the same key (web-app prototypes → 404). Lamp builds output
-`lamp_stl`/`base_stl` or `bundle_zip`; keychain/fridge-magnet `obj` output is a
-ZIP bundle saved as `.zip`. Never call `showcases` in a health check.
+Prototype meanings differ: most yield a concept image, lamp also yields a
+lampshade GLB, keycap yields `candidate_ids` (pass one as the build's
+`--candidate-id`), fidget-pixel needs `--type person|other`; keychain takes
+`--name-text` (≤10 characters, engraved). Build consumes a SUCCEEDED prototype
+made through this API with the same key (web-app prototypes → 404). Lamp builds
+output `lamp_stl`/`base_stl` or `bundle_zip`; keychain/fridge-magnet `obj` and
+keycap `obj_zip` are ZIP bundles saved as `.zip`; fidget-pixel builds a 3MF.
+Never call `showcases` in a health check.
 
 ## Downloads, projects, printing (local, no key)
 
@@ -139,33 +142,49 @@ These are API rules, not preferences — ignoring them produces failed tasks:
   not props, quadrupeds or untextured drafts. Too dense? `remesh` first. A
   successful rigging task already bundles walking and running clips
   (`result.basic_animations.*`), so check its result before calling `animate`.
-- **`animate` takes a rigging task id**, not a model task id, plus an integer
-  `--action-id` from the catalog.
+- **`animate` takes a rigging task id**, not a model task id, plus exactly one
+  of: an integer `--action-id` from the catalog, `--action-ids` (up to 10, one
+  file with one clip each, billed per action) or a text-to-motion
+  `--motion-task-id` (biped rigs).
 - **`text-to-motion` produces a standalone skeletal clip**, not an animated
   character. Pass a 2–10 second duration in 0.5-second increments.
 - **`repair-printability` drops textures and invalidates UVs.** Run it before
   texturing, or re-`retexture` afterwards.
+- **A local `--model-url` must be `.glb`/`.gltf`** (multi-color-print: `.glb`)
+  on every command: the API takes inline models as glTF only. Pass
+  `.stl`/`.obj`/`.fbx` as an http(s) URL, or use `--input-task-id`.
+- **`meshy delete <id>` never reaches Creative Lab tasks**; `meshy creative-lab
+  <product> <stage> delete <id>` cancels one instead (`canceled: true`).
 - **`uv-unwrap` takes one source** (`--input-task-id` or `--model-url`, GLB only).
-- **`multi-image-to-3d` is beta**; use `image-to-3d` unless multi-view input was
-  explicitly asked for. Its default runs a two-stage multi-view model;
-  `--geometry-resolution 2k` turns on the multi-view Ultra pass (+5 credits),
-  the same geometry setting as the web app's Ultra 2K. The Ultra model follows
-  `ai_model`: add `--data '{"ai_model":"meshy-7.1"}'` to pin Meshy 7.1.
+- `multi-image-to-3d` takes 1-4 views of one object; use `image-to-3d` unless
+  multi-view input was asked for. Both accept `--input-task-id` of a SUCCEEDED
+  `text-to-image` / `image-to-image` task, so a generated image chains to 3D.
 - `image-to-3d` defaults to an untextured draft mesh; `--should-texture true`
   (what `make` uses) produces a textured model in one task.
-- **The model set is not the same on every endpoint.** The image-driven
-  endpoints run Meshy 7 by default; `text-to-3d` has no Meshy 7 at all and its
-  default is still Meshy 6. `--ultra-mode` exists on `image-to-3d` alone
-  (`multi-image-to-3d` takes `--geometry-resolution 2k` instead), and
-  `retexture`'s `--multiview-image-urls` needs Meshy 7 — it takes 1-4 views of
-  **the same object**, not style references.
+- **The default model is `latest` = Meshy 7.1** on all three generators.
+  `--geometry-resolution 2k|4k` runs the Ultra geometry pass (+5 credits;
+  text-to-3d: preview only; multi-image: `2k` only; not with smart-topology);
+  `--ultra-mode` on image-to-3d is its deprecated spelling of `2k`.
+  `--model-type smart-topology` (meshy-t2, text-to-3d and image-to-3d) has a
+  native `--target-polycount` (default 10000). `retexture`'s
+  `--multiview-image-urls` needs Meshy 7 — it takes 1-4 views of **the same
+  object**, not style references.
+- Printing: `analyze-`/`repair-printability` take `--printer-type
+  fdm|sla|full_color` and one `--intended-print-height-mm` /
+  `--intended-print-longest-side-mm`; `multi-color-print` takes `--style
+  realistic|cartoon` and `--printer-brand`. `text-to-image` / `image-to-image`
+  take `--remove-background true` (transparent PNG).
+- **A standalone refine defaults to 2k textures**: 4k/8k and `--remove-lighting`
+  are refused for a meshy-6-lite preview, so pass `--texture-resolution 4k` only
+  for a meshy-6 / meshy-7.1 / latest preview (`make` does).
 
 ## Finding an animation id
 
-`--action-id` is an integer from Meshy's animation library. Ask the live public
-catalog (no key): `meshy animation-catalog list --category Fighting --search kick
---output-schema v1` → `result.items[].action_id`. Ids are not `1..N` (the catalog
-contains `-2`, `-1` and `0`) — never guess one. This skill also bundles a
+`--action-id` is an integer from Meshy's animation library. Ask the live
+library (free): `meshy animation-catalog list --category Fighting --search kick
+--output-schema v1` → `result.items[].action_id`; `--action-ids 92,4` checks
+stored ids. Ids are not `1..N` (the catalog contains `-2`, `-1` and `0`) — never
+guess one. This skill also bundles a
 snapshot as `animation-library.json` (with hand-written descriptions the API does
 not return; it can lag behind the live catalog).
 
@@ -177,11 +196,16 @@ Exit codes: `0` ok · `1` task FAILED/CANCELED while waiting, or unclassified ·
 `2` usage · `3` auth · `4` validation · `5` not found · `6` rate limit ·
 `7` network · `8` timed out (task keeps running) · `9` out of credits ·
 `10` submission unknown (do not re-create) · `11` local I/O · `12` check failed ·
-`13` check unknown · `130` interrupted.
+`13` check unknown · `14` conflict (delete of an IN_PROGRESS task) · `130` interrupted.
 
 - Exit 9 → run `meshy balance`, relay the number, do not retry.
 - Exit 6 → back off; the CLI does not retry for you.
-- Exit 8 → `wait`/`stream` the same task id again; it was not cancelled.
+- Exit 8 → `wait`/`stream` the same task id again; it was not cancelled. A
+  429/5xx/timeout on a status request is already retried while waiting; the
+  default `--timeout` is 600 s, the API advises waiting up to 60 min.
+- Exit 14 → the task is running: it cannot be stopped and its credits are spent.
+  `wait` for the result; delete it afterwards only if the user wants the result
+  gone (permanent, no refund).
 - Exit 130 after `-o` → the transfer (or the material rewrite) was cancelled;
   `result.downloads.files` lists what already landed (`status: written`), the rest can
   be fetched with `meshy download`. `downloads.failed_step` (`relink` | `digest` |
@@ -197,10 +221,9 @@ Exit codes: `0` ok · `1` task FAILED/CANCELED while waiting, or unclassified ·
   `error.recovery.command` (`meshy project record …`, it already carries the original
   `--workspace` and `--operation-id`) verbatim — do not download or create again. The same
   command appears after a task verb's `--project` record failure (legacy: `hint`); when the
-  error says the project is *no longer a target inside the authorised boundary* (the project,
-  its parent or the workspace itself changed while the request was in flight) there is
-  deliberately no command and `recovery` is null — restore the directory first, then record
-  with `meshy project record` from inside the original workspace.
+  error says the project is *no longer a target inside the authorised boundary* (it moved
+  mid-request) there is deliberately no command and `recovery` is null — restore the
+  directory first, then record with `meshy project record` from inside the original workspace.
 - Exit 10 → reconcile with `<resource> list`; never submit the same create again blindly.
 - A `FAILED` task → relay `result.task.task_error.message` verbatim; do not guess a cause.
 - Any error may carry `error.recovery.command` — prefer it over improvising.

package/dist/client/endpoints/animation-catalog.d.ts

@@ -1,37 +0,0 @@
-/**
- * GET <origin>/web/public/animations/resources — the public Animation Library.
- *
- * No credential is ever attached: the endpoint is public and the transport
- * used here has none. `category` is the only server-side filter the frozen
- * Skill baseline relies on; the response is `{result:{total,list}}`.
- */
-import { z } from "zod";
-import type { Transport } from "../transport.js";
-export declare const AnimationCatalogEntrySchema: z.ZodObject<{
-    id: z.ZodNumber;
-    key: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    category: z.ZodOptional<z.ZodString>;
-    subCategory: z.ZodOptional<z.ZodString>;
-    previewUrl: z.ZodOptional<z.ZodString>;
-    rigType: z.ZodOptional<z.ZodString>;
-    isDefault: z.ZodOptional<z.ZodBoolean>;
-    isFree: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$loose>;
-export type AnimationCatalogEntry = z.infer<typeof AnimationCatalogEntrySchema>;
-export declare const ANIMATION_CATEGORIES: readonly ["WalkAndRun", "BodyMovements", "DailyActions", "Fighting", "Dancing"];
-export declare class AnimationCatalogEndpoint {
-    static readonly PATH = "/animations/resources";
-    private readonly transport;
-    constructor(transport: Transport);
-    list(params?: {
-        category?: string;
-    }, extras?: {
-        signal?: AbortSignal;
-    }): Promise<{
-        entries: AnimationCatalogEntry[];
-        total: number | null;
-        raw: unknown;
-    }>;
-}
-//# sourceMappingURL=animation-catalog.d.ts.map

package/dist/client/endpoints/animation-catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"animation-catalog.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/animation-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAYxB,CAAC;AACjB,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAQhF,eAAO,MAAM,oBAAoB,YAAI,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAEpH,qBAAa,wBAAwB;IACnC,MAAM,CAAC,QAAQ,CAAC,IAAI,2BAA2B;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,YAAY,SAAS,EAAE,SAAS,EAG/B;IAEK,IAAI,CAAC,MAAM,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,EAAE,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC,CAgBvK;CACF"}

package/dist/client/endpoints/animation-catalog.js

@@ -1,55 +0,0 @@
-/**
- * GET <origin>/web/public/animations/resources — the public Animation Library.
- *
- * No credential is ever attached: the endpoint is public and the transport
- * used here has none. `category` is the only server-side filter the frozen
- * Skill baseline relies on; the response is `{result:{total,list}}`.
- */
-import { z } from "zod";
-import { MeshyApiError } from "../errors.js";
-export const AnimationCatalogEntrySchema = z
-    .object({
-    id: z.number(),
-    key: z.string().optional(),
-    name: z.string().optional(),
-    category: z.string().optional(),
-    subCategory: z.string().optional(),
-    previewUrl: z.string().optional(),
-    rigType: z.string().optional(),
-    isDefault: z.boolean().optional(),
-    isFree: z.boolean().optional(),
-})
-    .passthrough();
-const ResponseSchema = z
-    .object({
-    result: z.object({ total: z.number().optional(), list: z.array(AnimationCatalogEntrySchema) }).passthrough(),
-})
-    .passthrough();
-export const ANIMATION_CATEGORIES = ["WalkAndRun", "BodyMovements", "DailyActions", "Fighting", "Dancing"];
-export class AnimationCatalogEndpoint {
-    static PATH = "/animations/resources";
-    transport;
-    constructor(transport) {
-        if (transport.authenticated)
-            throw new Error("the animation catalog must use an unauthenticated transport");
-        this.transport = transport;
-    }
-    async list(params = {}, extras = {}) {
-        const resp = await this.transport.requestJson("GET", AnimationCatalogEndpoint.PATH, {
-            query: { category: params.category },
-            signal: extras.signal,
-        });
-        const parsed = ResponseSchema.safeParse(resp.json);
-        if (!parsed.success) {
-            throw new MeshyApiError({
-                message: `unexpected catalog shape from ${AnimationCatalogEndpoint.PATH}: ${parsed.error.message}`,
-                status: resp.status,
-                code: "server",
-                path: AnimationCatalogEndpoint.PATH,
-                body: resp.json,
-            });
-        }
-        return { entries: parsed.data.result.list, total: parsed.data.result.total ?? null, raw: resp.json };
-    }
-}
-//# sourceMappingURL=animation-catalog.js.map

package/dist/client/endpoints/animation-catalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"animation-catalog.js","sourceRoot":"","sources":["../../../src/client/endpoints/animation-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;CAC7G,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAEpH,MAAM,OAAO,wBAAwB;IACnC,MAAM,CAAU,IAAI,GAAG,uBAAuB,CAAC;IAC9B,SAAS,CAAY;IAEtC,YAAY,SAAoB;QAC9B,IAAI,SAAS,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC5G,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAM,GAA0B,EAAE,EAAE,MAAM,GAA6B,EAAE;QAClF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE;YAClF,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CAAC;gBACtB,OAAO,EAAE,iCAAiC,wBAAwB,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;gBAClG,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,wBAAwB,CAAC,IAAI;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACvG,CAAC;CACF"}