videoclaw 3.0.0-alpha.1

package/dist/video/preview-portal/types.d.ts

@@ -0,0 +1,246 @@
+export declare const PREVIEW_PORTAL_SURFACES: readonly ["edit", "review", "client-review", "preview", "compare", "index"];
+export declare const PREVIEW_PORTAL_STATUSES: readonly ["draft", "editor-review", "changes-requested", "client-review", "client-declined", "client-approved", "final", "published", "archived"];
+export declare const PREVIEW_PORTAL_TEMPLATES: readonly ["music-video", "story-film", "documentary", "product-ad", "sports-recap", "generic-video"];
+export type PreviewPortalSurface = typeof PREVIEW_PORTAL_SURFACES[number];
+export type PreviewPortalStatus = typeof PREVIEW_PORTAL_STATUSES[number];
+export type PreviewPortalTemplateId = typeof PREVIEW_PORTAL_TEMPLATES[number];
+export interface PreviewPortalTemplate {
+    id: PreviewPortalTemplateId;
+    name: string;
+    heroLabel: string;
+    primaryAssetLabel: string;
+    sectionOrder: string[];
+    sectionLabels: Record<string, string>;
+}
+export interface PreviewPortalAsset {
+    id: string;
+    path: string;
+    kind: 'image' | 'video' | 'audio' | 'html' | 'json' | 'text' | 'other';
+    label: string;
+    section: string;
+    sizeBytes?: number;
+    exists: boolean;
+    /** ISO timestamp of when the file was created/downloaded on disk (file mtime).
+     * Rendered on each card so the operator sees when an asset landed. */
+    createdAt?: string;
+    /** Scene index for keyframe/generation-input assets, used to pair them with
+     * their storyboard beat. Carried through from the asset-manifest. */
+    sceneIndex?: number;
+    /** Real pixel dimensions probed at discovery (ffprobe for video, header parse
+     * for stills). Drive PER-ASSET card sizing: a 9:16 deliverable must render in
+     * a portrait card even inside a 16:9 project. Unset when probing fails. */
+    width?: number;
+    height?: number;
+    orientation?: 'portrait' | 'square' | 'landscape';
+}
+export interface PreviewPortalBriefMetadata {
+    platform?: string;
+    executionProfile?: {
+        aspectRatio?: string;
+        quality?: string;
+        resolution?: string;
+        generateAudio?: boolean;
+        outputCount?: number;
+    };
+    [key: string]: unknown;
+}
+/** Brief artifact subset rendered in the preview header. */
+export interface PreviewPortalBrief {
+    title: string;
+    intent: string;
+    metadata?: PreviewPortalBriefMetadata;
+}
+export interface PreviewPortalScene {
+    sceneIndex: number;
+    description: string;
+    characters?: string[];
+    scenePrompt?: {
+        imagePrompt?: string;
+        animationPrompt?: string;
+        cameraMove?: string;
+        styleFooter?: string;
+    };
+    /**
+     * The exact provider submit text for this scene — the resolved
+     * `filmmaking-prompts.json` seedance packet (`seedancePackets[].promptText`,
+     * the 10-block Joey master prompt) matched by sceneIndex. This is the
+     * "what the model actually receives" contract; when present it is the
+     * authoritative prompt rendered in the scene card, above the lighter
+     * storyboard `scenePrompt` fields.
+     */
+    renderPrompt?: string;
+    /**
+     * The reference slots this scene will submit (`seedancePackets[].references`),
+     * each with its role, ready/pending status, and — for character-sheet slots —
+     * the bound `Asset://` URI resolved from `seedance-assets.json`. Surfacing this
+     * lets the operator confirm identity-lock (which avatar locks which scene, and
+     * whether every required reference is ready) before any render spend.
+     */
+    referenceSlots?: PreviewPortalReferenceSlot[];
+    /**
+     * Optional narrative color-language state for this scene (the grade id, e.g.
+     * `cool-steel` / `crimson-threat` / `electric-blue`). Rendered as a swatched
+     * chip in the contract card so the operator sees the intended look per scene,
+     * and applied as the per-segment grade at assemble time.
+     */
+    colorState?: string;
+    dialogue?: string;
+    durationSeconds?: number;
+}
+export interface PreviewPortalReferenceSlot {
+    slot: string;
+    role: string;
+    label: string;
+    status: 'ready' | 'pending';
+    path?: string;
+    characterName?: string;
+    /** Bound Asset Library URI (e.g. `Asset://...`) for character-sheet slots,
+     * resolved from seedance-assets.json by character name. Absent until the
+     * character's avatar is registered via `vclaw video seedance-register-assets`. */
+    assetUri?: string;
+}
+/** Storyboard artifact subset rendered as scene cards paired with keyframes. */
+export interface PreviewPortalStoryboard {
+    scenes: PreviewPortalScene[];
+}
+export interface PreviewPortalCard {
+    id: string;
+    kind: 'character' | 'scene' | 'clip' | 'final' | 'version' | 'asset' | 'run';
+    title: string;
+    subtitle?: string;
+    assetIds: string[];
+    reviewable: boolean;
+}
+export interface PreviewPortalRun {
+    runId: string;
+    label: string;
+    status: PreviewPortalStatus;
+    createdAt: string;
+    updatedAt: string;
+    publishedAt?: string | null;
+    approvedAt?: string | null;
+    declinedAt?: string | null;
+}
+/** One palette entry surfaced from brand-definition.json, in role order. */
+export interface PreviewPortalBrandColor {
+    role: string;
+    hex: string;
+    name?: string;
+}
+/**
+ * The client's locked brand system (subset of `artifacts/brand-definition.json`)
+ * used to theme the preview + client-review surfaces: accent/glow from the
+ * palette, header wordmark/logo, hero tagline, and the brand-book annex.
+ * Absent → the portal renders its stock theme, visually unchanged.
+ */
+export interface PreviewPortalBrand {
+    brandName: string;
+    positioning?: string;
+    taglines?: {
+        functional?: string;
+        emotional?: string;
+        community?: string;
+    };
+    palette: PreviewPortalBrandColor[];
+    typography: Array<{
+        level: string;
+        font: string;
+        weight: string;
+    }>;
+    /** Project-relative path to a discovered client logo (assets/brand/logo.*). */
+    logoPath?: string;
+}
+/**
+ * One locked identity in the production: a registered Flow Character (from
+ * `artifacts/flow-characters.json`) or a reference character (from
+ * `characters/characters.json`). Surfaced as the portal's Cast section so the
+ * client can see who/what is identity-locked across every shot.
+ */
+export interface PreviewPortalCastMember {
+    name: string;
+    source: 'flow-character' | 'character';
+    /** Stable id (entityId for Flow Characters) shown beneath the name. */
+    ref?: string;
+    /** Project-relative still matched to this name (else a monogram renders). */
+    stillPath?: string;
+    /** e.g. 'product master' when the name reads as the brand master asset. */
+    role?: string;
+}
+export interface PreviewPortalProject {
+    client?: string | null;
+    slug: string;
+    title: string;
+    template: PreviewPortalTemplateId;
+    status: PreviewPortalStatus;
+    projectDir: string;
+    run: PreviewPortalRun;
+    summary?: string;
+    /** Optional locked brand system — themes the client-facing surfaces. */
+    brand?: PreviewPortalBrand;
+    /** Registered cast / identity locks (Flow Characters + reference characters). */
+    cast?: PreviewPortalCastMember[];
+    /** Optional brief artifact, rendered as the preview's Brief header. */
+    brief?: PreviewPortalBrief;
+    /** Optional storyboard artifact, rendered as scene cards paired with keyframes. */
+    storyboard?: PreviewPortalStoryboard;
+    assets: PreviewPortalAsset[];
+    cards: PreviewPortalCard[];
+    /**
+     * Optional project soundtrack/score. When present, the polished `preview`
+     * showcase renders an `<audio controls preload="none">` player; when absent,
+     * no audio element is emitted. Discovered from an audio asset (.mp3/.m4a/.wav)
+     * or a `soundtrack`/`audio` manifest field.
+     */
+    soundtrack?: PreviewPortalSoundtrack;
+}
+export interface PreviewPortalSoundtrack {
+    /** Project-relative path to the headline (selected, or sole) audio file. */
+    path: string;
+    /** Human-readable label for the headline track. */
+    label: string;
+    /**
+     * Optional A/B candidate list (from soundtrack.json). When present and longer
+     * than one entry, the preview renders an audio player per candidate so a human
+     * can compare/pick; the candidate matching `path` is the headline. Absent for
+     * legacy single-soundtrack projects (no soundtrack.json).
+     */
+    candidates?: PreviewPortalSoundtrackCandidate[];
+}
+export interface PreviewPortalSoundtrackCandidate {
+    /** Backend that produced the candidate (e.g. 'suno', 'lyria'). */
+    backendId: string;
+    /** Project-relative path to the candidate audio file. */
+    path: string;
+    /** Human-readable label for the candidate. */
+    label: string;
+    /** True when this is the human-selected headline candidate. */
+    selected: boolean;
+}
+export interface PreviewPortalRenderOptions {
+    surface: PreviewPortalSurface;
+    project: PreviewPortalProject;
+    compareProjects?: PreviewPortalProject[];
+}
+export interface PreviewPortalIndexRenderOptions {
+    projects: PreviewPortalProject[];
+    client?: string | null;
+    title?: string;
+    generatedAt?: string;
+    linkPrefix?: string;
+    linkMode?: 'local' | 'published-run';
+}
+export interface PreviewPortalAuditEvent {
+    timestamp: string;
+    event: 'surface.generated' | 'surface.published' | 'client.feedback.copied' | 'editor.review.copied' | 'run.created' | 'run.promoted';
+    client?: string | null;
+    project: string;
+    run: string;
+    surface?: PreviewPortalSurface;
+    template?: PreviewPortalTemplateId;
+    output?: string;
+    assetCount?: number;
+    url?: string;
+    htmlHash?: string;
+    status?: PreviewPortalStatus;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/video/preview-portal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/video/preview-portal/types.ts"],"names":[],"mappings":"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"}

package/dist/video/preview-portal/types.js

@@ -0,0 +1,28 @@
+export const PREVIEW_PORTAL_SURFACES = [
+    'edit',
+    'review',
+    'client-review',
+    'preview',
+    'compare',
+    'index',
+];
+export const PREVIEW_PORTAL_STATUSES = [
+    'draft',
+    'editor-review',
+    'changes-requested',
+    'client-review',
+    'client-declined',
+    'client-approved',
+    'final',
+    'published',
+    'archived',
+];
+export const PREVIEW_PORTAL_TEMPLATES = [
+    'music-video',
+    'story-film',
+    'documentary',
+    'product-ad',
+    'sports-recap',
+    'generic-video',
+];
+//# sourceMappingURL=types.js.map

package/dist/video/preview-portal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/video/preview-portal/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,QAAQ;IACR,eAAe;IACf,SAAS;IACT,SAAS;IACT,OAAO;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO;IACP,eAAe;IACf,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,OAAO;IACP,WAAW;IACX,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,aAAa;IACb,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,cAAc;IACd,eAAe;CACP,CAAC"}

package/dist/video/product-references.d.ts

@@ -0,0 +1,21 @@
+import type { VideoProjectWorkspace } from './workspace.js';
+/**
+ * A single product whose hero/variant images anchor the product-subject
+ * filmmaking branch. `referenceAssets` are workspace-relative paths (the same
+ * Asset:// mechanism used by character reference sheets).
+ */
+export interface ProductReference {
+    name: string;
+    referenceAssets: string[];
+}
+export interface ProductReferencesArtifact {
+    schemaVersion: 1;
+    products: ProductReference[];
+}
+/**
+ * Read `artifacts/product-references.json` for a project. Returns an empty
+ * product list when the file is absent — product-subject categories degrade
+ * gracefully to description-only packets rather than failing.
+ */
+export declare function readProductReferences(workspace: VideoProjectWorkspace): Promise<ProductReferencesArtifact>;
+//# sourceMappingURL=product-references.d.ts.map

package/dist/video/product-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-references.d.ts","sourceRoot":"","sources":["../../src/video/product-references.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,yBAAyB,CAAC,CAepC"}

package/dist/video/product-references.js

@@ -0,0 +1,25 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Read `artifacts/product-references.json` for a project. Returns an empty
+ * product list when the file is absent — product-subject categories degrade
+ * gracefully to description-only packets rather than failing.
+ */
+export async function readProductReferences(workspace) {
+    const path = join(workspace.artifactsDir, 'product-references.json');
+    if (!existsSync(path)) {
+        return { schemaVersion: 1, products: [] };
+    }
+    const parsed = JSON.parse(await readFile(path, 'utf-8'));
+    return {
+        schemaVersion: 1,
+        products: Array.isArray(parsed.products)
+            ? parsed.products.map((product) => ({
+                name: product.name,
+                referenceAssets: Array.isArray(product.referenceAssets) ? product.referenceAssets : [],
+            }))
+            : [],
+    };
+}
+//# sourceMappingURL=product-references.js.map

package/dist/video/product-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-references.js","sourceRoot":"","sources":["../../src/video/product-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkBjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAgC;IAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;IACrE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAuC,CAAC;IAC/F,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YACtC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;aACvF,CAAC,CAAC;YACL,CAAC,CAAC,EAAE;KACP,CAAC;AACJ,CAAC"}

package/dist/video/project-blueprint.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Project Blueprint — the AI Animation Director "director layer" artifact.
+ *
+ * A project-level visual blueprint that locks the film language ABOVE the
+ * existing execution layer ({@link ./cinematography}, {@link ./filmmaking-prompts}).
+ * Distinct from {@link ./story-bible} (a CONTINUITY bible: cast/props/timeline) —
+ * this is the VISUAL DIRECTION bible: visual identity, master color system,
+ * lighting grammar, per-character blueprint (silhouette + palette + voice +
+ * power/vulnerability/signature camera framing), environment blueprint (with the
+ * 5-sensory-words rule), a project camera bible (dominant shots, forbidden
+ * movements, the one rule the camera must never break), and voice/performance
+ * world rules.
+ *
+ * Generation is a creative LLM task (the `ai-director` skill runs the staged
+ * director master-prompt and emits a JSON). This module is the deterministic
+ * half: validate the skill-authored JSON, normalize it to the canonical artifact
+ * shape, and persist it as a managed, history-tracked artifact. The
+ * {@link ./filmmaking-prompts} composer reads it back (graceful when absent) to
+ * enrich every scene packet.
+ */
+import type { VideoProjectWorkspace } from './workspace.js';
+import type { SensorySignature } from './shot-grammar.js';
+export interface BlueprintInfluence {
+    name: string;
+    /** The specific visual element borrowed (not a vibe — a concrete element). */
+    borrowed: string;
+}
+export interface VisualIdentity {
+    aesthetic: string;
+    influences: BlueprintInfluence[];
+    texture: string;
+    scale: string;
+    timeOfDay: string;
+    /** One-line "looks like X, feels like Y, lit like Z" thesis. */
+    thesis: string;
+}
+export interface MasterColor {
+    name: string;
+    where: string;
+    emotion: string;
+    hex?: string;
+}
+export interface ColorSystem {
+    colors: MasterColor[];
+    kelvinRange: string;
+    warmShiftMeaning: string;
+    coolShiftMeaning: string;
+    contrast: string;
+    saturation: string;
+    /** Optional grade-register id resolved by {@link gradeSpec} (e.g. teal-orange). */
+    gradeId?: string;
+}
+export interface SignatureLightingSetups {
+    intimate: string;
+    tension: string;
+    hero: string;
+}
+export interface LightingGrammar {
+    keyDirection: string;
+    quality: string;
+    shadowStrategy: string;
+    practicals: string;
+    signatureSetups: SignatureLightingSetups;
+}
+export interface CharacterVoice {
+    ageGender: string;
+    timbre: string;
+    rhythm: string;
+    accent: string;
+    emotionalLeak: string;
+    /** Two performance anchors. */
+    anchors: string[];
+}
+export interface CharacterCameraLanguage {
+    power: string;
+    vulnerability: string;
+    signature: string;
+}
+export interface BlueprintCharacter {
+    name: string;
+    role: string;
+    visualType: string;
+    silhouette: string;
+    signatureDetail: string;
+    /** Three character colors. */
+    palette: string[];
+    costume: string;
+    communicates: string;
+    voice: CharacterVoice;
+    cameraLanguage: CharacterCameraLanguage;
+}
+export interface BlueprintEnvironment {
+    name: string;
+    type: string;
+    emotionalFunction: string;
+    anchors: string[];
+    scale: string;
+    lightColor: string;
+    /** The 5-sensory-words rule: 1 smell + 1 texture + 1 sound + 2 feelings. */
+    sensory: SensorySignature;
+}
+export interface RareShot {
+    shot: string;
+    when: string;
+}
+export interface ProjectCameraBible {
+    relationship: string;
+    whenMoves: string;
+    whenLocked: string;
+    /** Three dominant shot ids/labels. */
+    dominantShots: string[];
+    rareShots: RareShot[];
+    primaryAngles: string[];
+    primaryMovements: string[];
+    /** Movement ids/labels banned for this project — validated by the composer. */
+    forbiddenMovements: string[];
+    focalFeel: string;
+    depthStrategy: string;
+    /** The single rule the camera must never break. */
+    oneRule: string;
+}
+export interface PerformanceRules {
+    actingStyle: string;
+    dialogueEnergy: string;
+    silenceUsage: string;
+    intensityScale: string;
+    castingPattern: string;
+    avoid: string;
+}
+export interface OutputNotes {
+    runtimeSeconds: number;
+    aspectRatio: string;
+    motionStyle: string;
+    editingRhythm: string;
+    /** 8–12 vibe keywords. */
+    vibeKeywords: string[];
+}
+export interface ProjectBlueprintArtifact {
+    schemaVersion: 1;
+    projectSlug: string;
+    generatedAt: string;
+    source: 'ai-director';
+    title: string;
+    visualIdentity: VisualIdentity;
+    colorSystem: ColorSystem;
+    lightingGrammar: LightingGrammar;
+    characters: BlueprintCharacter[];
+    environments: BlueprintEnvironment[];
+    cameraBible: ProjectCameraBible;
+    performanceRules: PerformanceRules;
+    output: OutputNotes;
+}
+export interface ValidateBlueprintOptions {
+    projectSlug: string;
+    generatedAt?: string;
+}
+/**
+ * Validate + normalize a skill-authored blueprint JSON into the canonical
+ * {@link ProjectBlueprintArtifact}. Lenient on sub-fields (missing strings → '')
+ * but strict on the required top-level sections: throws a single
+ * `invalid_flag_value` VclawError listing every missing/invalid section so the
+ * operator can fix them all at once. Pure (apart from the injected generatedAt).
+ */
+export declare function validateProjectBlueprint(input: unknown, options: ValidateBlueprintOptions): ProjectBlueprintArtifact;
+/**
+ * Read + JSON-parse a blueprint file. Throws `invalid_flag_value` on a missing
+ * file or malformed JSON so the CLI surfaces a clear exit-1 error.
+ */
+export declare function loadBlueprintJson(path: string): Promise<unknown>;
+/** Persist a validated blueprint as the managed, history-tracked artifact. */
+export declare function writeProjectBlueprint(workspace: VideoProjectWorkspace, artifact: ProjectBlueprintArtifact): Promise<string>;
+/**
+ * Read `artifacts/project-blueprint.json`. Returns null when absent (graceful —
+ * the composer then behaves byte-identically to today). Mirrors
+ * {@link readEnvironmentAssets} / {@link readSeedanceAssets}.
+ */
+export declare function readProjectBlueprint(root: string, slug: string): Promise<ProjectBlueprintArtifact | null>;
+//# sourceMappingURL=project-blueprint.d.ts.map

package/dist/video/project-blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-blueprint.d.ts","sourceRoot":"","sources":["../../src/video/project-blueprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,uBAAuB,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,EAAE,uBAAuB,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,WAAW,CAAC;CACrB;AAgLD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAoD1B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAatE;AAED,8EAA8E;AAC9E,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,qBAAqB,EAChC,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAK1C"}