@skyphusion-labs/vivijure-core 0.9.0

package/README.md

@@ -0,0 +1,87 @@
+# @skyphusion-labs/vivijure-core
+
+Shared orchestration for [Vivijure Studio](https://github.com/skyphusion-labs/vivijure): module
+registry, film pipeline, planner helpers, and the **Platform ICD** that lets one codebase run on
+Cloudflare Workers or a provider-neutral Node host.
+
+| Consumer | Role |
+|----------|------|
+| [`vivijure`](https://github.com/skyphusion-labs/vivijure) | CF-native control plane (D1, R2, service bindings) |
+| [`vivijure-local`](https://github.com/skyphusion-labs/vivijure-local) | Homelab control plane (SQLite, S3/MinIO, HTTP sidecars) |
+
+**Status:** Parity with `vivijure` orchestration established (see [docs/PARITY.md](docs/PARITY.md)).
+Published on npm as `@skyphusion-labs/vivijure-core`. `vivijure-local` consumes semver; `vivijure` (CF)
+still carries duplicate `src/` copies until [docs/HOST-ADOPTION.md](docs/HOST-ADOPTION.md).
+
+## Layout
+
+```
+src/
+  platform/          Platform ICD + orchestratorContextFromPlatform()
+  modules/           vivijure-module/2 contract, registry, conformance
+  film-*.ts          Film + clip orchestration
+  *-db.ts            D1-shaped metadata helpers (DbEnv)
+  preflight.ts       Planner pre-render validation
+  ...
+docs/
+  PLATFORM.md        Frozen adapter contract (ICD v1)
+  ARCHITECTURE.md    Package boundary + dependency rules
+  HOST-ADOPTION.md   CF + local host migration checklist
+```
+
+## Install
+
+**npm (consumers):**
+
+```bash
+npm install @skyphusion-labs/vivijure-core
+```
+
+**Sibling clone (vivijure-local / vivijure dev):**
+
+```
+~/dev/
+  vivijure-core/
+  vivijure-local/    # package.json: "^0.9.0" — override with file:../vivijure-core locally
+  vivijure/
+```
+
+```bash
+cd vivijure-core
+npm ci
+npm run build   # emits dist/ (also runs on npm install via prepare)
+npm run typecheck && npm test
+```
+
+**Publish** (maintainers): merge to `main`, ensure repo secret `NPM_TOKEN` is set, then:
+
+```bash
+git tag vivijure-core-v0.9.0
+git push origin vivijure-core-v0.9.0
+```
+
+Or trigger the **Publish npm package** workflow manually after bumping `package.json` version.
+
+**flatliners** (Hetzner test box): clone/pull from GitHub `main` via `gh`, not laptop rsync.
+See [docs/FLATLINERS-DEV.md](docs/FLATLINERS-DEV.md) and `scripts/flatliners-sync.sh`.
+
+## Key exports
+
+| Entry | Contents |
+|-------|----------|
+| `@skyphusion-labs/vivijure-core` | Barrel: registry, orchestrators, conformance, ... |
+| `@skyphusion-labs/vivijure-core/platform` | `Platform`, `orchestratorContextFromPlatform`, R2 shim |
+| `@skyphusion-labs/vivijure-core/film-orchestrator` | Full film state machine |
+| `@skyphusion-labs/vivijure-core/preflight` | Storyboard pre-render checks |
+
+Full subpath list: `package.json` `exports` field.
+
+## Platform ICD
+
+Orchestration never touches Worker bindings or `process.env` directly. Hosts implement `Platform`
+(see [docs/PLATFORM.md](docs/PLATFORM.md)) and pass `orchestratorContextFromPlatform(platform)`
+into ported handlers.
+
+## License
+
+AGPL-3.0-only. Same as Vivijure Studio upstream.

package/dist/audio-routing.d.ts

@@ -0,0 +1,2 @@
+export declare function needsAudioCrossBucketCopy(key: string): boolean;
+//# sourceMappingURL=audio-routing.d.ts.map

package/dist/audio-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-routing.d.ts","sourceRoot":"","sources":["../src/audio-routing.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/audio-routing.js

@@ -0,0 +1,4 @@
+export function needsAudioCrossBucketCopy(key) {
+    return key.startsWith("out/");
+}
+//# sourceMappingURL=audio-routing.js.map

package/dist/audio-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-routing.js","sourceRoot":"","sources":["../src/audio-routing.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/audio-stage.d.ts

@@ -0,0 +1,4 @@
+import type { Env } from "./platform/orchestrator-context.js";
+export declare function stageAudioKeyForRenders(env: Env, audioKey: string): Promise<string>;
+export declare function resolveStagedAudioKey(env: Env, audioKey: string | undefined): Promise<string | undefined>;
+//# sourceMappingURL=audio-stage.d.ts.map

package/dist/audio-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-stage.d.ts","sourceRoot":"","sources":["../src/audio-stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAG9D,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAazF;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG/G"}

package/dist/audio-stage.js

@@ -0,0 +1,25 @@
+import { needsAudioCrossBucketCopy } from "./audio-routing.js";
+export async function stageAudioKeyForRenders(env, audioKey) {
+    const key = audioKey.trim();
+    if (!key)
+        throw new Error("audioKey required");
+    if (!needsAudioCrossBucketCopy(key))
+        return key;
+    if (await env.R2_RENDERS.head(key))
+        return key;
+    const src = await env.R2.get(key);
+    if (!src)
+        throw new Error(`audio source not found: ${key}`);
+    const ext = key.split(".").pop() || "mp3";
+    const dest = `audio/${crypto.randomUUID()}.${ext}`;
+    const head = await env.R2.head(key);
+    const mime = head?.httpMetadata?.contentType || "audio/mpeg";
+    await env.R2_RENDERS.put(dest, await src.arrayBuffer(), { httpMetadata: { contentType: mime } });
+    return dest;
+}
+export async function resolveStagedAudioKey(env, audioKey) {
+    if (!audioKey?.trim())
+        return undefined;
+    return stageAudioKeyForRenders(env, audioKey.trim());
+}
+//# sourceMappingURL=audio-stage.js.map

package/dist/audio-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-stage.js","sourceRoot":"","sources":["../src/audio-stage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAQ,EAAE,QAAgB;IACtE,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAChD,IAAI,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAG,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,GAAG,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,EAAE,YAAY,EAAE,WAAW,IAAI,YAAY,CAAC;IAC7D,MAAM,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACjG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAQ,EAAE,QAA4B;IAChF,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/beat-analyze.d.ts

@@ -0,0 +1,22 @@
+import type { Env } from "./platform/orchestrator-context.js";
+import type { RegisteredModule } from "./modules/types.js";
+import { type AudioAnalyzeRequest, type AudioBeatPlan } from "./runpod-submit.js";
+/** Score modules that analyze beat timing (config_schema.clip_seconds). */
+export declare function beatSyncScoreModules(modules: RegisteredModule[]): RegisteredModule[];
+interface BeatSyncModuleOutput {
+    film_key: string;
+    applied: string[];
+    beat_plan?: AudioBeatPlan;
+}
+export declare function beatPlanFromModuleOutput(output: BeatSyncModuleOutput | null | undefined): AudioBeatPlan | null;
+export type BeatAnalyzeResult = {
+    ok: true;
+    plan: AudioBeatPlan;
+    module: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function analyzeAudioBeats(env: Env, req: AudioAnalyzeRequest, moduleName?: string): Promise<BeatAnalyzeResult>;
+export {};
+//# sourceMappingURL=beat-analyze.d.ts.map

package/dist/beat-analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beat-analyze.d.ts","sourceRoot":"","sources":["../src/beat-analyze.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAQ9D,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAM5B,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAIpF;AAgBD,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,CAI9G;AAqCD,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,mBAAmB,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA8C5B"}

package/dist/beat-analyze.js

@@ -0,0 +1,111 @@
+// Planner beat analysis via the installed beat-sync score module (registry-driven).
+//
+// When MODULE_BEAT_SYNC is bound, POST /api/audio/analyze invokes the module worker, which calls
+// the always-on audio-beat-sync container on the Hetzner fleet over Workers VPC. Falls back to a
+// direct core VPC call when the module is not installed (legacy path).
+import { discoverModules, invokeModule, resolveFetcher, servingForHook, validateConfig, } from "./modules/registry.js";
+import { presignR2Get } from "./presign.js";
+import { parseAudioBeatPlan, } from "./runpod-submit.js";
+/** Score modules that analyze beat timing (config_schema.clip_seconds). */
+export function beatSyncScoreModules(modules) {
+    return servingForHook(modules, "score").filter((m) => m.config_schema != null && m.config_schema.clip_seconds != null);
+}
+function fetcherForModule(env, mod) {
+    return resolveFetcher(env, mod.binding);
+}
+function resolveBeatSyncModule(modules, moduleName) {
+    const candidates = beatSyncScoreModules(modules);
+    if (candidates.length === 0)
+        return null;
+    if (moduleName)
+        return candidates.find((m) => m.name === moduleName) ?? null;
+    return candidates[0];
+}
+export function beatPlanFromModuleOutput(output) {
+    const plan = output?.beat_plan;
+    if (!plan || (plan.mode !== "beat" && plan.mode !== "duration"))
+        return null;
+    return plan;
+}
+function userConfigFromRequest(req) {
+    const out = {};
+    if (typeof req.clipSeconds === "number")
+        out.clip_seconds = req.clipSeconds;
+    if (req.mode === "beat" || req.mode === "duration")
+        out.mode = req.mode;
+    if (typeof req.minSceneS === "number")
+        out.min_scene_s = req.minSceneS;
+    if (typeof req.maxSceneS === "number")
+        out.max_scene_s = req.maxSceneS;
+    if (typeof req.forceShots === "number")
+        out.force_shots = req.forceShots;
+    return out;
+}
+async function analyzeViaVpc(env, audioUrl, req) {
+    const vpc = env.AUDIO_BEAT_SYNC_VPC;
+    if (!vpc)
+        return { ok: false, error: "AUDIO_BEAT_SYNC_VPC not configured" };
+    const resp = await vpc.fetch("http://audio-beat-sync/analyze", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+            audioUrl,
+            audioKey: req.audioKey,
+            clipSeconds: req.clipSeconds ?? 8,
+            mode: req.mode ?? "beat",
+            minSceneS: req.minSceneS ?? 2.5,
+            maxSceneS: req.maxSceneS ?? 12,
+            forceShots: req.forceShots,
+        }),
+    });
+    const plan = parseAudioBeatPlan(await resp.json());
+    if (!plan)
+        return { ok: false, error: "beat-sync container returned an unrecognized plan" };
+    return { ok: true, plan };
+}
+export async function analyzeAudioBeats(env, req, moduleName) {
+    const audioKey = req.audioKey?.trim();
+    if (!audioKey)
+        return { ok: false, error: "audioKey required" };
+    let audioUrl;
+    try {
+        audioUrl = await presignR2Get(env, audioKey, 300);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { ok: false, error: "could not presign audio: " + msg.slice(0, 200) };
+    }
+    const modules = await discoverModules(env);
+    const mod = resolveBeatSyncModule(modules, moduleName?.trim() || undefined);
+    if (mod) {
+        const fetcher = fetcherForModule(env, mod);
+        if (!fetcher) {
+            return { ok: false, error: `beat-sync module "${mod.name}" binding ${mod.binding} is not reachable` };
+        }
+        const config = {
+            ...validateConfig(mod.config_schema, userConfigFromRequest(req)),
+            audio_url: audioUrl,
+            audio_key: audioKey,
+        };
+        const r = await invokeModule(fetcher, {
+            hook: "score",
+            input: { film_key: "beat-analyze/planner", seconds: 0 },
+            config,
+            context: { job_id: crypto.randomUUID(), project: "planner" },
+        });
+        if (!r.ok)
+            return { ok: false, error: r.error || `${mod.name} invoke failed` };
+        if (!("output" in r)) {
+            return { ok: false, error: `${mod.name} returned async poll (beat analysis is synchronous)` };
+        }
+        const plan = beatPlanFromModuleOutput(r.output);
+        if (!plan)
+            return { ok: false, error: `${mod.name} finished but returned no beat plan` };
+        return { ok: true, plan, module: mod.name };
+    }
+    const direct = await analyzeViaVpc(env, audioUrl, req);
+    if (!direct.ok)
+        return direct;
+    return { ok: true, plan: direct.plan, module: "core-vpc" };
+}
+//# sourceMappingURL=beat-analyze.js.map

package/dist/beat-analyze.js.map

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

package/dist/beat-sync-types.d.ts

@@ -0,0 +1,33 @@
+import type { ScoreOutput } from "./modules/types.js";
+export interface TimedScene {
+    index: number;
+    start: number;
+    end: number;
+    targetSeconds: number;
+}
+export interface AudioBeatPlan {
+    mode: "beat" | "duration";
+    audioKey: string;
+    durationSeconds: number;
+    bpm?: number;
+    beatCount?: number;
+    suggestedShots: number;
+    clipSeconds: number;
+    filmSeconds: number;
+    remainderSeconds: number;
+    timedScenes: TimedScene[];
+    note: string;
+}
+/** POST /api/audio/analyze request (camelCase). */
+export interface AudioAnalyzeRequest {
+    audioKey: string;
+    clipSeconds?: number;
+    mode?: "beat" | "duration";
+    minSceneS?: number;
+    maxSceneS?: number;
+    forceShots?: number;
+}
+export interface BeatSyncOutput extends ScoreOutput {
+    beat_plan?: AudioBeatPlan;
+}
+//# sourceMappingURL=beat-sync-types.d.ts.map

package/dist/beat-sync-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beat-sync-types.d.ts","sourceRoot":"","sources":["../src/beat-sync-types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B"}

package/dist/beat-sync-types.js

@@ -0,0 +1,4 @@
+// Beat-sync / planner analyze types. Upstream keeps these in modules/beat-sync/src/contract.ts;
+// vivijure-core keeps them out of modules/types.ts so that file stays verbatim with vivijure main.
+export {};
+//# sourceMappingURL=beat-sync-types.js.map

package/dist/beat-sync-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beat-sync-types.js","sourceRoot":"","sources":["../src/beat-sync-types.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,mGAAmG"}

package/dist/bundle-assembler.d.ts

@@ -0,0 +1,54 @@
+import type { OrchestratorEnv } from "./platform/orchestrator-context.js";
+import { type SlotId, type StoryboardValidated } from "./storyboard-validate.js";
+export { gunzipBytes } from "./bundle-durations.js";
+export interface TrainingImage {
+    key?: string;
+    dataUrl?: string;
+    filename?: string;
+}
+export interface CharacterRef {
+    name: string;
+    prompt: string;
+    trainingImages: TrainingImage[];
+    portrait?: TrainingImage;
+}
+export interface AssembleBundleArgs {
+    storyboard: StoryboardValidated;
+    characterRefs: Partial<Record<SlotId, CharacterRef>>;
+    startImage?: TrainingImage;
+    sceneStartImages?: Record<string, TrainingImage>;
+}
+export type AssembleBundleResult = {
+    ok: true;
+    bundleKey: string;
+    sizeBytes: number;
+    fileCount: number;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function safeCharFilename(slot: SlotId, name: string): string;
+export declare function detectImageExt(bytes: Uint8Array): "png" | "jpg" | "webp";
+export declare function decodeDataUrl(dataUrl: string): Uint8Array | null;
+export declare function overlayKeyframesIntoBundle(env: OrchestratorEnv, srcBundleKey: string, outBundleKey: string, keyframes: Array<{
+    shot_id: string;
+    key: string;
+}>): Promise<{
+    ok: true;
+    bundleKey: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function bundleKeyFor(projectName: string, tarBytes: Uint8Array): Promise<string>;
+export declare function callImagePrep(env: OrchestratorEnv, payload: {
+    inputUrl: string;
+    outputUrl: string;
+    outputKey: string;
+    background: "alpha" | "black";
+}, opts?: {
+    retries?: number;
+    backoffMs?: number;
+}): Promise<Response | null>;
+export declare function assembleBundle(env: OrchestratorEnv, args: AssembleBundleArgs): Promise<AssembleBundleResult>;
+//# sourceMappingURL=bundle-assembler.d.ts.map

package/dist/bundle-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-assembler.d.ts","sourceRoot":"","sources":["../src/bundle-assembler.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKpD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,aAAa,EAAE,CAAC;IAEhC,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACrD,UAAU,CAAC,EAAE,aAAa,CAAC;IAQ3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAON,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAInE;AAOD,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAmBxE;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAWhE;AAiCD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBzE;AAsBD,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7F;AAOD,wBAAsB,aAAa,CACjC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,EAClG,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA2B1B;AAqDD,wBAAsB,cAAc,CAClC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA2K/B"}