@skyphusion-labs/vivijure-core 0.9.0

package/dist/render-module-config.d.ts

@@ -0,0 +1,28 @@
+import type { RegisteredModule, RenderConfigProjection } from "./modules/types.js";
+export type RenderTier = "draft" | "standard" | "final";
+export interface QualityTierOption {
+    value: RenderTier;
+    label: string;
+    blurb: string;
+}
+export declare const QUALITY_TIERS: readonly QualityTierOption[];
+export declare const DEFAULT_QUALITY_TIER: RenderTier;
+export declare function renderConfigProjection(): RenderConfigProjection;
+export interface ModuleRenderOverridesWire {
+    motion_backend?: string;
+    keyframe_backend?: string;
+    config?: Record<string, Record<string, unknown>>;
+}
+export interface ResolvedModuleRenderConfigs {
+    motion_backend?: string;
+    keyframe_backend?: string;
+    keyframe_config: Record<string, unknown>;
+    motion_config: Record<string, unknown>;
+    finish_config: Record<string, Record<string, unknown>>;
+    speech_config: Record<string, Record<string, unknown>>;
+    film_finish_config: Record<string, Record<string, unknown>>;
+    master_config: Record<string, Record<string, unknown>>;
+}
+export declare function parseModuleRenderOverrides(raw: unknown): ModuleRenderOverridesWire;
+export declare function resolveModuleRenderConfigs(overrides: unknown, tier: RenderTier, modules: RegisteredModule[]): ResolvedModuleRenderConfigs;
+//# sourceMappingURL=render-module-config.d.ts.map

package/dist/render-module-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-module-config.d.ts","sourceRoot":"","sources":["../src/render-module-config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAIrD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,UAAoB,CAAC;AAExD,wBAAgB,sBAAsB,IAAI,sBAAsB,CAK/D;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD;AAMD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CA6ClF;AAuBD,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,2BAA2B,CAiC7B"}

package/dist/render-module-config.js

@@ -0,0 +1,124 @@
+// Registry-driven render module config: the wire shape the planner sends as render_overrides
+// and the core resolves into per-hook module configs before starting a film job.
+import { resolveRenderPipeline, pickOneForHook, } from "./modules/render-pipeline.js";
+import { servingForHook } from "./modules/registry.js";
+export const QUALITY_TIERS = [
+    { value: "draft", label: "draft", blurb: "33 frames, 8 steps; fastest, lowest quality" },
+    { value: "standard", label: "standard", blurb: "8-step keyframes + 20-step EasyCache i2v; balanced" },
+    { value: "final", label: "final", blurb: "97 frames, 22 steps; production quality" },
+];
+export const DEFAULT_QUALITY_TIER = "final";
+export function renderConfigProjection() {
+    return {
+        quality_tiers: QUALITY_TIERS.map((t) => ({ value: t.value, label: t.label, blurb: t.blurb })),
+        default_tier: DEFAULT_QUALITY_TIER,
+    };
+}
+function isRecord(v) {
+    return !!v && typeof v === "object" && !Array.isArray(v);
+}
+export function parseModuleRenderOverrides(raw) {
+    if (!isRecord(raw))
+        return {};
+    if (isRecord(raw.config) || typeof raw.motion_backend === "string" || typeof raw.keyframe_backend === "string") {
+        const out = {};
+        if (typeof raw.motion_backend === "string" && raw.motion_backend.trim()) {
+            out.motion_backend = raw.motion_backend.trim();
+        }
+        if (typeof raw.keyframe_backend === "string" && raw.keyframe_backend.trim()) {
+            out.keyframe_backend = raw.keyframe_backend.trim();
+        }
+        if (isRecord(raw.config)) {
+            const config = {};
+            for (const [name, cfg] of Object.entries(raw.config)) {
+                if (isRecord(cfg))
+                    config[name] = { ...cfg };
+            }
+            if (Object.keys(config).length)
+                out.config = config;
+        }
+        return out;
+    }
+    const config = {};
+    const kf = raw.keyframe;
+    if (isRecord(kf)) {
+        const mapped = {};
+        if (typeof kf.steps === "number")
+            mapped.steps = kf.steps;
+        if (typeof kf.guidance_scale === "number")
+            mapped.guidance_scale = kf.guidance_scale;
+        if (typeof kf.seed === "number" && kf.seed >= 0)
+            mapped.seed = kf.seed;
+        if (typeof kf.resolution === "string") {
+            const m = kf.resolution.trim().match(/^(\d+)x(\d+)$/i);
+            if (m) {
+                mapped.width = parseInt(m[1], 10);
+                mapped.height = parseInt(m[2], 10);
+            }
+        }
+        if (Object.keys(mapped).length)
+            config.keyframe = mapped;
+    }
+    const i2v = raw.i2v;
+    if (isRecord(i2v)) {
+        const mapped = {};
+        if (typeof i2v.fps === "number")
+            mapped.fps = i2v.fps;
+        if (typeof i2v.flow_shift === "number")
+            mapped.flow_shift = i2v.flow_shift;
+        if (typeof i2v.seed === "number" && i2v.seed >= 0)
+            mapped.seed = i2v.seed;
+        if (Object.keys(mapped).length)
+            config["own-gpu"] = mapped;
+    }
+    return Object.keys(config).length ? { config } : {};
+}
+function injectQualityTier(config, tier, modules, keyframeChoice) {
+    const out = {};
+    for (const [name, cfg] of Object.entries(config))
+        out[name] = { ...cfg };
+    const kf = pickOneForHook(modules, "keyframe", keyframeChoice) ?? servingForHook(modules, "keyframe")[0];
+    if (kf) {
+        out[kf.name] = { ...(out[kf.name] ?? {}), quality_tier: tier };
+    }
+    for (const m of servingForHook(modules, "motion.backend")) {
+        if (m.config_schema?.quality) {
+            out[m.name] = { ...(out[m.name] ?? {}), quality: tier };
+        }
+    }
+    return out;
+}
+export function resolveModuleRenderConfigs(overrides, tier, modules) {
+    const parsed = parseModuleRenderOverrides(overrides);
+    const config = injectQualityTier(parsed.config ?? {}, tier, modules, parsed.keyframe_backend);
+    const selection = {
+        motion_backend_choice: parsed.motion_backend,
+        keyframe_backend_choice: parsed.keyframe_backend,
+        config,
+    };
+    const pipeline = resolveRenderPipeline(modules, selection);
+    const keyframe_config = pipeline.keyframe ? pipeline.keyframe.config : { quality_tier: tier };
+    const finish_config = {};
+    for (const m of pipeline.finish)
+        finish_config[m.name] = m.config;
+    const speech_config = {};
+    for (const m of pipeline.speech)
+        speech_config[m.name] = m.config;
+    const film_finish_config = {};
+    for (const m of pipeline.filmFinish)
+        film_finish_config[m.name] = m.config;
+    const master_config = {};
+    for (const m of pipeline.master)
+        master_config[m.name] = m.config;
+    return {
+        motion_backend: pipeline.motion_backend?.name,
+        keyframe_backend: pipeline.keyframe?.name,
+        keyframe_config,
+        motion_config: pipeline.motion_backend?.config ?? {},
+        finish_config,
+        speech_config,
+        film_finish_config,
+        master_config,
+    };
+}
+//# sourceMappingURL=render-module-config.js.map

package/dist/render-module-config.js.map

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

package/dist/render-mux.d.ts

@@ -0,0 +1,18 @@
+import type { Env } from "./platform/orchestrator-context.js";
+export { stageAudioKeyForRenders } from "./audio-stage.js";
+/** Mux an audio bed onto a finished silent MP4 via video-finish (VPC). */
+export declare function muxAudioOntoVideoKey(env: Env, videoKey: string, audioKey: string): Promise<{
+    ok: true;
+    output_key: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function muxAudioOntoRender(env: Env, renderId: number, audioKey: string): Promise<{
+    ok: true;
+    output_key: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+//# sourceMappingURL=render-mux.d.ts.map

package/dist/render-mux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-mux.d.ts","sourceRoot":"","sources":["../src/render-mux.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAQ9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,0EAA0E;AAC1E,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC1E;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAY1E"}

package/dist/render-mux.js

@@ -0,0 +1,69 @@
+// Off-GPU audio mux onto a finished render via the video-finish container (remuxAudioOnly).
+//
+// Used by POST /api/storyboard/renders/:id/add-audio after the caller supplies an R2 audio key.
+// Narration flows synthesize audio through a score module first, then call the same mux path.
+import { callVideoFinish } from "./film-orchestrator.js";
+import { stageAudioKeyForRenders } from "./audio-stage.js";
+import { getRenderByIdForUser, setRenderAudioOutput } from "./renders-db.js";
+import { presignR2Get, presignR2Put } from "./presign.js";
+const TERMINAL_OK = new Set(["COMPLETED"]);
+export { stageAudioKeyForRenders } from "./audio-stage.js";
+/** Mux an audio bed onto a finished silent MP4 via video-finish (VPC). */
+export async function muxAudioOntoVideoKey(env, videoKey, audioKey) {
+    if (!env.VIDEO_FINISH_VPC)
+        return { ok: false, error: "video-finish VPC binding not configured" };
+    let stagedKey;
+    try {
+        stagedKey = await stageAudioKeyForRenders(env, audioKey);
+    }
+    catch (e) {
+        return { ok: false, error: e.message };
+    }
+    const outKey = videoKey.replace(/\.mp4$/i, "") + "-audio-" + crypto.randomUUID().slice(0, 8) + ".mp4";
+    const [videoUrl, audioUrl, outputUrl] = await Promise.all([
+        presignR2Get(env, videoKey, 1800),
+        presignR2Get(env, stagedKey, 1800),
+        presignR2Put(env, outKey, 1800),
+    ]);
+    const resp = await callVideoFinish(env, {
+        clips: [{ url: videoUrl }],
+        outputUrl,
+        outputKey: outKey,
+        audioUrl,
+        remuxAudioOnly: true,
+    });
+    if (!resp || !resp.ok) {
+        const errBody = resp ? await resp.text().catch(() => "") : "video-finish unreachable";
+        return {
+            ok: false,
+            error: "video-finish mux failed: " + (errBody.slice(0, 200) || String(resp?.status ?? "network")),
+        };
+    }
+    let body;
+    try {
+        body = (await resp.json());
+    }
+    catch {
+        return { ok: false, error: "video-finish returned invalid JSON" };
+    }
+    if (!body.ok)
+        return { ok: false, error: body.error || "video-finish mux failed" };
+    return { ok: true, output_key: outKey };
+}
+export async function muxAudioOntoRender(env, renderId, audioKey) {
+    const row = await getRenderByIdForUser(env, renderId);
+    if (!row)
+        return { ok: false, error: "render not found" };
+    if (!TERMINAL_OK.has(row.status))
+        return { ok: false, error: "render is not completed" };
+    if (!row.output_key)
+        return { ok: false, error: "render has no output video" };
+    const muxed = await muxAudioOntoVideoKey(env, row.output_key, audioKey);
+    if (!muxed.ok)
+        return muxed;
+    const updated = await setRenderAudioOutput(env, renderId, muxed.output_key, null);
+    if (!updated)
+        return { ok: false, error: "could not update render row" };
+    return { ok: true, output_key: muxed.output_key };
+}
+//# sourceMappingURL=render-mux.js.map

package/dist/render-mux.js.map

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

package/dist/render-orchestrator.d.ts

@@ -0,0 +1,71 @@
+import type { Env } from "./platform/orchestrator-context.js";
+import { summarizeJob, type ClipShot, type ClipShotInput, type ClipJob, type JobSummary } from "./clip-job-model.js";
+import type { MotionBackendOutput, PollResponse, RegisteredModule } from "./modules/types.js";
+export type { ClipShotInput, ClipShot, ClipJob, JobSummary };
+export { summarizeJob };
+/** Pure: aggregate the per-shot failure reasons into one honest string (#754). */
+export declare function describeClipFailures(job: ClipJob): string;
+/** Pure: is a poll/invoke error TRANSIENT or DETERMINISTIC? Shared classifier (#719). */
+export declare function classifyTransientFailure(error: string | undefined): "transient" | "deterministic";
+/** Consecutive transient poll errors a clip shot tolerates before failing loud (#719). */
+export declare const CLIP_POLL_MAX_ATTEMPTS = 3;
+/** Apply a /poll outcome to a shot (pure): failure -> failed; still pending -> unchanged; output ->
+ *  done with the clip key. */
+export declare function applyPoll(shot: ClipShot, r: PollResponse<MotionBackendOutput>): void;
+/** Pure: does an R2 clips-object filename belong to this shot? The backend writes a finished motion clip
+ *  per shot under `renders/<project>/clips/`, named with the shot id followed by a NON-digit separator
+ *  (e.g. `shot_09_i2v.mp4`, `shot_09_seedance.mp4`). Match the shot id only at a digit boundary so
+ *  `shot_1` never swallows `shot_10`; exclude `_finished*` (finish-chain outputs, not motion clips);
+ *  require a video extension. Matches by shot-id boundary, NOT the backend's exact slug, so it stays
+ *  independent of the backend naming convention (the core never hardcodes where the backend wrote). */
+export declare function clipFileMatchesShot(file: string, shotId: string): boolean;
+/** Pure: does an R2 clips-object filename belong to this shot's FINISH-chain output? The finish modules
+ *  write `renders/<project>/clips/<shot_id>_finished.mp4`. Same shot-id digit boundary as the motion-clip
+ *  matcher, but here the `_finished` marker is REQUIRED (it is the finish output, not the raw motion clip)
+ *  and a video extension is required. Matches by boundary + the `finished` marker, not a hardcoded full
+ *  slug, so it stays independent of the backend convention. */
+export declare function finishedClipFileMatchesShot(file: string, shotId: string): boolean;
+/** Map shot_id -> R2 key for the objects under `renders/<project>/clips/` that match `matches` (by shot-id
+ *  boundary). Makes R2 PRESENCE the authority on completion: an artifact in R2 beats a module's poll
+ *  verdict (the backend wrote it even if its RunPod job was later GC'd and the module fast-failed the
+ *  poll; issue #141). `matches` selects the raw motion clip (default) or the finish output. Only the
+ *  requested shot ids are returned. */
+export declare function listClipsByShotId(env: Env, project: string, shotIds: string[], matches?: (file: string, shotId: string) => boolean, minUploadedMs?: number): Promise<Map<string, string>>;
+/** Start a clip job: resolve the motion.backend module per shot, submit, persist poll tokens. */
+export declare function startClipJob(env: Env, args: {
+    project: string;
+    shots: ClipShotInput[];
+    motion_backend?: string;
+    config?: Record<string, unknown>;
+    module_configs?: Record<string, Record<string, unknown>>;
+}, preModules?: RegisteredModule[]): Promise<ClipJob>;
+/** Advance a clip job: poll the shots still pending; the module finalizes a clip to R2 on done. */
+export declare function advanceClipJob(env: Env, jobId: string, preModules?: RegisteredModule[]): Promise<ClipJob | null>;
+/** #536: teardown cancel -- STOP every in-flight (pending, poll-token-bearing) shot RunPod job when a clip
+ *  job is cancelled/torn down, so a user-cancelled render does not leave the GPU running (the motion-phase
+ *  sibling of cancelInFlightKeyframe; cancelFilmJob calls this off the clips phase). Persists cancel_sent.
+ *  No-op when nothing is in flight. */
+export declare function cancelInFlightClips(env: Env, jobId: string, preModules?: RegisteredModule[]): Promise<void>;
+/** R2 PRESENCE IS THE SOURCE OF TRUTH for clip completion. Mutates the clip job in place: any shot that
+ *  is NOT done but whose motion clip is present in R2 (matched by shot-id boundary) is marked done with
+ *  that key (pending OR failed -- the artifact overrides a module's premature fast-fail; issue #141). A
+ *  shot with no R2 clip is left as-is (a genuine non-render). Only lists R2 when there is at least one
+ *  not-done shot to reclaim (the all-done happy path pays nothing). Returns the number adopted. This is
+ *  the single reclaim used both inside advanceClipJob AND by the film orchestrator before it judges the
+ *  clip job complete, so a fast-fail at 150s can never advance the film with a clip dropped. */
+export declare function reclaimClipsFromR2(env: Env, job: ClipJob): Promise<number>;
+/** #523 Layer 1: validate each newly-done clip's STRUCTURE (mp4 box tree) before the finish / dialogue /
+ *  upscale chain spends anything. Engine-agnostic: every motion.backend clip (cloud backend, both local
+ *  doors, any future module) funnels through this one chokepoint. Idempotent per shot via `validated`, so
+ *  it runs at most once and can be called from more than one seam. A structural FAILURE flips the shot to
+ *  failed with the real reason (honest-failure #245/#249: never a silent advance, never applied=[]) and
+ *  clears its poll token so the orphan-cancel pass ignores a clip that already landed. A "skip" (artifact
+ *  unreadable / validation disabled) leaves the shot untouched -- an I/O blip must never false-reject a
+ *  real render. Emits one `clip.validate` structured event per shot (docs/observability.md) so smoke tests
+ *  assert on the event, not prose. Returns true iff it changed any shot; the CALLER owns the job-doc write.
+ *
+ *  HONEST SCOPE: this catches the STRUCTURAL-corruption class (truncated / empty / zero-frame /
+ *  zero-duration / non-mp4). It does NOT catch the local-16gb#35 pure-noise clip, which is a structurally
+ *  valid mp4 -- that needs a pixel decode (Layer 2, a video-finish-container pre-gate, filed separately). */
+export declare function validateDoneClips(env: Env, job: ClipJob): Promise<boolean>;
+//# sourceMappingURL=render-orchestrator.d.ts.map

package/dist/render-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-orchestrator.d.ts","sourceRoot":"","sources":["../src/render-orchestrator.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAY9D,OAAO,EACL,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,CAAC;AAIxB,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAIzD;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAWjG;AAED,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;8BAC8B;AAC9B,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAuCpF;AAED;;;;;uGAKuG;AACvG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOzE;AAED;;;;+DAI+D;AAC/D,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMjF;AAED;;;;uCAIuC;AACvC,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAA6B,EACxE,aAAa,SAAI,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqB9B;AAED,iGAAiG;AACjG,wBAAsB,YAAY,CAChC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1D,EACD,UAAU,CAAC,EAAE,gBAAgB,EAAE,GAC9B,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED,mGAAmG;AACnG,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA8BtH;AAqCD;;;uCAGuC;AACvC,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjH;AAED;;;;;;gGAMgG;AAChG,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBhF;AAED;;;;;;;;;;;;6GAY6G;AAC7G,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBhF"}