@lumenflow/core 3.2.0 → 3.2.2

package/dist/wu-git-constants.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Git Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains git branch names, remotes, refs, flags, commands, and display constants.
+ *
+ * @module wu-git-constants
+ */
+/**
+ * Git branch names
+ */
+export declare const BRANCHES: {
+    MAIN: string;
+    MASTER: string;
+    /** Temporary branch prefix for micro-worktree operations */
+    TEMP_PREFIX: string;
+};
+/**
+ * Git remote names
+ *
+ * WU-1302: Centralized to eliminate hardcoded 'origin' strings
+ */
+export declare const REMOTES: {
+    ORIGIN: string;
+};
+/**
+ * Git ref construction helpers
+ *
+ * Centralized to eliminate hardcoded 'origin/main' strings
+ */
+export declare const GIT_REFS: {
+    /** Construct remote ref like 'origin/main' */
+    remote: (remoteName: string, branchName: string) => string;
+    /** Shortcut for origin/main */
+    ORIGIN_MAIN: string;
+    /** Current HEAD ref */
+    HEAD: string;
+    /** Upstream ref */
+    UPSTREAM: string;
+    /** Range of upstream..HEAD */
+    UPSTREAM_RANGE: string;
+    /** Fetch head ref */
+    FETCH_HEAD: string;
+};
+/**
+ * Git display constants
+ *
+ * Emergency fix (Session 2): Centralized from hardcoded magic numbers
+ * Used for display truncation of SHAs and session IDs
+ */
+export declare const GIT: {
+    /** Standard length for displaying short SHA hashes (e.g., "abc12345") */
+    SHA_SHORT_LENGTH: number;
+    /** Max number of commits to inspect in git log lookbacks */
+    LOG_MAX_COUNT: number;
+};
+/**
+ * Real git executable path - MUST bypass tools/shims to prevent recursion.
+ *
+ * CRITICAL: The git shim (tools/shims/git) calls functions that need to run git
+ * commands. If those functions use 'git' (which resolves to the shim), we get
+ * infinite recursion: shim -> helper -> git -> shim -> helper -> git -> ...
+ *
+ * With VS Code extensions making dozens of git calls per second, this causes
+ * memory exhaustion within seconds -> OOM crash -> system reboot.
+ *
+ * P0 incident: 2025-12-10 server crash due to recursive fork bomb.
+ *
+ * @see tools/shims/git - The git shim that blocks destructive commands
+ * @see tools/lib/wu-helpers.ts - Uses REAL_GIT to avoid recursion
+ */
+export declare const REAL_GIT = "/usr/bin/git";
+/**
+ * Git command flags
+ *
+ * Centralized git flag constants to eliminate hardcoded strings.
+ * Used by git-adapter.ts and other git operation utilities.
+ */
+export declare const GIT_FLAGS: {
+    /** Show abbreviated ref names (for branch name resolution) */
+    ABBREV_REF: string;
+    /** Porcelain format (machine-readable output) */
+    PORCELAIN: string;
+    /** Create new branch and switch to it */
+    BRANCH: string;
+    /** Force flag (long form) */
+    FORCE: string;
+    /** Force flag (short form) */
+    FORCE_SHORT: string;
+    /** Fast-forward only merge */
+    FF_ONLY: string;
+    /** Rebase local commits on top of fetched branch */
+    REBASE: string;
+    /** Check ancestry without output (merge-base) */
+    IS_ANCESTOR: string;
+    /** Write merged tree object and return conflict status code */
+    WRITE_TREE: string;
+    /** Set upstream tracking */
+    UPSTREAM: string;
+    /** Delete branch (safe - only if merged) */
+    DELETE: string;
+    /** Delete branch (force - even if not merged) */
+    DELETE_FORCE: string;
+    /** Delete remote branch flag (for git push --delete) */
+    DELETE_REMOTE: string;
+    /** Hard reset flag */
+    HARD: string;
+    /** Soft reset flag */
+    SOFT: string;
+    /** fd flags for clean (force delete directories) */
+    FD_SHORT: string;
+    /** df flags for clean (delete force directories) */
+    DF_SHORT: string;
+    /** No verify flag (skip pre-commit/commit-msg hooks) */
+    NO_VERIFY: string;
+    /** No GPG sign flag (skip commit signing) */
+    NO_GPG_SIGN: string;
+    /** One-line log format */
+    ONELINE: string;
+    /** List heads only (for ls-remote) */
+    HEADS: string;
+    /** Path separator (separates git options from file paths) */
+    PATH_SEPARATOR: string;
+};
+/**
+ * Git commands
+ *
+ * Centralized git command strings to eliminate hardcoded strings.
+ * Used for direct git command execution via execSync/execa.
+ */
+export declare const GIT_COMMANDS: {
+    /** Git binary */
+    GIT: string;
+    /** Git reset command */
+    RESET: string;
+    /** List tree objects (check file existence on branch) */
+    LS_TREE: string;
+    /** List remote references */
+    LS_REMOTE: string;
+    /** Push command */
+    PUSH: string;
+    /** Pull command */
+    PULL: string;
+    /** Git diff command */
+    DIFF: string;
+    /** Git log command */
+    LOG: string;
+    /** Git merge-base command */
+    MERGE_BASE: string;
+    /** Git merge-tree command */
+    MERGE_TREE: string;
+    /** Git rev-parse command */
+    REV_PARSE: string;
+    /** Git diff flags */
+    CACHED: string;
+    NAME_ONLY: string;
+    DIFF_FILTER_ACM: string;
+};
+/**
+ * Git command combinations
+ *
+ * Full git command strings for common operations.
+ */
+export declare const GIT_COMMAND_STRINGS: {
+    /** Get diff of cached (staged) files */
+    DIFF_CACHED: string;
+    /** Get names of cached files */
+    DIFF_CACHED_NAMES: string;
+    /** Get names of cached files (added, copied, modified) */
+    DIFF_CACHED_ACM: string;
+    /** Get cached diff with zero context (used for hook validation) */
+    DIFF_CACHED_UNIFIED_ZERO: string;
+    /** Get current branch name */
+    REV_PARSE_ABBREV_REF_HEAD: string;
+};
+//# sourceMappingURL=wu-git-constants.d.ts.map

package/dist/wu-git-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-git-constants.d.ts","sourceRoot":"","sources":["../src/wu-git-constants.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;;IAGnB,4DAA4D;;CAE7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO;;CAEnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACnB,8CAA8C;yBACzB,MAAM,cAAc,MAAM;IAC/C,+BAA+B;;IAE/B,uBAAuB;;IAEvB,mBAAmB;;IAEnB,8BAA8B;;IAE9B,qBAAqB;;CAEtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,GAAG;IACd,yEAAyE;;IAEzE,4DAA4D;;CAE7D,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IACpB,8DAA8D;;IAG9D,iDAAiD;;IAGjD,yCAAyC;;IAGzC,6BAA6B;;IAG7B,8BAA8B;;IAG9B,8BAA8B;;IAG9B,oDAAoD;;IAGpD,iDAAiD;;IAGjD,+DAA+D;;IAG/D,4BAA4B;;IAG5B,4CAA4C;;IAG5C,iDAAiD;;IAGjD,wDAAwD;;IAGxD,sBAAsB;;IAGtB,sBAAsB;;IAGtB,oDAAoD;;IAGpD,oDAAoD;;IAGpD,wDAAwD;;IAGxD,6CAA6C;;IAG7C,0BAA0B;;IAG1B,sCAAsC;;IAGtC,6DAA6D;;CAE9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY;IACvB,iBAAiB;;IAGjB,wBAAwB;;IAGxB,yDAAyD;;IAGzD,6BAA6B;;IAG7B,mBAAmB;;IAGnB,mBAAmB;;IAGnB,uBAAuB;;IAGvB,sBAAsB;;IAGtB,6BAA6B;;IAG7B,6BAA6B;;IAG7B,4BAA4B;;IAG5B,qBAAqB;;;;CAItB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;IAC9B,wCAAwC;;IAGxC,gCAAgC;;IAGhC,0DAA0D;;IAG1D,mEAAmE;;IAGnE,8BAA8B;;CAE/B,CAAC"}

package/dist/wu-git-constants.js

@@ -0,0 +1,178 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Git Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains git branch names, remotes, refs, flags, commands, and display constants.
+ *
+ * @module wu-git-constants
+ */
+/**
+ * Git branch names
+ */
+export const BRANCHES = {
+    MAIN: 'main',
+    MASTER: 'master', // Legacy default branch name (defensive check)
+    /** Temporary branch prefix for micro-worktree operations */
+    TEMP_PREFIX: 'tmp/',
+};
+/**
+ * Git remote names
+ *
+ * WU-1302: Centralized to eliminate hardcoded 'origin' strings
+ */
+export const REMOTES = {
+    ORIGIN: 'origin',
+};
+/**
+ * Git ref construction helpers
+ *
+ * Centralized to eliminate hardcoded 'origin/main' strings
+ */
+export const GIT_REFS = {
+    /** Construct remote ref like 'origin/main' */
+    remote: (remoteName, branchName) => `${remoteName}/${branchName}`,
+    /** Shortcut for origin/main */
+    ORIGIN_MAIN: 'origin/main',
+    /** Current HEAD ref */
+    HEAD: 'HEAD',
+    /** Upstream ref */
+    UPSTREAM: '@{u}',
+    /** Range of upstream..HEAD */
+    UPSTREAM_RANGE: '@{u}..HEAD',
+    /** Fetch head ref */
+    FETCH_HEAD: 'FETCH_HEAD',
+};
+/**
+ * Git display constants
+ *
+ * Emergency fix (Session 2): Centralized from hardcoded magic numbers
+ * Used for display truncation of SHAs and session IDs
+ */
+export const GIT = {
+    /** Standard length for displaying short SHA hashes (e.g., "abc12345") */
+    SHA_SHORT_LENGTH: 8,
+    /** Max number of commits to inspect in git log lookbacks */
+    LOG_MAX_COUNT: 50,
+};
+/**
+ * Real git executable path - MUST bypass tools/shims to prevent recursion.
+ *
+ * CRITICAL: The git shim (tools/shims/git) calls functions that need to run git
+ * commands. If those functions use 'git' (which resolves to the shim), we get
+ * infinite recursion: shim -> helper -> git -> shim -> helper -> git -> ...
+ *
+ * With VS Code extensions making dozens of git calls per second, this causes
+ * memory exhaustion within seconds -> OOM crash -> system reboot.
+ *
+ * P0 incident: 2025-12-10 server crash due to recursive fork bomb.
+ *
+ * @see tools/shims/git - The git shim that blocks destructive commands
+ * @see tools/lib/wu-helpers.ts - Uses REAL_GIT to avoid recursion
+ */
+export const REAL_GIT = '/usr/bin/git';
+/**
+ * Git command flags
+ *
+ * Centralized git flag constants to eliminate hardcoded strings.
+ * Used by git-adapter.ts and other git operation utilities.
+ */
+export const GIT_FLAGS = {
+    /** Show abbreviated ref names (for branch name resolution) */
+    ABBREV_REF: '--abbrev-ref',
+    /** Porcelain format (machine-readable output) */
+    PORCELAIN: '--porcelain',
+    /** Create new branch and switch to it */
+    BRANCH: '-b',
+    /** Force flag (long form) */
+    FORCE: '--force',
+    /** Force flag (short form) */
+    FORCE_SHORT: '-f',
+    /** Fast-forward only merge */
+    FF_ONLY: '--ff-only',
+    /** Rebase local commits on top of fetched branch */
+    REBASE: '--rebase',
+    /** Check ancestry without output (merge-base) */
+    IS_ANCESTOR: '--is-ancestor',
+    /** Write merged tree object and return conflict status code */
+    WRITE_TREE: '--write-tree',
+    /** Set upstream tracking */
+    UPSTREAM: '-u',
+    /** Delete branch (safe - only if merged) */
+    DELETE: '-d',
+    /** Delete branch (force - even if not merged) */
+    DELETE_FORCE: '-D',
+    /** Delete remote branch flag (for git push --delete) */
+    DELETE_REMOTE: '--delete',
+    /** Hard reset flag */
+    HARD: '--hard',
+    /** Soft reset flag */
+    SOFT: '--soft',
+    /** fd flags for clean (force delete directories) */
+    FD_SHORT: '-fd',
+    /** df flags for clean (delete force directories) */
+    DF_SHORT: '-df',
+    /** No verify flag (skip pre-commit/commit-msg hooks) */
+    NO_VERIFY: '--no-verify',
+    /** No GPG sign flag (skip commit signing) */
+    NO_GPG_SIGN: '--no-gpg-sign',
+    /** One-line log format */
+    ONELINE: '--oneline',
+    /** List heads only (for ls-remote) */
+    HEADS: '--heads',
+    /** Path separator (separates git options from file paths) */
+    PATH_SEPARATOR: '--',
+};
+/**
+ * Git commands
+ *
+ * Centralized git command strings to eliminate hardcoded strings.
+ * Used for direct git command execution via execSync/execa.
+ */
+export const GIT_COMMANDS = {
+    /** Git binary */
+    GIT: 'git',
+    /** Git reset command */
+    RESET: 'reset',
+    /** List tree objects (check file existence on branch) */
+    LS_TREE: 'ls-tree',
+    /** List remote references */
+    LS_REMOTE: 'ls-remote',
+    /** Push command */
+    PUSH: 'push',
+    /** Pull command */
+    PULL: 'pull',
+    /** Git diff command */
+    DIFF: 'diff',
+    /** Git log command */
+    LOG: 'log',
+    /** Git merge-base command */
+    MERGE_BASE: 'merge-base',
+    /** Git merge-tree command */
+    MERGE_TREE: 'merge-tree',
+    /** Git rev-parse command */
+    REV_PARSE: 'rev-parse',
+    /** Git diff flags */
+    CACHED: '--cached',
+    NAME_ONLY: '--name-only',
+    DIFF_FILTER_ACM: '--diff-filter=ACM',
+};
+/**
+ * Git command combinations
+ *
+ * Full git command strings for common operations.
+ */
+export const GIT_COMMAND_STRINGS = {
+    /** Get diff of cached (staged) files */
+    DIFF_CACHED: 'git diff --cached',
+    /** Get names of cached files */
+    DIFF_CACHED_NAMES: 'git diff --cached --name-only',
+    /** Get names of cached files (added, copied, modified) */
+    DIFF_CACHED_ACM: 'git diff --cached --name-only --diff-filter=ACM',
+    /** Get cached diff with zero context (used for hook validation) */
+    DIFF_CACHED_UNIFIED_ZERO: 'git diff --cached -U0',
+    /** Get current branch name */
+    REV_PARSE_ABBREV_REF_HEAD: 'git rev-parse --abbrev-ref HEAD',
+};
+//# sourceMappingURL=wu-git-constants.js.map

package/dist/wu-git-constants.js.map

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

package/dist/wu-helpers.d.ts

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * WU Helpers - Shared utilities for worktree and WU validation hooks
+ *
+ * Used by:
+ * - .husky/prepare-commit-msg
+ * - .husky/pre-commit
+ * - .husky/pre-push
+ */
+import { type ExecSyncOptionsWithStringEncoding } from 'node:child_process';
+import type { IBranchValidationResult, IWuGitAdapter, IWuStatusCheckResult } from './ports/wu-helpers.ports.js';
+interface ParsedWUYaml {
+    status?: string;
+    [key: string]: unknown;
+}
+type EnsureOnMainGitAdapter = Pick<IWuGitAdapter, 'getCurrentBranch'>;
+type EnsureMainUpToDateGitAdapter = Pick<IWuGitAdapter, 'fetch' | 'getCommitHash'>;
+type RunOptions = Omit<ExecSyncOptionsWithStringEncoding, 'encoding'>;
+/**
+ * Validate WU ID format
+ *
+ * WU-1593: Extracted from duplicate implementations in wu-create.ts and wu-edit.ts (DRY).
+ * Uses centralized PATTERNS.WU_ID regex from wu-constants.ts.
+ *
+ * @param {string} id - WU ID to validate (e.g., 'WU-123')
+ * @throws {Error} If ID format is invalid
+ *
+ * @example
+ * validateWUIDFormat('WU-123'); // OK
+ * validateWUIDFormat('wu-123'); // throws Error
+ * validateWUIDFormat('TICKET-123'); // throws Error
+ */
+export declare function validateWUIDFormat(id: string): void;
+/**
+ * Execute a shell command and return the output
+ * @param {string} cmd - Command to execute
+ * @param {object} opts - Execution options
+ * @returns {string} Command output
+ */
+export declare function run(cmd: string, opts?: RunOptions): string;
+/**
+ * Get the current Git branch name
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @returns {string|null} Branch name or null if not in a git repo
+ */
+export declare function getCurrentBranch(): string | null;
+/**
+ * Get the current working directory relative to repo root
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @returns {string} Current directory path
+ */
+export declare function getCurrentDir(): string;
+/**
+ * Check if we're in the main worktree (not a lane worktree)
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @returns {boolean} True if in main worktree
+ */
+export declare function isMainWorktree(): boolean;
+/**
+ * Extract WU ID from branch name
+ * Expected format: lane/<lane-name>/<wu-id>
+ * @param {string} branch - Branch name
+ * @returns {string|null} WU ID (e.g., 'WU-401') or null
+ */
+export declare function extractWUFromBranch(branch: string | null | undefined): string | null;
+/**
+ * Validate branch name follows lane convention
+ * Expected: lane/<lane-name>/<wu-id>
+ * @param {string} branch - Branch name to validate
+ * @returns {{valid: boolean, lane: string|null, wuid: string|null, error: string|null}}
+ */
+export declare function validateBranchName(branch: string | null | undefined): IBranchValidationResult;
+/**
+ * Read WU YAML file and return parsed content
+ * Uses REAL_GIT to bypass shim and prevent recursion.
+ * @param {string} wuid - WU ID (e.g., 'WU-401')
+ * @returns {object|null} Parsed WU YAML or null if not found
+ */
+export declare function readWUYaml(wuid: string): ParsedWUYaml | null;
+/**
+ * Check if WU status allows the operation
+ * @param {string} wuid - WU ID
+ * @param {string[]} allowedStatuses - List of allowed statuses
+ * @returns {{allowed: boolean, status: string|null, error: string|null}}
+ */
+export declare function checkWUStatus(wuid: string, allowedStatuses?: string[]): IWuStatusCheckResult;
+/**
+ * Format an error message for hook output
+ * @param {string} hookName - Name of the hook
+ * @param {string} message - Error message
+ * @returns {string} Formatted error message
+ */
+export declare function formatHookError(hookName: string, message: string): string;
+/**
+ * Extract WU ID from commit message
+ * Supports formats:
+ * - wu(WU-401): message
+ * - chore(wu-401): message
+ * - feat(wu-401): message
+ * @param {string} message - Commit message
+ * @returns {string|null} WU ID or null
+ */
+export declare function extractWUFromCommitMessage(message: string | null | undefined): string | null;
+/**
+ * Ensure current branch is main. Throws if not.
+ *
+ * Centralized from duplicated ensureOnMain() functions across wu-* scripts (WU-1256).
+ * Async version - accepts a git adapter with async getCurrentBranch() method.
+ *
+ * WU-1091: Agent branches (claude/*, codex/*, copilot/*, cursor/*, agent/*) bypass
+ * the main branch requirement for web agent commands. Lane branches still require
+ * worktree workflow (no bypass). Protected branches (main/master) remain protected.
+ *
+ * @param {object} git - Git adapter with async getCurrentBranch() method
+ * @throws {Error} If not on main branch and not an agent branch
+ */
+export declare function ensureOnMain(git: EnsureOnMainGitAdapter): Promise<void>;
+/**
+ * Ensure main branch is up to date with origin.
+ *
+ * Centralized from duplicated ensureMainUpToDate() functions across wu-* scripts (WU-1256).
+ *
+ * @param {object} git - Git adapter with async fetch() and getCommitHash() methods
+ * @param {string} [scriptName='wu'] - Script name for logging
+ * @param {object} [options] - Options
+ * @param {boolean} [options.skipRemote=false] - WU-1653: Skip remote check (requireRemote=false)
+ * @throws {Error} If main is out of sync with origin
+ */
+export declare function ensureMainUpToDate(git: EnsureMainUpToDateGitAdapter, _scriptName?: string, { skipRemote }?: {
+    skipRemote?: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=wu-helpers.d.ts.map

package/dist/wu-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-helpers.d.ts","sourceRoot":"","sources":["../src/wu-helpers.ts"],"names":[],"mappings":";AAGA;;;;;;;GAOG;AAEH,OAAO,EAAY,KAAK,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAOtF,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,sBAAsB,GAAG,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AACtE,KAAK,4BAA4B,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC;AACnF,KAAK,UAAU,GAAG,IAAI,CAAC,iCAAiC,EAAE,UAAU,CAAC,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAInD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,kBAE/B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,WAK5B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,YAM7B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,uBAAuB,CAuB7F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAM,EAA+B,GACrD,oBAAoB,CA4BtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAiB5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,4BAA4B,EACjC,WAAW,SAAO,EAClB,EAAE,UAAkB,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACpD,OAAO,CAAC,IAAI,CAAC,CAUf"}