gitx.do 0.1.1 → 0.1.3

package/dist/index.js

@@ -1,507 +1,65 @@
 /**
- * @fileoverview gitx.do - Complete Git Implementation for Cloudflare Workers
+ * @fileoverview gitx.do - Git on Cloudflare Durable Objects
  *
- * This is the main entry point for the gitx.do library, providing a complete
- * Git implementation designed to run on Cloudflare Workers with Durable Objects
- * and R2 storage.
- *
- * **Architecture Overview**:
- * - **Types**: Core Git object types (blob, tree, commit, tag)
- * - **Pack Operations**: Packfile format handling and index management
- * - **Git Operations**: Core commands (merge, blame, commit, branch)
- * - **MCP Integration**: Model Context Protocol for AI assistant integration
- * - **Wire Protocol**: Git Smart HTTP protocol implementation
- * - **Storage**: R2 packfile storage and object indexing
- * - **Tiered Storage**: Hot/Warm/Cold storage with migration
+ * This package provides the Cloudflare Workers/Durable Objects integration
+ * for gitx. It depends on @dotdo/gitx for the pure git implementation.
  *
  * @module gitx.do
  *
  * @example
  * ```typescript
- * import {
- *   // Types
- *   type CommitObject,
- *   parseCommit,
- *   serializeCommit,
- *
- *   // Operations
- *   createCommit,
- *   merge,
- *   blame,
- *
- *   // Storage
- *   R2PackStorage,
- *   ObjectIndex,
+ * import { GitRepoDO, GitModule, withGit } from 'gitx.do'
  *
- *   // Wire Protocol
- *   handleInfoRefs,
- *   handleUploadPack,
- * } from 'gitx.do'
+ * // Use GitRepoDO for full repository management
+ * export { GitRepoDO }
  *
- * // Create a commit
- * const commit = await createCommit(storage, {
- *   tree: treeSha,
- *   parents: [parentSha],
- *   message: 'Add new feature',
- *   author: { name: 'Alice', email: 'alice@example.com' }
- * })
- * ```
- */
-// =============================================================================
-// Types - Core Git object types and interfaces
-// =============================================================================
-/**
- * Git object types and serialization.
- *
- * @description
- * Core types for Git objects (blob, tree, commit, tag) including:
- * - Type definitions for each object type
- * - Type guard functions for runtime type checking
- * - Serialization functions for converting to Git format
- * - Deserialization functions for parsing Git format
- *
- * @example
- * ```typescript
- * import { isCommit, parseCommit, serializeCommit } from 'gitx.do'
- *
- * // Parse raw commit data
- * const commit = parseCommit(rawData)
- *
- * // Check type at runtime
- * if (isCommit(obj)) {
- *   console.log(obj.message)
+ * // Or use mixins for custom DOs
+ * class MyDO extends withGit(DurableObject) {
+ *   async doSomething() {
+ *     await this.git.clone('https://github.com/org/repo')
+ *   }
  * }
  * ```
  */
-export { 
-// Type guards
-isBlob, isTree, isCommit, isTag, 
-// Validation constants
-SHA_PATTERN, VALID_MODES, 
-// Validation functions
-isValidSha, isValidObjectType, isValidMode, validateTreeEntry, validateAuthor, validateCommit, validateTag, 
-// Serialization
-serializeBlob, serializeTree, serializeCommit, serializeTag, 
-// Deserialization
-parseBlob, parseTree, parseCommit, parseTag, } from './types/objects';
-/**
- * Storage interface types and validation.
- *
- * @description
- * Core storage interfaces for Git object stores and commit providers:
- * - {@link ObjectStore}: Full-featured object storage with refs
- * - {@link BasicObjectStore}: Minimal object CRUD
- * - {@link RefObjectStore}: Object store with ref management
- * - {@link TreeDiffObjectStore}: Specialized for tree operations
- * - {@link CommitProvider}: Commit retrieval interface
- * - {@link BasicCommitProvider}: Minimal commit access
- *
- * Plus validation helpers for storage operations.
- *
- * @example
- * ```typescript
- * import {
- *   type ObjectStore,
- *   validateRefName,
- *   assertValidSha
- * } from 'gitx.do'
- *
- * // Validate before storing
- * assertValidSha(treeSha, 'tree')
- * const refResult = validateRefName('refs/heads/main')
- * ```
- */
-export { 
-// Validation functions
-validateRefName, validateRefUpdate, validateStoreParams, assertValidSha, assertValidRefName, } from './types/storage';
 // =============================================================================
-// Pack Operations - Packfile format and index handling
+// Re-export core git types from @dotdo/gitx
 // =============================================================================
-/**
- * Packfile format handling.
- *
- * @description
- * Functions for reading and writing Git packfiles including:
- * - Pack header parsing and creation
- * - Variable-length integer encoding/decoding
- * - Object type and size encoding
- *
- * @example
- * ```typescript
- * import { createPackfile, parsePackHeader } from 'gitx.do'
- *
- * // Create a packfile from objects
- * const packData = await createPackfile(objects)
- *
- * // Parse pack header
- * const header = parsePackHeader(packData)
- * console.log(`Pack contains ${header.objectCount} objects`)
- * ```
- */
-export { 
-// Constants
-PACK_SIGNATURE, PACK_VERSION, 
-// Enums
-PackObjectType, 
-// Type conversions
-packObjectTypeToString, stringToPackObjectType, 
-// Variable-length encoding
-encodeVarint, decodeVarint, encodeTypeAndSize, decodeTypeAndSize, 
-// Pack header
-parsePackHeader, parsePackObject, createPackfile, } from './pack/format';
-/**
- * Pack index operations.
- *
- * @description
- * Functions for reading and writing pack index files (.idx) including:
- * - Index parsing and creation
- * - Object lookup by SHA
- * - CRC32 calculation for verification
- *
- * @example
- * ```typescript
- * import { createPackIndex, lookupObject } from 'gitx.do'
- *
- * // Create index for a packfile
- * const index = await createPackIndex(packData)
- *
- * // Look up an object
- * const result = lookupObject(index, sha)
- * if (result) {
- *   console.log(`Object at offset ${result.offset}`)
- * }
- * ```
- */
-export { 
-// Constants
-PACK_INDEX_SIGNATURE, PACK_INDEX_MAGIC, PACK_INDEX_VERSION, LARGE_OFFSET_THRESHOLD, 
-// Main functions
-parsePackIndex, createPackIndex, lookupObject, verifyPackIndex, serializePackIndex, 
-// Utility functions
-getFanoutRange, calculateCRC32, binarySearchObjectId, binarySearchSha, parseFanoutTable, readPackOffset, } from './pack/index';
+export * from '@dotdo/gitx';
 // =============================================================================
-// Git Operations - Core git commands (merge, blame, commit, branch)
+// Cloudflare-specific Schema Management
 // =============================================================================
-/**
- * Merge operations.
- *
- * @description
- * Functions for performing Git merges including:
- * - Three-way merge algorithm
- * - Merge base finding
- * - Conflict detection and resolution
- * - Content merging for text files
- *
- * @example
- * ```typescript
- * import { merge, findMergeBase, resolveConflict } from 'gitx.do'
- *
- * // Find merge base
- * const base = await findMergeBase(storage, commit1, commit2)
- *
- * // Perform merge
- * const result = await merge(storage, {
- *   ours: 'main',
- *   theirs: 'feature',
- *   strategy: 'recursive'
- * })
- *
- * if (result.conflicts.length > 0) {
- *   // Handle conflicts
- * }
- * ```
- */
-export { merge, findMergeBase, resolveConflict, abortMerge, continueMerge, getMergeState, isMergeInProgress, mergeContent, isBinaryFile, } from './ops/merge';
-/**
- * Blame operations.
- *
- * @description
- * Functions for git blame functionality including:
- * - Line-by-line attribution
- * - Rename tracking across history
- * - Range-based blame
- * - Blame output formatting
- *
- * @example
- * ```typescript
- * import { blame, blameFile, formatBlame } from 'gitx.do'
- *
- * // Get blame for a file
- * const result = await blameFile(storage, 'src/index.ts', { commit: 'HEAD' })
- *
- * // Format for display
- * const output = formatBlame(result, { showEmail: true })
- * ```
- */
-export { blame, blameFile, blameLine, blameRange, getBlameForCommit, trackContentAcrossRenames, detectRenames, buildBlameHistory, formatBlame, parseBlameOutput, } from './ops/blame';
-/**
- * Commit operations.
- *
- * @description
- * Functions for creating and working with commits including:
- * - Commit creation and amendment
- * - Commit message formatting and validation
- * - Signature handling (GPG)
- * - Author/timestamp utilities
- *
- * @example
- * ```typescript
- * import { createCommit, createAuthor, formatTimestamp } from 'gitx.do'
- *
- * const author = createAuthor('Alice', 'alice@example.com')
- * const commit = await createCommit(storage, {
- *   tree: treeSha,
- *   parents: [parentSha],
- *   author,
- *   message: 'Add new feature'
- * })
- * ```
- */
-export { createCommit, amendCommit, buildCommitObject, formatCommitMessage, parseCommitMessage, validateCommitMessage, isCommitSigned, extractCommitSignature, addSignatureToCommit, isEmptyCommit, getCurrentTimezone, formatTimestamp, parseTimestamp, createAuthor, } from './ops/commit';
-/**
- * Branch operations.
- *
- * @description
- * Functions for branch management including:
- * - Branch creation, deletion, and renaming
- * - Branch listing and filtering
- * - Upstream tracking configuration
- * - Branch validation
- *
- * @example
- * ```typescript
- * import { createBranch, listBranches, getCurrentBranch } from 'gitx.do'
- *
- * // Create a new branch
- * await createBranch(storage, 'feature/new-thing', { startPoint: 'main' })
- *
- * // List all branches
- * const branches = await listBranches(storage, { includeRemotes: true })
- *
- * // Get current branch
- * const current = await getCurrentBranch(storage)
- * ```
- */
-export { createBranch, deleteBranch, listBranches, renameBranch, checkoutBranch, getCurrentBranch, getBranchInfo, branchExists, setBranchTracking, getBranchTracking, removeBranchTracking, getDefaultBranch, setDefaultBranch, isValidBranchName, normalizeBranchName, } from './ops/branch';
+export { SchemaManager, SCHEMA_VERSION, SCHEMA_SQL, } from './do/schema';
 // =============================================================================
-// MCP (Model Context Protocol) - AI assistant integration
+// Cloudflare-specific Types
 // =============================================================================
-/**
- * MCP tool definitions.
- *
- * @description
- * Tools for integrating with AI assistants via MCP including:
- * - Tool registration and discovery
- * - Input validation
- * - Tool invocation
- *
- * @example
- * ```typescript
- * import { gitTools, invokeTool, validateToolInput } from 'gitx.do'
- *
- * // List available tools
- * const tools = gitTools
- *
- * // Validate and invoke a tool
- * if (validateToolInput('git_status', input)) {
- *   const result = await invokeTool('git_status', input, context)
- * }
- * ```
- */
 export { 
-// Tool definitions
-gitTools, registerTool, validateToolInput, invokeTool, listTools, getTool, } from './mcp/tools';
-/**
- * MCP adapter.
- *
- * @description
- * Adapter for MCP protocol communication including:
- * - Request/response handling
- * - Capability negotiation
- * - Error handling
- *
- * @example
- * ```typescript
- * import { createMCPAdapter, MCPError, MCPErrorCode } from 'gitx.do'
- *
- * const adapter = createMCPAdapter({
- *   name: 'gitx.do',
- *   version: '1.0.0'
- * })
- *
- * const response = await adapter.handleRequest(request)
- * ```
- */
-export { 
-// Adapter
-MCPAdapter, createMCPAdapter, MCPError, MCPErrorCode, } from './mcp/adapter';
+// Error types
+GitRepoDOErrorCode, GitRepoDOError, 
+// Logging types
+LogLevel, } from './do/types';
 // =============================================================================
-// Wire Protocol - Git Smart HTTP protocol implementation
+// Logger utilities
 // =============================================================================
-/**
- * Smart HTTP protocol handlers.
- *
- * @description
- * Functions for handling Git Smart HTTP protocol including:
- * - Info/refs endpoint handling
- * - Upload-pack (fetch/clone)
- * - Receive-pack (push)
- * - Capability negotiation
- *
- * @example
- * ```typescript
- * import { handleInfoRefs, handleUploadPack, handleReceivePack } from 'gitx.do'
- *
- * // Handle info/refs request
- * const refs = await handleInfoRefs(request, { service: 'git-upload-pack' })
- *
- * // Handle fetch request
- * const pack = await handleUploadPack(request, storage)
- * ```
- */
-export { 
-// Request handlers
-handleInfoRefs, handleUploadPack, handleReceivePack, 
-// Formatting
-formatRefAdvertisement, formatUploadPackResponse, formatReceivePackResponse, 
-// Parsing
-parseUploadPackRequest, parseReceivePackRequest, parseCapabilities, capabilitiesToStrings, 
-// Utilities
-validateContentType, createErrorResponse, 
-// Constants
-CONTENT_TYPE_UPLOAD_PACK_ADVERTISEMENT, CONTENT_TYPE_RECEIVE_PACK_ADVERTISEMENT, CONTENT_TYPE_UPLOAD_PACK_REQUEST, CONTENT_TYPE_UPLOAD_PACK_RESULT, CONTENT_TYPE_RECEIVE_PACK_REQUEST, CONTENT_TYPE_RECEIVE_PACK_RESULT, ZERO_SHA, } from './wire/smart-http';
-/**
- * Pkt-line encoding/decoding.
- *
- * @description
- * Functions for Git pkt-line format handling including:
- * - Line encoding/decoding
- * - Flush and delimiter packets
- * - Stream processing
- *
- * @example
- * ```typescript
- * import { encodePktLine, decodePktLine, FLUSH_PKT } from 'gitx.do'
- *
- * // Encode a line
- * const encoded = encodePktLine('want abc123')
- *
- * // Decode a line
- * const { line, remaining } = decodePktLine(data)
- * ```
- */
-export { 
-// Encoding/decoding
-encodePktLine, decodePktLine, encodeFlushPkt, encodeDelimPkt, pktLineStream, 
-// Constants
-FLUSH_PKT, DELIM_PKT, MAX_PKT_LINE_DATA, } from './wire/pkt-line';
+export { createLogger, createChildLogger, noopLogger, } from './do/logger';
 // =============================================================================
-// Storage - R2 packfile storage and object indexing
+// MCP Server
 // =============================================================================
-/**
- * R2 pack storage.
- *
- * @description
- * Functions for storing packfiles in Cloudflare R2 including:
- * - Packfile upload/download
- * - Multi-pack index management
- * - Pack locking for concurrent access
- *
- * @example
- * ```typescript
- * import { R2PackStorage, uploadPackfile, listPackfiles } from 'gitx.do'
- *
- * const storage = new R2PackStorage(r2Bucket, { prefix: 'git/packs' })
- *
- * // Upload a packfile
- * const result = await uploadPackfile(storage, packData, { withIndex: true })
- *
- * // List all packfiles
- * const packs = await listPackfiles(storage)
- * ```
- */
-export { 
-// Class
-R2PackStorage, R2PackError, 
-// Standalone functions
-uploadPackfile, downloadPackfile, getPackfileMetadata, listPackfiles, deletePackfile, createMultiPackIndex, parseMultiPackIndex, lookupObjectInMultiPack, acquirePackLock, releasePackLock, } from './storage/r2-pack';
-/**
- * Object index.
- *
- * @description
- * Functions for tracking object locations across storage tiers including:
- * - Location recording and lookup
- * - Batch operations
- * - Statistics
- *
- * @example
- * ```typescript
- * import { ObjectIndex, recordLocation, lookupLocation } from 'gitx.do'
- *
- * const index = new ObjectIndex(storage)
- *
- * // Record object location
- * await recordLocation(index, sha, { tier: 'hot', location: 'local' })
- *
- * // Look up location
- * const location = await lookupLocation(index, sha)
- * ```
- */
-export { 
-// Class
-ObjectIndex, 
-// Standalone functions
-recordLocation, lookupLocation, batchLookup, getStats, } from './storage/object-index';
+export { registerTool, unregisterTool, invokeTool, getToolRegistry, clearToolRegistry, useMiddleware, clearMiddleware, 
+// Git tools
+gitTools, gitStatusToolSchema, gitLogToolSchema, gitDiffToolSchema, gitShowToolSchema, gitCommitToolSchema, gitBranchToolSchema, gitCheckoutToolSchema, gitAddToolSchema, gitResetToolSchema, gitMergeToolSchema, gitRebaseToolSchema, gitStashToolSchema, gitTagToolSchema, gitRemoteToolSchema, gitFetchToolSchema, gitPushToolSchema, gitPullToolSchema, gitCloneToolSchema, gitInitToolSchema, gitBlameToolSchema, 
+// Auth
+gitAuthMiddleware, requireGitAuth, requireGitWrite, requireGitAdmin, 
+// Server
+createGitMCPServer, } from './mcp/index';
 // =============================================================================
-// Tiered Storage - Hot/Warm/Cold storage with migration
+// TODO: Additional exports to be added as migration continues
 // =============================================================================
-/**
- * Tier migration.
- *
- * @description
- * Functions for managing object migration between storage tiers including:
- * - Migration policies
- * - Access tracking
- * - Concurrent access handling
- *
- * @example
- * ```typescript
- * import { TierMigrator, AccessTracker } from 'gitx.do'
- *
- * const tracker = new AccessTracker(storage)
- * await tracker.recordAccess(sha)
- *
- * const migrator = new TierMigrator(storage, { policy: 'lru' })
- * await migrator.migrate(sha, 'hot', 'warm')
- * ```
- */
-export { 
-// Classes
-TierMigrator, AccessTracker, MigrationError, MigrationRollback, ConcurrentAccessHandler, } from './tiered/migration';
-/**
- * Tiered read path.
- *
- * @description
- * Functions for reading objects across storage tiers including:
- * - Automatic tier traversal
- * - Caching strategies
- * - Read optimization
- *
- * @example
- * ```typescript
- * import { TieredReader, type TieredStorageConfig } from 'gitx.do'
- *
- * const config: TieredStorageConfig = {
- *   hot: { backend: hotBackend, maxSize: 1_000_000 },
- *   warm: { backend: warmBackend },
- *   cold: { backend: coldBackend }
- * }
- *
- * const reader = new TieredReader(config)
- * const result = await reader.read(sha)
- * ```
- */
-export { 
-// Class
-TieredReader, TieredObjectStoreStub, } from './tiered/read-path';
+// - GitRepoDO
+// - GitModule
+// - FsModule
+// - withGit, withFs mixins
+// - TieredStorage
+// - ObjectStore
+// - WAL
+// - Container executor
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF,cAAc,aAAa,CAAA;AAE3B,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,cAAc,EACd,UAAU,GAEX,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,OAAO;AA8BL,cAAc;AACd,kBAAkB,EAClB,cAAc;AAEd,gBAAgB;AAChB,QAAQ,GAMT,MAAM,YAAY,CAAA;AAEnB,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,UAAU,GAEX,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EAUL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,eAAe;AACf,YAAY;AACZ,QAAQ,EACR,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB;AAClB,OAAO;AACP,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe;AAGf,SAAS;AACT,kBAAkB,GAEnB,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAChF,cAAc;AACd,cAAc;AACd,aAAa;AACb,2BAA2B;AAC3B,kBAAkB;AAClB,gBAAgB;AAChB,QAAQ;AACR,uBAAuB"}

package/dist/mcp/auth.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Git MCP Authentication Middleware
+ *
+ * Provides OAuth 2.1 authentication via oauth.do for MCP git operations.
+ * Implements token introspection (RFC 7662) for access control.
+ *
+ * ## Authentication Flow
+ *
+ * 1. MCP client sends request with Bearer token
+ * 2. Middleware introspects token via oauth.do
+ * 3. Scopes determine access level:
+ *    - `read` or `git:read` - read-only access
+ *    - `write` or `git:write` - full access
+ *    - `admin` or `git:admin` - admin access
+ *
+ * ## Usage with Hono
+ *
+ * ```typescript
+ * import { Hono } from 'hono'
+ * import { gitAuthMiddleware, requireGitWrite } from 'gitx.do/mcp'
+ *
+ * const app = new Hono()
+ *
+ * // Apply auth middleware to all routes
+ * app.use('/*', gitAuthMiddleware({
+ *   introspectionUrl: 'https://oauth.do/introspect',
+ *   clientId: env.OAUTH_CLIENT_ID,
+ *   clientSecret: env.OAUTH_CLIENT_SECRET,
+ * }))
+ *
+ * // Protect write operations
+ * app.post('/git/commit', requireGitWrite(), async (c) => {
+ *   const auth = c.get('gitAuth')
+ *   // ...
+ * })
+ * ```
+ *
+ * @module mcp/auth
+ */
+import type { MiddlewareHandler } from 'hono';
+import type { GitAuthContext, GitAuthConfig } from './types';
+export type { GitAuthContext, GitAuthConfig } from './types';
+/**
+ * Extend Hono's ContextVariableMap with gitAuth
+ */
+declare module 'hono' {
+    interface ContextVariableMap {
+        gitAuth: GitAuthContext;
+    }
+}
+/**
+ * Create authentication middleware for Hono
+ */
+export declare function gitAuthMiddleware(config: GitAuthConfig): MiddlewareHandler;
+/**
+ * Middleware that requires authentication
+ */
+export declare function requireGitAuth(): MiddlewareHandler;
+/**
+ * Middleware that requires write access
+ */
+export declare function requireGitWrite(): MiddlewareHandler;
+/**
+ * Middleware that requires admin access
+ */
+export declare function requireGitAdmin(): MiddlewareHandler;
+/**
+ * Authenticate a standalone request (for non-Hono use)
+ */
+export declare function authenticateRequest(request: Request, config: GitAuthConfig): Promise<{
+    success: true;
+    context: GitAuthContext;
+} | {
+    success: false;
+    error: string;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/mcp/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/mcp/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,MAAM,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAG5D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5D;;GAEG;AACH,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,OAAO,EAAE,cAAc,CAAA;KACxB;CACF;AAyJD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAkD1E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAalD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAanD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAoBnD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCzF"}