videobook-engine 4.2.0 → 5.3.2

package/dist/schema.js

@@ -15,27 +15,13 @@ export const NOTEBOOK_CELL_TYPES = [
     "concat",
     "splice",
 ];
-export const NOTEBOOK_CELL_SLUG_PREFIXES = {
-    audio: "aud",
-    image: "img",
-    video: "vid",
-    extract_audio: "extract-audio",
-    split_video: "split-video",
-    prompt: "prompt",
-    character: "char",
-    analyze: "analyze",
-    analysis: "analysis",
-    generate_video: "generate-video",
-    generate_image: "generate-image",
-    generate_audio: "generate-audio",
-    concat: "concat",
-    splice: "splice",
+// Cell types that were removed from the union but may still exist in stored
+// rows (the cells-table CHECK below deliberately keeps accepting them so
+// history.restore can reinsert legacy rows). Reads map them to their modern
+// equivalent; writes stay strict.
+export const LEGACY_NOTEBOOK_CELL_TYPE_ALIASES = {
+    extract_frame: "image",
 };
-const NOTEBOOK_CELL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)+$/;
-export function isValidNotebookCellSlug(type, slug) {
-    return NOTEBOOK_CELL_SLUG_PATTERN.test(slug)
-        && slug.startsWith(`${NOTEBOOK_CELL_SLUG_PREFIXES[type]}-`);
-}
 // The staging allowlist is also the restore table list: history.restore
 // reloads every table below from its dolt_at_* projection, deleting in
 // reverse order and inserting in forward order. Keep the list ordered
@@ -56,8 +42,6 @@ export const SEMANTIC_TABLES = [
     "notebook_cell_executions",
     "notebook_generation_plans",
     "notebook_run_plans",
-    "notebook_transcript_edits",
-    "notebook_transcript_attachments",
     "edges",
     "runs",
     "cell_references",
@@ -75,6 +59,7 @@ export const SEMANTIC_TABLES = [
     "audio_waveforms",
     "prompt_entries",
     "messages",
+    "generations",
 ];
 export const RUNTIME_TABLES = [
     "runtime_meta",
@@ -101,6 +86,37 @@ export const RUNTIME_TABLES = [
     "runtime_text_similarity_documents",
     "runtime_text_similarity_chunks",
 ];
+export const CELLS_TABLE_DEFINITION = `
+    notebook_id TEXT NOT NULL
+      REFERENCES notebooks(notebook_id) ON DELETE CASCADE,
+    cell_id TEXT NOT NULL,
+    type TEXT NOT NULL CHECK (
+      type IN (
+        'audio','image','video','extract_audio','extract_frame','split_video',
+        'prompt','character',
+        'analyze','analysis','generate_video','generate_image','generate_audio',
+        'concat','splice'
+      )
+    ),
+    label TEXT,
+    grid_row INTEGER NOT NULL CHECK (grid_row BETWEEN 0 AND 63),
+    grid_column INTEGER NOT NULL CHECK (grid_column BETWEEN 0 AND 7),
+    output_entity_id TEXT
+      REFERENCES entities(entity_id) ON DELETE RESTRICT,
+    prompt TEXT,
+    provider TEXT,
+    model TEXT,
+    operation TEXT,
+    tool TEXT,
+    inputs_json TEXT NOT NULL DEFAULT '{}',
+    output_artifact_id TEXT
+      REFERENCES artifacts(artifact_id) ON DELETE RESTRICT,
+    PRIMARY KEY(notebook_id, cell_id)
+`;
+const CELLS_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS cells (
+    ${CELLS_TABLE_DEFINITION}
+  );`;
 export const SEMANTIC_SCHEMA_SQL = `
   CREATE TABLE IF NOT EXISTS engine_schema (
     singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
@@ -110,13 +126,13 @@ export const SEMANTIC_SCHEMA_SQL = `
 
   CREATE TABLE IF NOT EXISTS book (
     book_id TEXT PRIMARY KEY,
-    slug TEXT NOT NULL UNIQUE,
+    name TEXT NOT NULL,
     created_at INTEGER NOT NULL
   );
 
   CREATE TABLE IF NOT EXISTS artifacts (
     artifact_id TEXT PRIMARY KEY,
-    slug TEXT NOT NULL UNIQUE,
+    label TEXT,
     kind TEXT NOT NULL CHECK (
       kind IN (
         'video','image','audio','script','character',
@@ -193,63 +209,13 @@ export const SEMANTIC_SCHEMA_SQL = `
     field TEXT NOT NULL CHECK (
       field IN (
         'description','lifecycle_state','workflow_version',
-        'analysis_revision','audio_spine','current_selection','fixture'
+        'analysis_revision','fixture'
       )
     ),
     value_json TEXT NOT NULL,
     PRIMARY KEY(notebook_id, field)
   );
-  CREATE TABLE IF NOT EXISTS cells (
-    notebook_id TEXT NOT NULL
-      REFERENCES notebooks(notebook_id) ON DELETE CASCADE,
-    cell_id TEXT NOT NULL,
-    type TEXT NOT NULL CHECK (
-      type IN (
-        'audio','image','video','extract_audio','split_video',
-        'prompt','character',
-        'analyze','analysis','generate_video','generate_image','generate_audio',
-        'concat','splice'
-      )
-    ),
-    slug TEXT NOT NULL CHECK (
-      slug GLOB '[a-z0-9]*'
-      AND slug NOT GLOB '*[^a-z0-9-]*'
-      AND slug NOT GLOB '*--*'
-      AND slug NOT LIKE '-%'
-      AND slug NOT LIKE '%-'
-      AND instr(slug, '-') > 0
-    ),
-    grid_row INTEGER NOT NULL CHECK (grid_row >= 0),
-    grid_column INTEGER NOT NULL,
-    output_entity_id TEXT
-      REFERENCES entities(entity_id) ON DELETE RESTRICT,
-    prompt TEXT,
-    provider TEXT,
-    model TEXT,
-    operation TEXT,
-    tool TEXT,
-    inputs_json TEXT NOT NULL DEFAULT '{}',
-    output_artifact_id TEXT
-      REFERENCES artifacts(artifact_id) ON DELETE RESTRICT,
-    PRIMARY KEY(notebook_id, cell_id),
-    UNIQUE(notebook_id, slug),
-    CHECK (
-      (type = 'audio' AND slug LIKE 'aud-%')
-      OR (type = 'image' AND slug LIKE 'img-%')
-      OR (type = 'video' AND slug LIKE 'vid-%')
-      OR (type = 'extract_audio' AND slug LIKE 'extract-audio-%')
-      OR (type = 'split_video' AND slug LIKE 'split-video-%')
-      OR (type = 'prompt' AND slug LIKE 'prompt-%')
-      OR (type = 'character' AND slug LIKE 'char-%')
-      OR (type = 'analyze' AND slug LIKE 'analyze-%')
-      OR (type = 'analysis' AND slug LIKE 'analysis-%')
-      OR (type = 'generate_video' AND slug LIKE 'generate-video-%')
-      OR (type = 'generate_image' AND slug LIKE 'generate-image-%')
-      OR (type = 'generate_audio' AND slug LIKE 'generate-audio-%')
-      OR (type = 'concat' AND slug LIKE 'concat-%')
-      OR (type = 'splice' AND slug LIKE 'splice-%')
-    )
-  );
+  ${CELLS_TABLE_SQL}
   CREATE TABLE IF NOT EXISTS notebook_cell_executions (
     notebook_id TEXT NOT NULL,
     cell_id TEXT NOT NULL,
@@ -302,22 +268,6 @@ export const SEMANTIC_SCHEMA_SQL = `
     error TEXT,
     PRIMARY KEY(notebook_id, plan_id)
   );
-  CREATE TABLE IF NOT EXISTS notebook_transcript_edits (
-    notebook_id TEXT NOT NULL
-      REFERENCES notebooks(notebook_id) ON DELETE CASCADE,
-    action_id TEXT NOT NULL,
-    kind TEXT NOT NULL,
-    restored INTEGER NOT NULL DEFAULT 0 CHECK (restored IN (0, 1)),
-    payload_json TEXT NOT NULL,
-    PRIMARY KEY(notebook_id, action_id)
-  );
-  CREATE TABLE IF NOT EXISTS notebook_transcript_attachments (
-    notebook_id TEXT NOT NULL
-      REFERENCES notebooks(notebook_id) ON DELETE CASCADE,
-    attachment_id TEXT NOT NULL,
-    payload_json TEXT NOT NULL,
-    PRIMARY KEY(notebook_id, attachment_id)
-  );
   CREATE TABLE IF NOT EXISTS edges (
     notebook_id TEXT NOT NULL
       REFERENCES notebooks(notebook_id) ON DELETE CASCADE,
@@ -633,6 +583,28 @@ export const SEMANTIC_SCHEMA_SQL = `
     body_json TEXT NOT NULL,
     created_at INTEGER NOT NULL
   );
+  CREATE TABLE IF NOT EXISTS generations (
+    generation_id TEXT PRIMARY KEY,
+    notebook_id TEXT NOT NULL,
+    cell_id TEXT NOT NULL,
+    output_cell_id TEXT,
+    run_id TEXT,
+    status TEXT NOT NULL CHECK (
+      status IN ('dispatched','awaiting_provider','completed','failed')
+    ),
+    tool TEXT NOT NULL,
+    provider TEXT,
+    model TEXT,
+    prompt TEXT,
+    resolved_prompt TEXT,
+    provider_artifact_id TEXT,
+    output_artifact_id TEXT,
+    error TEXT,
+    created_at INTEGER NOT NULL,
+    updated_at INTEGER NOT NULL,
+    FOREIGN KEY(notebook_id, cell_id)
+      REFERENCES cells(notebook_id, cell_id) ON DELETE CASCADE
+  );
 
   CREATE INDEX IF NOT EXISTS artifacts_created
     ON artifacts(created_at, artifact_id);
@@ -686,6 +658,8 @@ export const SEMANTIC_SCHEMA_SQL = `
     ON prompt_entries(surface, created_at, prompt_id);
   CREATE INDEX IF NOT EXISTS messages_created
     ON messages(created_at, message_id);
+  CREATE INDEX IF NOT EXISTS generations_cell
+    ON generations(notebook_id, cell_id, created_at);
 `;
 const RUNTIME_SIMILARITY_SCHEMA_SQL = `
   CREATE TABLE IF NOT EXISTS runtime_similarity_embeddings (

package/dist/schema.js.map

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

package/dist/search-provider-access.d.ts

@@ -0,0 +1,11 @@
+import type { SearchProviderConsent, SearchProviderNetworkAccess } from "./engine-types.js";
+interface NetworkProvider {
+    readonly networkAccess?: SearchProviderNetworkAccess;
+}
+export declare function guardSearchProvider<T extends NetworkProvider>(source: T, consent?: SearchProviderConsent, isActive?: () => boolean): {
+    provider: T;
+    validate: () => void;
+    matches: (candidate: T, grant: SearchProviderConsent) => boolean;
+};
+export {};
+//# sourceMappingURL=search-provider-access.d.ts.map

package/dist/search-provider-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-provider-access.d.ts","sourceRoot":"","sources":["../src/search-provider-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAG5F,UAAU,eAAe;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,2BAA2B,CAAC;CACtD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,qBAA0B,EACnC,QAAQ,GAAE,MAAM,OAAoB,GACnC;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAA;CAAE,CAsCzG"}

package/dist/search-provider-access.js

@@ -0,0 +1,42 @@
+import { EngineFault } from "./store.js";
+export function guardSearchProvider(source, consent = {}, isActive = () => true) {
+    const downloads = source.networkAccess?.modelDownloads;
+    const inference = source.networkAccess?.inference;
+    const allowDownloads = consent.modelDownloads === true;
+    const allowInference = consent.inference === true;
+    const validate = () => {
+        if (typeof downloads !== "boolean" || typeof inference !== "boolean") {
+            throw new EngineFault({ code: "INVALID_INPUT", message: "Search provider must declare networkAccess.modelDownloads and networkAccess.inference as booleans" });
+        }
+        if (!isActive()) {
+            throw new EngineFault({ code: "OFFLINE", message: "Search provider registration has been revoked" });
+        }
+        if (source.networkAccess?.modelDownloads !== downloads || source.networkAccess?.inference !== inference) {
+            throw new EngineFault({ code: "INVALID_INPUT", message: "Search provider network declaration changed; register it again with application consent" });
+        }
+        if ((downloads && !allowDownloads) || (inference && !allowInference)) {
+            throw new EngineFault({ code: "OFFLINE", message: "Search provider network access requires application consent" });
+        }
+    };
+    const provider = Object.create(source);
+    for (const method of ["prepare", "embedText", "embedImage", "embedVideo", "embedAudio"]) {
+        const operation = Reflect.get(source, method);
+        if (typeof operation !== "function")
+            continue;
+        Object.defineProperty(provider, method, {
+            value: async (...args) => {
+                validate();
+                return Reflect.apply(operation, source, args);
+            },
+        });
+    }
+    return {
+        provider, validate,
+        matches: (candidate, grant) => candidate === source
+            && candidate.networkAccess?.modelDownloads === downloads
+            && candidate.networkAccess?.inference === inference
+            && (grant.modelDownloads === true) === allowDownloads
+            && (grant.inference === true) === allowInference,
+    };
+}
+//# sourceMappingURL=search-provider-access.js.map

package/dist/search-provider-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-provider-access.js","sourceRoot":"","sources":["../src/search-provider-access.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMzC,MAAM,UAAU,mBAAmB,CACjC,MAAS,EACT,UAAiC,EAAE,EACnC,WAA0B,GAAG,EAAE,CAAC,IAAI;IAEpC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC;IAClD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO,SAAS,KAAK,SAAS,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;YACrE,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,mGAAmG,EAAE,CAAC,CAAC;QACjK,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,EAAE,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;YACxG,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,yFAAyF,EAAE,CAAC,CAAC;QACvJ,CAAC;QACD,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC,CAAC;QACrH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAM,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAU,EAAE,CAAC;QACjG,MAAM,SAAS,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,OAAO,SAAS,KAAK,UAAU;YAAE,SAAS;QAC9C,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE;YACtC,KAAK,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBAClC,QAAQ,EAAE,CAAC;gBACX,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAY,CAAC;YAC3D,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,MAAM;eAC9C,SAAS,CAAC,aAAa,EAAE,cAAc,KAAK,SAAS;eACrD,SAAS,CAAC,aAAa,EAAE,SAAS,KAAK,SAAS;eAChD,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC,KAAK,cAAc;eAClD,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,cAAc;KACnD,CAAC;AACJ,CAAC"}

package/dist/similarity.d.ts

@@ -1,4 +1,63 @@
-import { type SimilarityApi } from "./engine-types.js";
+import type { MediaOperationOptions } from "./engine-types.js";
+import { type SimilarityApi, type SimilarityAudioConfig, type SimilarityAudioEmbeddingProvider, type SimilarityConfig, type SimilarityEmbeddingProvider, type SimilarityTextChunk, type SimilarityTextConfig, type SimilarityTextEmbeddingProvider } from "./engine-types.js";
 import { EngineContext } from "./context.js";
+import type { ModelWorkerConfiguration } from "./model-worker-protocol.js";
 export declare function createSimilarityApi(context: EngineContext): SimilarityApi;
+export declare function createInlineSimilarityProvider(configuration: ModelWorkerConfiguration): LocalClipProvider | LocalClapAudioProvider | LocalTextProvider;
+declare class LocalClipProvider implements SimilarityEmbeddingProvider {
+    private readonly dataDir;
+    private readonly config;
+    get networkAccess(): {
+        modelDownloads: boolean;
+        inference: boolean;
+    };
+    get embeddingSpace(): string;
+    readonly dimensions = 512;
+    private embedder;
+    constructor(dataDir: string, config: SimilarityConfig);
+    prepare(options?: MediaOperationOptions): Promise<void>;
+    embedImage(sourcePath: string, options?: MediaOperationOptions): Promise<Float32Array>;
+    embedVideo(sourcePath: string, options?: MediaOperationOptions): Promise<{
+        vector: Float32Array;
+        frameCount: number;
+    }>;
+    private loadEmbedder;
+    private embedImages;
+}
+declare class LocalClapAudioProvider implements SimilarityAudioEmbeddingProvider {
+    private readonly dataDir;
+    private readonly sharedConfig;
+    private readonly config;
+    get networkAccess(): {
+        modelDownloads: boolean;
+        inference: boolean;
+    };
+    get embeddingSpace(): string;
+    readonly dimensions = 512;
+    private processor;
+    private model;
+    private sampleRate;
+    private maxSamples;
+    constructor(dataDir: string, sharedConfig: SimilarityConfig, config: SimilarityAudioConfig);
+    prepare(options?: MediaOperationOptions): Promise<void>;
+    embedAudio(sourcePath: string, options?: MediaOperationOptions): Promise<Float32Array>;
+    private loadModel;
+}
+declare class LocalTextProvider implements SimilarityTextEmbeddingProvider {
+    private readonly dataDir;
+    private readonly sharedConfig;
+    private readonly config;
+    get networkAccess(): {
+        modelDownloads: boolean;
+        inference: boolean;
+    };
+    get embeddingSpace(): string;
+    readonly dimensions = 384;
+    private embedder;
+    constructor(dataDir: string, sharedConfig: SimilarityConfig, config: SimilarityTextConfig);
+    prepare(options?: MediaOperationOptions): Promise<void>;
+    embedText(text: string, options?: MediaOperationOptions): Promise<SimilarityTextChunk[]>;
+    private loadEmbedder;
+}
+export {};
 //# sourceMappingURL=similarity.d.ts.map

package/dist/similarity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAoBA,OAAO,EAKL,KAAK,aAAa,EAiBnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EAKd,MAAM,cAAc,CAAC;AAyJtB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE"}
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAShC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EAErC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EAKd,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAgK3E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE;AA6vCD,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,wBAAwB,kEAOrF;AAED,cAAM,iBAAkB,YAAW,2BAA2B;IAO1D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,IAAI,aAAa;;;MAA4F;IAC7G,IAAI,cAAc,WAAuE;IACzF,QAAQ,CAAC,UAAU,OAAsB;IACzC,OAAO,CAAC,QAAQ,CAAgC;gBAG7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB;IAGrC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,YAAY,CAAC;IAO1F,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC;QACjF,MAAM,EAAE,YAAY,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;YA4CY,YAAY;YA2BZ,WAAW;CAkB1B;AAED,cAAM,sBAAuB,YAAW,gCAAgC;IAUpE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,IAAI,aAAa;;;MAAsI;IACvJ,IAAI,cAAc,WAAuE;IACzF,QAAQ,CAAC,UAAU,OAA4B;IAC/C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,UAAU,CAA6B;gBAG5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,qBAAqB;IAG1C,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,YAAY,CAAC;YA2BlF,SAAS;CAoDxB;AAED,cAAM,iBAAkB,YAAW,+BAA+B;IAO9D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,IAAI,aAAa;;;MAAsI;IACvJ,IAAI,cAAc,WAAuE;IACzF,QAAQ,CAAC,UAAU,OAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAoC;gBAGjC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,oBAAoB;IAGzC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;YA6BpF,YAAY;CA2B3B"}