@dotdo/do 0.1.0

package/dist/do/domains/subdomains.js

@@ -0,0 +1,223 @@
+/**
+ * Subdomain Registration
+ *
+ * CRUD operations for subdomain registrations on platform TLDs.
+ * Interacts with the Builder.Domains DO for centralized registration management.
+ *
+ * @module domains/subdomains
+ */
+import { validateSubdomain, validateTLD } from './validation';
+// =============================================================================
+// Subdomain Client
+// =============================================================================
+/**
+ * Client for subdomain operations
+ *
+ * Wraps the Builder.Domains DO stub for subdomain management.
+ */
+export class SubdomainClient {
+    domainsStub;
+    /**
+     * Create a new SubdomainClient
+     *
+     * @param domainsStub - Durable Object stub for Builder.Domains
+     */
+    constructor(domainsStub) {
+        this.domainsStub = domainsStub;
+    }
+    /**
+     * Check if a subdomain is available
+     *
+     * @param subdomain - The subdomain to check (e.g., 'acme')
+     * @param tld - The platform TLD (e.g., 'saas.group')
+     * @returns The subdomain status
+     *
+     * @example
+     * ```typescript
+     * const status = await client.check('acme', 'saas.group')
+     * if (status === 'available') {
+     *   // Can be claimed
+     * }
+     * ```
+     */
+    async check(subdomain, tld) {
+        // TODO: Implement RPC call to Builder.Domains DO
+        throw new Error('Not implemented');
+    }
+    /**
+     * Claim a subdomain
+     *
+     * @param request - The claim request
+     * @returns The claim result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.claim({
+     *   subdomain: 'acme',
+     *   tld: 'saas.group',
+     *   ownerRef: 'do://Startup/acme'
+     * })
+     *
+     * if (result.success) {
+     *   console.log('Claimed:', result.$id) // https://acme.saas.group
+     * }
+     * ```
+     */
+    async claim(request) {
+        // Validate before sending to DO
+        const subdomainValidation = validateSubdomain(request.subdomain);
+        if (!subdomainValidation.valid) {
+            return {
+                success: false,
+                error: subdomainValidation.error,
+                reason: 'Invalid',
+            };
+        }
+        const tldValidation = validateTLD(request.tld);
+        if (!tldValidation.valid) {
+            return {
+                success: false,
+                error: tldValidation.error,
+                reason: 'Invalid',
+            };
+        }
+        // TODO: Implement RPC call to Builder.Domains DO
+        throw new Error('Not implemented');
+    }
+    /**
+     * Release a subdomain
+     *
+     * @param subdomain - The subdomain to release
+     * @param tld - The platform TLD
+     * @param ownerRef - The owner's DO $id (must match registration)
+     * @returns True if released successfully
+     *
+     * @example
+     * ```typescript
+     * const released = await client.release('acme', 'saas.group', 'do://Startup/acme')
+     * ```
+     */
+    async release(subdomain, tld, ownerRef) {
+        // TODO: Implement RPC call to Builder.Domains DO
+        throw new Error('Not implemented');
+    }
+    /**
+     * List subdomains owned by a specific DO
+     *
+     * @param ownerRef - The owner's DO $id
+     * @returns Array of subdomain registrations
+     *
+     * @example
+     * ```typescript
+     * const subdomains = await client.listByOwner('do://Startup/acme')
+     * // [{ $id: 'https://acme.saas.group', subdomain: 'acme', ... }]
+     * ```
+     */
+    async listByOwner(ownerRef) {
+        // TODO: Implement RPC call to Builder.Domains DO
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get a specific subdomain registration
+     *
+     * @param subdomain - The subdomain
+     * @param tld - The platform TLD
+     * @returns The registration or null if not found
+     *
+     * @example
+     * ```typescript
+     * const reg = await client.get('acme', 'saas.group')
+     * if (reg) {
+     *   console.log('Owner:', reg.ownerRef)
+     * }
+     * ```
+     */
+    async get(subdomain, tld) {
+        // TODO: Implement RPC call to Builder.Domains DO
+        throw new Error('Not implemented');
+    }
+    /**
+     * Search subdomains by prefix
+     *
+     * @param query - Search query (prefix match)
+     * @param tld - Optional TLD filter
+     * @returns Matching registrations
+     *
+     * @example
+     * ```typescript
+     * const results = await client.search('acm', 'saas.group')
+     * // [{ subdomain: 'acme', ... }, { subdomain: 'acme-dev', ... }]
+     * ```
+     */
+    async search(query, tld) {
+        // TODO: Implement RPC call to Builder.Domains DO
+        throw new Error('Not implemented');
+    }
+}
+// =============================================================================
+// Public API Functions
+// =============================================================================
+/**
+ * Create a subdomain client from a Durable Object namespace
+ *
+ * @param namespace - The Builder.Domains DO namespace
+ * @returns A SubdomainClient instance
+ *
+ * @example
+ * ```typescript
+ * const client = createSubdomainClient(env.BUILDER_DOMAINS)
+ * ```
+ */
+export function createSubdomainClient(namespace) {
+    const id = namespace.idFromName('domains');
+    const stub = namespace.get(id);
+    return new SubdomainClient(stub);
+}
+/**
+ * Build the full domain URL from subdomain and TLD
+ *
+ * @param subdomain - The subdomain (e.g., 'acme')
+ * @param tld - The platform TLD (e.g., 'saas.group')
+ * @returns The full URL (e.g., 'https://acme.saas.group')
+ *
+ * @example
+ * ```typescript
+ * buildDomainUrl('acme', 'saas.group')
+ * // 'https://acme.saas.group'
+ * ```
+ */
+export function buildDomainUrl(subdomain, tld) {
+    return `https://${subdomain}.${tld}`;
+}
+/**
+ * Parse a domain URL into subdomain and TLD
+ *
+ * @param url - The domain URL (e.g., 'https://acme.saas.group')
+ * @returns Object with subdomain and tld, or null if invalid
+ *
+ * @example
+ * ```typescript
+ * parseDomainUrl('https://acme.saas.group')
+ * // { subdomain: 'acme', tld: 'saas.group' }
+ * ```
+ */
+export function parseDomainUrl(url) {
+    // TODO: Implement URL parsing and TLD matching
+    throw new Error('Not implemented');
+}
+/**
+ * Check if a URL is a platform domain
+ *
+ * @param url - The URL to check
+ * @returns True if the URL is on a platform TLD
+ *
+ * @example
+ * ```typescript
+ * isPlatformDomain('https://acme.saas.group') // true
+ * isPlatformDomain('https://example.com') // false
+ * ```
+ */
+export function isPlatformDomain(url) {
+    return parseDomainUrl(url) !== null;
+}
+//# sourceMappingURL=subdomains.js.map

package/dist/do/domains/subdomains.js.map

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

package/dist/do/domains/tlds.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Platform TLD Registry
+ *
+ * Manages the 50+ platform-owned TLDs available for free subdomain registration.
+ * Each TLD has associated Cloudflare zone configuration and feature flags.
+ *
+ * @module domains/tlds
+ */
+import { type PlatformTLD } from '../../types/domains';
+/**
+ * Route target for default subdomain routing
+ */
+export type RouteTarget = {
+    type: 'worker';
+    script: string;
+} | {
+    type: 'do';
+    namespace: string;
+    id?: string;
+} | {
+    type: 'pages';
+    project: string;
+} | {
+    type: 'external';
+    url: string;
+};
+/**
+ * Feature flags for a TLD
+ */
+export interface TLDFeatures {
+    /** Email routing enabled for this TLD */
+    email: boolean;
+    /** Wildcard SSL certificate available */
+    wildcardSSL: boolean;
+    /** Allow custom DNS records (beyond default A/AAAA) */
+    customDNS: boolean;
+    /** Allow deep subdomains (a.b.tld) */
+    deepSubdomains: boolean;
+}
+/**
+ * Configuration for a platform TLD
+ */
+export interface TLDConfig {
+    /** The TLD (e.g., 'saas.group') */
+    tld: PlatformTLD;
+    /** Cloudflare zone ID */
+    zoneId: string;
+    /** Default routing target for new subdomains */
+    defaultTarget: RouteTarget;
+    /** Feature flags */
+    features: TLDFeatures;
+    /** Human-readable description */
+    description: string;
+    /** Category for grouping */
+    category: TLDCategory;
+}
+/**
+ * TLD category for organizational purposes
+ */
+export type TLDCategory = 'business' | 'studio' | 'startup' | 'saas' | 'infrastructure';
+/**
+ * Get all available platform TLDs
+ *
+ * @returns Array of all platform TLD strings
+ *
+ * @example
+ * ```typescript
+ * const tlds = getAllTLDs()
+ * // ['hq.com.ai', 'app.net.ai', 'saas.group', ...]
+ * ```
+ */
+export declare function getAllTLDs(): readonly PlatformTLD[];
+/**
+ * Get TLDs by category
+ *
+ * @param category - The category to filter by
+ * @returns Array of TLDs in the specified category
+ *
+ * @example
+ * ```typescript
+ * const saasTLDs = getTLDsByCategory('saas')
+ * // ['saas.group', 'agents.do', 'workers.do', 'functions.do']
+ * ```
+ */
+export declare function getTLDsByCategory(category: TLDCategory): PlatformTLD[];
+/**
+ * Check if a string is a valid platform TLD
+ *
+ * @param tld - The string to check
+ * @returns True if the string is a valid platform TLD
+ *
+ * @example
+ * ```typescript
+ * isValidTLD('saas.group') // true
+ * isValidTLD('example.com') // false
+ * ```
+ */
+export declare function isValidTLD(tld: string): tld is PlatformTLD;
+/**
+ * Get configuration for a specific TLD
+ *
+ * @param tld - The platform TLD
+ * @returns TLD configuration or null if not found
+ *
+ * @example
+ * ```typescript
+ * const config = getTLDConfig('saas.group')
+ * // { tld: 'saas.group', zoneId: '...', features: {...}, ... }
+ * ```
+ */
+export declare function getTLDConfig(tld: PlatformTLD): TLDConfig | null;
+/**
+ * Get the Cloudflare zone ID for a TLD
+ *
+ * @param tld - The platform TLD
+ * @returns Zone ID or null if not configured
+ *
+ * @example
+ * ```typescript
+ * const zoneId = getZoneId('saas.group')
+ * // 'abc123...'
+ * ```
+ */
+export declare function getZoneId(tld: PlatformTLD): string | null;
+/**
+ * Get default route target for a TLD
+ *
+ * @param tld - The platform TLD
+ * @returns Default route target
+ *
+ * @example
+ * ```typescript
+ * const target = getDefaultTarget('saas.group')
+ * // { type: 'do', namespace: 'DigitalObject' }
+ * ```
+ */
+export declare function getDefaultTarget(tld: PlatformTLD): RouteTarget;
+/**
+ * Check if a TLD supports a specific feature
+ *
+ * @param tld - The platform TLD
+ * @param feature - The feature to check
+ * @returns True if the feature is enabled for this TLD
+ *
+ * @example
+ * ```typescript
+ * hasFeature('saas.group', 'email') // true
+ * hasFeature('cdn.land', 'email') // false
+ * ```
+ */
+export declare function hasFeature(tld: PlatformTLD, feature: keyof TLDFeatures): boolean;
+/**
+ * Initialize TLD configurations from environment
+ *
+ * @param env - Environment bindings with zone IDs
+ *
+ * @example
+ * ```typescript
+ * // In worker entry point
+ * initializeTLDs(env)
+ * ```
+ */
+export declare function initializeTLDs(env: Record<string, string>): void;
+/**
+ * Human-readable descriptions for each TLD category
+ */
+export declare const TLD_CATEGORY_DESCRIPTIONS: Record<TLDCategory, string>;
+/**
+ * Get a human-readable description for a TLD
+ *
+ * @param tld - The platform TLD
+ * @returns Description string
+ */
+export declare function getTLDDescription(tld: PlatformTLD): string;
+//# sourceMappingURL=tlds.d.ts.map

package/dist/do/domains/tlds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tlds.d.ts","sourceRoot":"","sources":["../../../do/domains/tlds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAMrE;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAErC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAA;IACpB,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,cAAc,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,GAAG,EAAE,WAAW,CAAA;IAChB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,aAAa,EAAE,WAAW,CAAA;IAC1B,oBAAoB;IACpB,QAAQ,EAAE,WAAW,CAAA;IACrB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,WAAW,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,MAAM,GACN,gBAAgB,CAAA;AAoCpB;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,SAAS,WAAW,EAAE,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAGtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,WAAW,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAG/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAG9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,GAAG,OAAO,CAGhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAIhE;AAMD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjE,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAG1D"}

package/dist/do/domains/tlds.js

@@ -0,0 +1,188 @@
+/**
+ * Platform TLD Registry
+ *
+ * Manages the 50+ platform-owned TLDs available for free subdomain registration.
+ * Each TLD has associated Cloudflare zone configuration and feature flags.
+ *
+ * @module domains/tlds
+ */
+import { PLATFORM_TLDS } from '../../types/domains';
+// =============================================================================
+// TLD Registry
+// =============================================================================
+/**
+ * Registry of all platform TLD configurations
+ *
+ * Note: Zone IDs should be populated from environment variables in production.
+ * Placeholder values shown here for structure reference.
+ */
+const TLD_CONFIGS = new Map();
+/**
+ * Default features for most TLDs
+ */
+const DEFAULT_FEATURES = {
+    email: true,
+    wildcardSSL: true,
+    customDNS: true,
+    deepSubdomains: false,
+};
+/**
+ * Default route target (route to DO)
+ */
+const DEFAULT_TARGET = {
+    type: 'do',
+    namespace: 'DigitalObject',
+};
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Get all available platform TLDs
+ *
+ * @returns Array of all platform TLD strings
+ *
+ * @example
+ * ```typescript
+ * const tlds = getAllTLDs()
+ * // ['hq.com.ai', 'app.net.ai', 'saas.group', ...]
+ * ```
+ */
+export function getAllTLDs() {
+    return PLATFORM_TLDS;
+}
+/**
+ * Get TLDs by category
+ *
+ * @param category - The category to filter by
+ * @returns Array of TLDs in the specified category
+ *
+ * @example
+ * ```typescript
+ * const saasTLDs = getTLDsByCategory('saas')
+ * // ['saas.group', 'agents.do', 'workers.do', 'functions.do']
+ * ```
+ */
+export function getTLDsByCategory(category) {
+    // TODO: Implement based on TLD_CONFIGS
+    throw new Error('Not implemented');
+}
+/**
+ * Check if a string is a valid platform TLD
+ *
+ * @param tld - The string to check
+ * @returns True if the string is a valid platform TLD
+ *
+ * @example
+ * ```typescript
+ * isValidTLD('saas.group') // true
+ * isValidTLD('example.com') // false
+ * ```
+ */
+export function isValidTLD(tld) {
+    return PLATFORM_TLDS.includes(tld);
+}
+/**
+ * Get configuration for a specific TLD
+ *
+ * @param tld - The platform TLD
+ * @returns TLD configuration or null if not found
+ *
+ * @example
+ * ```typescript
+ * const config = getTLDConfig('saas.group')
+ * // { tld: 'saas.group', zoneId: '...', features: {...}, ... }
+ * ```
+ */
+export function getTLDConfig(tld) {
+    // TODO: Implement lookup from TLD_CONFIGS or environment
+    throw new Error('Not implemented');
+}
+/**
+ * Get the Cloudflare zone ID for a TLD
+ *
+ * @param tld - The platform TLD
+ * @returns Zone ID or null if not configured
+ *
+ * @example
+ * ```typescript
+ * const zoneId = getZoneId('saas.group')
+ * // 'abc123...'
+ * ```
+ */
+export function getZoneId(tld) {
+    // TODO: Implement - should read from environment or config
+    throw new Error('Not implemented');
+}
+/**
+ * Get default route target for a TLD
+ *
+ * @param tld - The platform TLD
+ * @returns Default route target
+ *
+ * @example
+ * ```typescript
+ * const target = getDefaultTarget('saas.group')
+ * // { type: 'do', namespace: 'DigitalObject' }
+ * ```
+ */
+export function getDefaultTarget(tld) {
+    const config = TLD_CONFIGS.get(tld);
+    return config?.defaultTarget ?? DEFAULT_TARGET;
+}
+/**
+ * Check if a TLD supports a specific feature
+ *
+ * @param tld - The platform TLD
+ * @param feature - The feature to check
+ * @returns True if the feature is enabled for this TLD
+ *
+ * @example
+ * ```typescript
+ * hasFeature('saas.group', 'email') // true
+ * hasFeature('cdn.land', 'email') // false
+ * ```
+ */
+export function hasFeature(tld, feature) {
+    const config = TLD_CONFIGS.get(tld);
+    return config?.features[feature] ?? DEFAULT_FEATURES[feature];
+}
+/**
+ * Initialize TLD configurations from environment
+ *
+ * @param env - Environment bindings with zone IDs
+ *
+ * @example
+ * ```typescript
+ * // In worker entry point
+ * initializeTLDs(env)
+ * ```
+ */
+export function initializeTLDs(env) {
+    // TODO: Populate TLD_CONFIGS from environment variables
+    // e.g., env.CF_ZONE_SAAS_GROUP -> 'saas.group' zone ID
+    throw new Error('Not implemented');
+}
+// =============================================================================
+// TLD Metadata (for documentation/UI)
+// =============================================================================
+/**
+ * Human-readable descriptions for each TLD category
+ */
+export const TLD_CATEGORY_DESCRIPTIONS = {
+    business: 'Primary business TLDs for headquarters and applications',
+    studio: 'Studio and builder TLDs for development platforms',
+    startup: 'Startup-focused TLDs for new ventures',
+    saas: 'SaaS product TLDs for software services',
+    infrastructure: 'Infrastructure TLDs for CDN, edge, and platform services',
+};
+/**
+ * Get a human-readable description for a TLD
+ *
+ * @param tld - The platform TLD
+ * @returns Description string
+ */
+export function getTLDDescription(tld) {
+    const config = TLD_CONFIGS.get(tld);
+    return config?.description ?? `Platform TLD: ${tld}`;
+}
+//# sourceMappingURL=tlds.js.map

package/dist/do/domains/tlds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tlds.js","sourceRoot":"","sources":["../../../do/domains/tlds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAA;AAyDrE,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,GAAgC,IAAI,GAAG,EAAE,CAAA;AAE1D;;GAEG;AACH,MAAM,gBAAgB,GAAgB;IACpC,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,KAAK;CACtB,CAAA;AAED;;GAEG;AACH,MAAM,cAAc,GAAgB;IAClC,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,eAAe;CAC3B,CAAA;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,uCAAuC;IACvC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,yDAAyD;IACzD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,2DAA2D;IAC3D,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,MAAM,EAAE,aAAa,IAAI,cAAc,CAAA;AAChD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,GAAgB,EAAE,OAA0B;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAA;AAC/D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,GAA2B;IACxD,wDAAwD;IACxD,uDAAuD;IACvD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAgC;IACpE,QAAQ,EAAE,yDAAyD;IACnE,MAAM,EAAE,mDAAmD;IAC3D,OAAO,EAAE,uCAAuC;IAChD,IAAI,EAAE,yCAAyC;IAC/C,cAAc,EAAE,0DAA0D;CAC3E,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAgB;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,MAAM,EAAE,WAAW,IAAI,iBAAiB,GAAG,EAAE,CAAA;AACtD,CAAC"}