@alloy-js/core 0.23.0-dev.1 → 0.23.0-dev.11

package/dist/src/devtools/devtools-protocol.d.ts

@@ -0,0 +1,389 @@
+/**
+ * Alloy Devtools Protocol
+ * =======================
+ *
+ * Communication protocol between the Alloy debug runtime (core) and the
+ * devtools UI client, transported over WebSocket.
+ *
+ * Message shapes are flat snake_case objects that mirror the SQLite trace-writer
+ * row shapes so no format translation is needed on the wire.
+ *
+ * ─── IDs ─────────────────────────────────────────────────────────────────────
+ *
+ * All entity IDs (effects, refs, reactive-property refs, non-ref targets)
+ * are positive monotonically increasing integers drawn from their respective
+ * counters. Ref IDs and reactive-property IDs share a single counter so
+ * they never collide. There are no negative or sentinel IDs.
+ *
+ * ─── Effects ─────────────────────────────────────────────────────────────────
+ *
+ * An effect is any reactive computation tracked by Alloy's reactivity system.
+ *
+ *   name        Human-readable label. Format varies:
+ *                 "render:ComponentName"         — render effect for a component
+ *                 "memo:For"                     — memo inside a For component
+ *                 "memo:props.children"          — memo from JSX expression
+ *                 "binder:notifySymbolCreated"   — binder infrastructure
+ *                 "myCallback"                   — user effect from fn.name
+ *               For memos created by JSX expression tracking, the babel plugin
+ *               generates a description of the expression (e.g. "props.foo").
+ *
+ *   effect_type Optional effect category string. Set by framework code via
+ *               the debug options on effect(). Values include "render",
+ *               "content", "context", "resource", "binder", "list", "symbol",
+ *               "collection", etc. null when no category was assigned (common
+ *               for memos and user-created effects). Useful for display and
+ *               grouping but NOT used for user-vs-external filtering.
+ *
+ *   source_file / source_line / source_col
+ *               Where the effect was created. Captured via V8 CallSite API
+ *               with source map resolution (when --enable-source-maps is
+ *               active). Points at the component or user code that called
+ *               effect()/memo(), not the reactivity internals. May be null
+ *               if the entire call stack is framework-internal.
+ *
+ *   "User only" filtering:
+ *     Based purely on source_file. An effect is "user code" when its
+ *     source_file resolves to a path OUTSIDE node_modules (i.e. inside the
+ *     user's project). Effects whose source_file is inside node_modules
+ *     (including @alloy-js/* and any third-party library packages) or is
+ *     null are "external" effects. The effect type and name are never used
+ *     for this classification.
+ *
+ * ─── Refs ────────────────────────────────────────────────────────────────────
+ *
+ * A ref is any individually tracked reactive value. There are several kinds:
+ *
+ *   kind="ref"                  Created by alloy's ref() wrapper.
+ *   kind="shallowRef"          Created by alloy's shallowRef() wrapper.
+ *   kind="computed"             Created by alloy's computed() wrapper.
+ *   kind="reactive-property"   A property of a reactive object, lazily
+ *                               registered on first track/trigger. Each
+ *                               (target, key) pair gets its own ref entry.
+ *
+ * Alloy wraps shallowReactive() to capture creation locations. Objects
+ * created via alloy's shallowReactive() wrapper have their creation site
+ * stored in a WeakMap. When a reactive-property ref is registered for such
+ * an object, the property ref inherits the shallowReactive() creation
+ * location. For objects using manual reactivity (e.g. OutputSymbol, which
+ * calls Vue's track()/trigger() directly on `this` rather than going through
+ * alloy's shallowReactive wrapper), the creation site is unknown and the
+ * first track/trigger site is used instead (flagged with is_approx_location).
+ *
+ *   label       Optional human-readable name. Takes priority over kind for
+ *               display. Examples:
+ *                 "memo:For"                        — memo's internal ref
+ *                 "TSOutputSymbol \"Foo\".name"     — reactive property
+ *               When displaying, prefer: label ?? kind. The numeric ID is
+ *               always shown separately as a dimmed suffix, never as part
+ *               of the label text.
+ *
+ *   is_infrastructure
+ *               Boolean. True for refs created by framework internals that
+ *               are implementation details (context.isEmpty, mapJoin index/
+ *               joiner counters, devtools rerender tokens). These are not
+ *               meaningful to end users and are always excluded in
+ *               "user only" mode.
+ *
+ *   is_approx_location
+ *               Boolean. True when the source location was inferred from
+ *               first usage rather than the actual creation site. Applies
+ *               to reactive-property refs whose parent object was not
+ *               created via alloy's shallowReactive() wrapper (e.g.
+ *               OutputSymbol class instances with manual track/trigger).
+ *               The UI should show a subtle indicator (e.g. a small muted
+ *               icon with a tooltip), not a prominent warning.
+ *
+ *   source_file / source_line / source_col
+ *               Where the ref was created. For reactive-property refs from
+ *               shallowReactive() objects, this is the shallowReactive()
+ *               call site. For reactive-property refs from manual-reactivity
+ *               objects, this is the first track site (is_approx_location=1).
+ *               For regular refs/shallowRefs/computed, this is the call site
+ *               with framework-internal stack frames skipped.
+ *
+ *   "User only" filtering:
+ *     A ref is "user code" when is_infrastructure is false AND source_file
+ *     resolves to a path outside node_modules. Infrastructure refs are
+ *     always excluded in user-only mode regardless of source location.
+ *
+ * ─── Edges ───────────────────────────────────────────────────────────────────
+ *
+ * Edges connect effects to refs via track/trigger relationships.
+ * ref_id points to a registered ref. target_id/target_key provide the
+ * raw reactive target info. For ref-backed edges, ref_id == target_id.
+ *
+ * ─── Source Location Resolution ──────────────────────────────────────────────
+ *
+ * Captured at entity creation time via V8's structured CallSite API.
+ * Framework-internal frames (reactivity engine, renderer, scheduler, debug
+ * infra) are skipped so the location points at the component or user code.
+ *
+ * When --enable-source-maps is active, paths and line numbers are resolved
+ * through source maps (.js → .ts). The server reports sourceMapEnabled in
+ * its handshake. Note: pnpm symlinks require realpathSync before
+ * findSourceMap lookup (Node's cache is keyed by real paths).
+ */
+import type { SourceLocation } from "../debug/effects.js";
+export type { SourceLocation };
+export interface DiagnosticRow {
+    message: string;
+    severity?: string;
+    source_file?: string;
+    source_line?: number;
+    source_col?: number;
+    component_stack?: string;
+}
+/** @deprecated Use flat fields on RenderNodeAddedMessage instead. */
+export interface RenderTreeNode {
+    id: number;
+    kind: string;
+    name?: string;
+    propsSerialized?: string;
+    value?: string;
+    source?: SourceLocation;
+}
+/** @deprecated Use flat fields on RenderErrorMessage instead. */
+export interface RenderErrorStackEntry {
+    name: string;
+    propsSerialized?: string;
+    renderNodeId?: number;
+    source?: SourceLocation;
+}
+export interface DebuggerInfoMessage {
+    type: "debugger:info";
+    version: string;
+    cwd?: string;
+    sourceMapEnabled: boolean;
+}
+export interface RenderResetMessage {
+    type: "render:reset";
+}
+export interface RenderNodeAddedMessage {
+    type: "render:node_added";
+    id: number;
+    parent_id: number | null;
+    kind: string;
+    name?: string;
+    props?: string;
+    value?: string;
+    source_file?: string;
+    source_line?: number;
+    source_col?: number;
+    context_id?: number | null;
+    seq: number;
+}
+export interface RenderNodeUpdatedMessage {
+    type: "render:node_updated";
+    id: number;
+    props?: string;
+}
+export interface RenderNodeRemovedMessage {
+    type: "render:node_removed";
+    id: number;
+}
+export interface RenderErrorMessage {
+    type: "render:error";
+    name?: string;
+    message?: string;
+    stack?: string;
+    component_stack?: string;
+    seq: number;
+}
+export interface RenderCompleteMessage {
+    type: "render:complete";
+}
+export interface FlushJobsCompleteMessage {
+    type: "flush:complete";
+}
+export interface EffectAddedMessage {
+    type: "effect:added";
+    id: number;
+    name?: string;
+    effect_type?: string;
+    context_id?: number | null;
+    owner_context_id?: number | null;
+    component?: string;
+    source_file?: string;
+    source_line?: number;
+    source_col?: number;
+    source_package?: string;
+    is_infrastructure?: number;
+    seq: number;
+}
+export interface EffectUpdatedMessage {
+    type: "effect:updated";
+    id: number;
+    name?: string;
+    effect_type?: string;
+    context_id?: number | null;
+    owner_context_id?: number | null;
+    component?: string;
+    source_file?: string;
+    source_line?: number;
+    source_col?: number;
+    source_package?: string;
+    is_infrastructure?: number;
+    seq: number;
+}
+export interface RefAddedMessage {
+    type: "ref:added";
+    id: number;
+    kind?: string;
+    label?: string;
+    created_by_effect_id?: number;
+    source_file?: string;
+    source_line?: number;
+    source_col?: number;
+    source_package?: string;
+    is_approx_location?: number;
+    seq: number;
+}
+export interface EffectTrackMessage {
+    type: "edge:track";
+    seq: number;
+    effect_id: number;
+    ref_id?: number;
+    target_id?: number;
+    target_kind?: string;
+    target_label?: string;
+    target_key?: string;
+}
+export interface EffectTriggerMessage {
+    type: "edge:trigger";
+    seq: number;
+    effect_id: number;
+    caused_by?: number;
+    ref_id?: number;
+    target_id?: number;
+    target_kind?: string;
+    target_label?: string;
+    target_key?: string;
+}
+export interface EffectEdgeUpdatedMessage {
+    type: "edge:updated";
+    seq: number;
+    effect_id: number;
+    caused_by?: number;
+    ref_id?: number;
+    target_id?: number;
+    target_kind?: string;
+    target_label?: string;
+    target_key?: string;
+}
+export interface EffectLifecycleMessage {
+    type: "effect:lifecycle";
+    seq: number;
+    effect_id: number;
+    event: string;
+    trigger_ref_id?: number;
+}
+export interface ScopeAddedMessage {
+    type: "scope:added";
+    id: number;
+    name: string;
+    parent_id?: number | null;
+    owner_symbol_id?: number | null;
+    render_node_id?: number | null;
+    is_member_scope?: number;
+    is_transient?: number;
+    metadata?: string;
+    seq: number;
+}
+export interface ScopeUpdatedMessage {
+    type: "scope:updated";
+    id: number;
+    name: string;
+    parent_id?: number | null;
+    owner_symbol_id?: number | null;
+    render_node_id?: number | null;
+    is_member_scope?: number;
+    is_transient?: number;
+    metadata?: string;
+    seq: number;
+}
+export interface ScopeRemovedMessage {
+    type: "scope:removed";
+    id: number;
+}
+export interface SymbolAddedMessage {
+    type: "symbol:added";
+    id: number;
+    name: string;
+    original_name?: string;
+    scope_id?: number | null;
+    owner_symbol_id?: number | null;
+    render_node_id?: number | null;
+    is_member?: number;
+    is_transient?: number;
+    is_alias?: number;
+    moved_to_id?: number | null;
+    metadata?: string;
+    seq: number;
+}
+export interface SymbolUpdatedMessage {
+    type: "symbol:updated";
+    id: number;
+    name: string;
+    original_name?: string;
+    scope_id?: number | null;
+    owner_symbol_id?: number | null;
+    render_node_id?: number | null;
+    is_member?: number;
+    is_transient?: number;
+    is_alias?: number;
+    moved_to_id?: number | null;
+    metadata?: string;
+    seq: number;
+}
+export interface SymbolRemovedMessage {
+    type: "symbol:removed";
+    id: number;
+}
+export interface FileAddedMessage {
+    type: "file:added";
+    path: string;
+    filetype?: string;
+    render_node_id?: number;
+    seq: number;
+}
+export interface FileUpdatedMessage {
+    type: "file:updated";
+    path: string;
+    content?: string;
+}
+export interface FileRemovedMessage {
+    type: "file:removed";
+    path: string;
+}
+export interface DirectoryAddedMessage {
+    type: "directory:added";
+    path: string;
+}
+export interface DirectoryRemovedMessage {
+    type: "directory:removed";
+    path: string;
+}
+export interface DiagnosticsReportMessage {
+    type: "diagnostics:report";
+    diagnostics: DiagnosticRow[];
+}
+export type ServerToClientMessage = DebuggerInfoMessage | RenderResetMessage | RenderNodeAddedMessage | RenderNodeUpdatedMessage | RenderNodeRemovedMessage | RenderErrorMessage | RenderCompleteMessage | FlushJobsCompleteMessage | EffectAddedMessage | EffectUpdatedMessage | RefAddedMessage | EffectTrackMessage | EffectTriggerMessage | EffectEdgeUpdatedMessage | EffectLifecycleMessage | ScopeAddedMessage | ScopeUpdatedMessage | ScopeRemovedMessage | SymbolAddedMessage | SymbolUpdatedMessage | SymbolRemovedMessage | FileAddedMessage | FileUpdatedMessage | FileRemovedMessage | DirectoryAddedMessage | DirectoryRemovedMessage | DiagnosticsReportMessage;
+export interface SubscribeMessage {
+    type: "subscribe";
+    channels: string[];
+}
+export interface UnsubscribeMessage {
+    type: "unsubscribe";
+    channels: string[];
+}
+export interface RerenderRequestMessage {
+    type: "render:rerender";
+    id: number;
+}
+export interface RerenderBreakRequestMessage {
+    type: "render:rerenderAndBreak";
+    id: number;
+}
+export type ClientToServerMessage = SubscribeMessage | UnsubscribeMessage | RerenderRequestMessage | RerenderBreakRequestMessage;
+//# sourceMappingURL=devtools-protocol.d.ts.map

package/dist/src/devtools/devtools-protocol.d.ts.map

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

package/dist/src/devtools/devtools-protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=devtools-protocol.js.map

package/dist/src/devtools/devtools-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":[],"sourcesContent":[],"mappings":"","ignoreList":[]}

package/dist/src/devtools/devtools-server.browser.d.ts

@@ -0,0 +1,23 @@
+export interface DevtoolsIncomingMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export interface DevtoolsServerInfo {
+    port: number;
+    connected: boolean;
+}
+export declare function isDevtoolsEnabled(): boolean;
+export declare function waitForDevtoolsConnection(): Promise<void>;
+export interface EnableDevtoolsOptions {
+    port?: number;
+    waitForConnection?: boolean;
+}
+export declare function enableDevtools(_options?: EnableDevtoolsOptions): Promise<void>;
+export declare function initDevtoolsIfEnabled(): Promise<void>;
+export declare function registerDevtoolsMessageHandler(_handler: (message: DevtoolsIncomingMessage) => void): () => void;
+export declare function assertDevtoolsConnectedForSyncRender(): void;
+export declare function isDevtoolsConnected(): boolean;
+export declare function getDevtoolsServerInfo(): DevtoolsServerInfo | null;
+export declare function enableDevtoolsAndConnect(_options?: EnableDevtoolsOptions): Promise<DevtoolsServerInfo | null>;
+export declare function resetDevtoolsServerForTests(): Promise<void>;
+//# sourceMappingURL=devtools-server.browser.d.ts.map

package/dist/src/devtools/devtools-server.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-server.browser.d.ts","sourceRoot":"","sources":["../../../src/devtools/devtools-server.browser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,GACnD,MAAM,IAAI,CAEZ;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjE"}

package/dist/src/devtools/devtools-server.browser.js

@@ -0,0 +1,33 @@
+// Browser stub for devtools-server - devtools are not supported in browsers
+
+export function isDevtoolsEnabled() {
+  return false;
+}
+export async function waitForDevtoolsConnection() {
+  // No-op in browser
+}
+export async function enableDevtools(_options) {
+  // No-op in browser
+}
+export async function initDevtoolsIfEnabled() {
+  // No-op in browser
+}
+export function registerDevtoolsMessageHandler(_handler) {
+  return () => {};
+}
+export function assertDevtoolsConnectedForSyncRender() {
+  // No-op in browser
+}
+export function isDevtoolsConnected() {
+  return false;
+}
+export function getDevtoolsServerInfo() {
+  return null;
+}
+export async function enableDevtoolsAndConnect(_options) {
+  return null;
+}
+export async function resetDevtoolsServerForTests() {
+  // No-op in browser
+}
+//# sourceMappingURL=devtools-server.browser.js.map

package/dist/src/devtools/devtools-server.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isDevtoolsEnabled","waitForDevtoolsConnection","enableDevtools","_options","initDevtoolsIfEnabled","registerDevtoolsMessageHandler","_handler","assertDevtoolsConnectedForSyncRender","isDevtoolsConnected","getDevtoolsServerInfo","enableDevtoolsAndConnect","resetDevtoolsServerForTests"],"sources":["../../../src/devtools/devtools-server.browser.ts"],"sourcesContent":[null],"mappings":"AAAA;;AAYA,OAAO,SAASA,iBAAiBA,CAAA,EAAY;EAC3C,OAAO,KAAK;AACd;AAEA,OAAO,eAAeC,yBAAyBA,CAAA,EAAkB;EAC/D;AAAA;AAQF,OAAO,eAAeC,cAAcA,CAClCC,QAAgC,EACjB;EACf;AAAA;AAGF,OAAO,eAAeC,qBAAqBA,CAAA,EAAkB;EAC3D;AAAA;AAGF,OAAO,SAASC,8BAA8BA,CAC5CC,QAAoD,EACxC;EACZ,OAAO,MAAM,CAAC,CAAC;AACjB;AAEA,OAAO,SAASC,oCAAoCA,CAAA,EAAS;EAC3D;AAAA;AAGF,OAAO,SAASC,mBAAmBA,CAAA,EAAY;EAC7C,OAAO,KAAK;AACd;AAEA,OAAO,SAASC,qBAAqBA,CAAA,EAA8B;EACjE,OAAO,IAAI;AACb;AAEA,OAAO,eAAeC,wBAAwBA,CAC5CP,QAAgC,EACI;EACpC,OAAO,IAAI;AACb;AAEA,OAAO,eAAeQ,2BAA2BA,CAAA,EAAkB;EACjE;AAAA","ignoreList":[]}

package/dist/src/devtools/devtools-server.d.ts

@@ -0,0 +1,66 @@
+export interface DevtoolsIncomingMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export interface DevtoolsServerInfo {
+    port: number;
+    connected: boolean;
+}
+export interface EnableDevtoolsOptions {
+    /** Port to listen on. Use 0 for a random available port. Defaults to ALLOY_DEBUG_PORT or 8123. */
+    port?: number;
+}
+/** Returns true when devtools are enabled (via env var or explicit call). */
+export declare function isDevtoolsEnabled(): boolean;
+/** Returns true when a devtools client is currently connected. */
+export declare function isDevtoolsConnected(): boolean;
+/** Get the current server info, or null if not running. */
+export declare function getDevtoolsServerInfo(): DevtoolsServerInfo | null;
+/**
+ * Wait for a devtools client to connect before proceeding.
+ *
+ * Starts the devtools server if not already running, and blocks until a
+ * devtools client connects via WebSocket.
+ *
+ * @example
+ * ```ts
+ * import { waitForDevtoolsConnection } from "@alloy-js/core/devtools";
+ * import { render } from "@alloy-js/core";
+ *
+ * await waitForDevtoolsConnection();
+ * const tree = render(<MyComponent />);
+ * ```
+ */
+export declare function waitForDevtoolsConnection(): Promise<void>;
+/**
+ * Enable devtools and start the server, returning when the server is ready.
+ * Use this in tests to enable devtools before connecting a client.
+ *
+ * @returns Server info with port number
+ */
+export declare function enableDevtools(options?: EnableDevtoolsOptions): Promise<DevtoolsServerInfo>;
+/**
+ * Initialize devtools if ALLOY_DEBUG is set. Called lazily by render functions.
+ * Returns immediately if devtools are not enabled or already initialized.
+ */
+export declare function initDevtoolsIfEnabled(): Promise<void>;
+/**
+ * Start the devtools server and wait for a client connection.
+ *
+ * @example
+ * ```ts
+ * const serverInfo = await enableDevtoolsAndConnect({ port: 0 });
+ * // ... run your test ...
+ * await resetDevtoolsServerForTests();
+ * ```
+ *
+ * @returns Server info once a client has connected
+ */
+export declare function enableDevtoolsAndConnect(options?: EnableDevtoolsOptions): Promise<DevtoolsServerInfo>;
+/** Register a handler for incoming devtools messages. Returns an unsubscribe function. */
+export declare function registerDevtoolsMessageHandler(handler: (message: DevtoolsIncomingMessage) => void): () => boolean;
+/** Throw if devtools are enabled but no client is connected (for sync render). */
+export declare function assertDevtoolsConnectedForSyncRender(): void;
+/** Reset all devtools state. For use in tests only. */
+export declare function resetDevtoolsServerForTests(): Promise<void>;
+//# sourceMappingURL=devtools-server.d.ts.map

package/dist/src/devtools/devtools-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-server.d.ts","sourceRoot":"","sources":["../../../src/devtools/devtools-server.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAyID,6EAA6E;AAC7E,wBAAgB,iBAAiB,YAGhC;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAGjE;AAwJD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAW/D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAMD,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,iBAIpD;AAED,kFAAkF;AAClF,wBAAgB,oCAAoC,SAOnD;AAMD,uDAAuD;AACvD,wBAAsB,2BAA2B,kBAgBhD"}