@draftlab/auth 0.15.0 → 0.16.0

package/dist/types/themes/theme.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Use one of the built-in themes.
+ *
+ * @example
+ *
+ * ```ts
+ * import { THEME_SST } from "@draftlab/auth/themes/theme"
+ *
+ * export default issuer({
+ *   theme: THEME_SST,
+ *   // ...
+ * })
+ * ```
+ *
+ * Or define your own.
+ *
+ * ```ts
+ * import type { Theme } from "@draftlab/auth/themes/theme"
+ *
+ * const MY_THEME: Theme = {
+ *   title: "Acne",
+ *   radius: "none",
+ *   favicon: "https://www.example.com/favicon.svg",
+ *   // ...
+ * }
+ *
+ * export default issuer({
+ *   theme: MY_THEME,
+ *   // ...
+ * })
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * A type to define values for light and dark mode.
+ *
+ * @example
+ * ```ts
+ * {
+ *   light: "#FFF",
+ *   dark: "#000"
+ * }
+ * ```
+ */
+export interface ColorScheme {
+    /**
+     * The value for dark mode.
+     */
+    dark: string;
+    /**
+     * The value for light mode.
+     */
+    light: string;
+}
+/**
+ * A type to define your custom theme.
+ */
+export interface Theme {
+    /**
+     * The name of your app. Also used as the title of the page.
+     *
+     * @example
+     * ```ts
+     * {
+     *   title: "Acne"
+     * }
+     * ```
+     */
+    title?: string;
+    /**
+     * A URL to the favicon of your app.
+     *
+     * @example
+     * ```ts
+     * {
+     *   favicon: "https://www.example.com/favicon.svg"
+     * }
+     * ```
+     */
+    favicon?: string;
+    /**
+     * The border radius of the UI elements.
+     *
+     * @example
+     * ```ts
+     * {
+     *   radius: "none"
+     * }
+     * ```
+     */
+    radius?: "none" | "sm" | "md" | "lg" | "full";
+    /**
+     * The primary color of the theme.
+     *
+     * Takes a color or both light and dark colors.
+     *
+     * @example
+     * ```ts
+     * {
+     *   primary: "#FF5E00"
+     * }
+     * ```
+     */
+    primary: string | ColorScheme;
+    /**
+     * The background color of the theme.
+     *
+     * Takes a color or both light and dark colors.
+     *
+     * @example
+     * ```ts
+     * {
+     *   background: "#FFF"
+     * }
+     * ```
+     */
+    background?: string | ColorScheme;
+    /**
+     * A URL to the logo of your app.
+     *
+     * Takes a single image or both light and dark mode versions.
+     *
+     * @example
+     * ```ts
+     * {
+     *   logo: "https://www.example.com/logo.svg"
+     * }
+     * ```
+     */
+    logo?: string | ColorScheme;
+    /**
+     * The font family and scale of the theme.
+     */
+    font?: {
+        /**
+         * The font family of the theme.
+         *
+         * @example
+         * ```ts
+         * {
+         *   font: {
+         *     family: "Geist Mono, monospace"
+         *   }
+         * }
+         * ```
+         */
+        family?: string;
+        /**
+         * The font scale of the theme. Can be used to increase or decrease the font sizes across
+         * the UI.
+         *
+         * @default "1"
+         * @example
+         * ```ts
+         * {
+         *   font: {
+         *     scale: "1.25"
+         *   }
+         * }
+         * ```
+         */
+        scale?: string;
+    };
+    /**
+     * Custom CSS that's added to the page in a `<style>` tag.
+     *
+     * This can be used to import custom fonts.
+     *
+     * @example
+     * ```ts
+     * {
+     *   css: `@import url('https://fonts.googleapis.com/css2?family=Rubik:wght@100;200;300;400;500;600;700;800;900&display=swap');`
+     * }
+     * ```
+     */
+    css?: string;
+}
+/**
+ * Built-in default Draft Auth theme.
+ */
+export declare const THEME_DRAFTAUTH: Theme;
+/**
+ * Built-in theme based on [Terminal](https://terminal.shop).
+ */
+export declare const THEME_TERMINAL: Theme;
+/**
+ * Built-in theme based on [SST](https://sst.dev).
+ */
+export declare const THEME_SST: Theme;
+/**
+ * Built-in theme based on [Supabase](https://supabase.com).
+ */
+export declare const THEME_SUPABASE: Theme;
+/**
+ * Built-in theme based on [Vercel](https://vercel.com).
+ */
+export declare const THEME_VERCEL: Theme;
+/**
+ * @internal
+ */
+export declare const setTheme: (value: Theme) => void;
+/**
+ * @internal
+ */
+export declare const getTheme: () => any;
+//# sourceMappingURL=theme.d.ts.map

package/dist/types/themes/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/themes/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAA;IAC7C;;;;;;;;;;;OAWG;IACH,OAAO,EAAE,MAAM,GAAG,WAAW,CAAA;IAC7B;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IAC3B;;OAEG;IACH,IAAI,CAAC,EAAE;QACN;;;;;;;;;;;WAWG;QACH,MAAM,CAAC,EAAE,MAAM,CAAA;QACf;;;;;;;;;;;;;WAaG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,KAiB7B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAmB5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,KAkBvB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAqB5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAoB1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,SAGpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,WAGpB,CAAA"}

package/dist/types/toolkit/client.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Lightweight OAuth 2.0 client toolkit for DraftAuth.
+ *
+ * Provides a simple, framework-agnostic way to implement OAuth 2.0 authentication
+ * with PKCE support. Works in both client-side (SPA) and server-side (Next.js, Remix) environments.
+ *
+ * @example
+ * ```ts
+ * // Client-side SPA (React, Vue, Solid, etc.)
+ * import { createOAuthClient } from '@draftlab/auth/toolkit/client'
+ * import { GitHubStrategy, GoogleStrategy } from '@draftlab/auth/toolkit/providers'
+ * import { createSessionStorage } from '@draftlab/auth/toolkit/storage'
+ *
+ * const client = createOAuthClient({
+ *   providers: {
+ *     github: {
+ *       strategy: GitHubStrategy,
+ *       clientId: 'YOUR_CLIENT_ID',
+ *       clientSecret: 'YOUR_CLIENT_SECRET',
+ *       redirectUri: 'http://localhost:3000/auth/callback'
+ *     },
+ *     google: {
+ *       strategy: GoogleStrategy,
+ *       clientId: 'YOUR_CLIENT_ID',
+ *       clientSecret: 'YOUR_CLIENT_SECRET',
+ *       redirectUri: 'http://localhost:3000/auth/callback'
+ *     }
+ *   },
+ *   storage: createSessionStorage()
+ * })
+ *
+ * // Initiate login
+ * const { url } = await client.authorize('github', { scopes: ['user:email'] })
+ * window.location.href = url
+ *
+ * // Handle callback
+ * const result = await client.handleCallback(window.location.href)
+ * console.log(result.accessToken, result.provider)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Server-side (Next.js App Router)
+ * import { createOAuthClient } from '@draftlab/auth/toolkit/client'
+ * import { GitHubStrategy } from '@draftlab/auth/toolkit/providers'
+ * import { createCookieStorage } from '@draftlab/auth/toolkit/storage'
+ * import { cookies } from 'next/headers'
+ *
+ * export async function GET(req: Request) {
+ *   const client = createOAuthClient({
+ *     providers: {
+ *       github: {
+ *         strategy: GitHubStrategy,
+ *         clientId: process.env.GITHUB_CLIENT_ID!,
+ *         clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+ *         redirectUri: 'https://myapp.com/auth/callback'
+ *       }
+ *     },
+ *     storage: createCookieStorage({
+ *       getCookie: (name) => cookies().get(name)?.value ?? null,
+ *       setCookie: (name, value, opts) => cookies().set(name, value, opts),
+ *       deleteCookie: (name) => cookies().delete(name)
+ *     })
+ *   })
+ *
+ *   const { url } = await client.authorize('github')
+ *   return Response.redirect(url)
+ * }
+ * ```
+ */
+import type { OAuthStrategy } from "./providers/strategy";
+import { type AuthStorage } from "./storage";
+/**
+ * Configuration for a single OAuth provider.
+ */
+export interface ProviderConfig<TStrategy extends OAuthStrategy> {
+    /** OAuth strategy defining endpoints and defaults */
+    readonly strategy: TStrategy;
+    /** OAuth client ID from provider */
+    readonly clientId: string;
+    /** OAuth client secret from provider */
+    readonly clientSecret: string;
+    /** Redirect URI registered with provider */
+    readonly redirectUri: string;
+    /** Optional default scopes for this provider */
+    readonly scopes?: string[];
+}
+/**
+ * Options for initiating OAuth authorization flow.
+ */
+export interface AuthorizeOptions {
+    /** Optional scopes to request (overrides provider defaults) */
+    readonly scopes?: string[];
+    /** Optional additional parameters to include in authorization URL */
+    readonly params?: Record<string, string>;
+    /** Optional nonce for additional security */
+    readonly nonce?: string;
+}
+/**
+ * Result of successful OAuth callback handling.
+ */
+export interface CallbackResult {
+    /** OAuth provider that was used */
+    readonly provider: string;
+    /** Access token from provider */
+    readonly accessToken: string;
+    /** Optional refresh token from provider */
+    readonly refreshToken?: string;
+    /** Token expiration time in seconds */
+    readonly expiresIn?: number;
+    /** Token type (usually "Bearer") */
+    readonly tokenType?: string;
+    /** Optional ID token (OpenID Connect) */
+    readonly idToken?: string;
+}
+/**
+ * OAuth 2.0 client configuration.
+ */
+export interface OAuthClientConfig<TProviders extends Record<string, ProviderConfig<OAuthStrategy>>> {
+    /** Provider configurations keyed by provider name */
+    readonly providers: TProviders;
+    /** Storage adapter for PKCE state (defaults to sessionStorage in browser) */
+    readonly storage?: AuthStorage;
+}
+/**
+ * OAuth 2.0 client for managing authentication flows.
+ */
+export interface OAuthClient<TProviders extends Record<string, ProviderConfig<OAuthStrategy>>> {
+    /**
+     * Initiate OAuth authorization flow.
+     *
+     * @param provider - Provider name (key from providers config)
+     * @param options - Authorization options
+     * @returns Authorization URL to redirect user to
+     *
+     * @example
+     * ```ts
+     * // Basic usage
+     * const { url } = await client.authorize('github')
+     * window.location.href = url
+     *
+     * // With custom scopes
+     * const { url } = await client.authorize('google', {
+     *   scopes: ['openid', 'email', 'profile']
+     * })
+     *
+     * // With additional params
+     * const { url } = await client.authorize('github', {
+     *   params: { prompt: 'consent' }
+     * })
+     * ```
+     */
+    authorize(provider: (string & {}) | keyof TProviders, options?: AuthorizeOptions): Promise<{
+        url: string;
+        state: string;
+    }>;
+    /**
+     * Handle OAuth callback and exchange code for tokens.
+     *
+     * @param callbackUrl - Full callback URL with query parameters
+     * @returns Token exchange result
+     *
+     * @throws {Error} If callback URL is invalid, state mismatch, or token exchange fails
+     *
+     * @example
+     * ```ts
+     * // Client-side
+     * const result = await client.handleCallback(window.location.href)
+     * console.log(result.accessToken, result.provider)
+     *
+     * // Server-side (Next.js)
+     * export async function GET(req: Request) {
+     *   const result = await client.handleCallback(req.url)
+     *   // Store tokens, create session, etc.
+     *   return Response.redirect('/')
+     * }
+     * ```
+     */
+    handleCallback(callbackUrl: string): Promise<CallbackResult>;
+    /**
+     * Get user info from OAuth provider using access token.
+     *
+     * @param provider - Provider name
+     * @param accessToken - Access token from provider
+     * @returns User info from provider
+     *
+     * @example
+     * ```ts
+     * const userInfo = await client.getUserInfo('github', accessToken)
+     * console.log(userInfo.email, userInfo.name)
+     * ```
+     */
+    getUserInfo(provider: (string & {}) | keyof TProviders, accessToken: string): Promise<Record<string, unknown>>;
+}
+/**
+ * Creates an OAuth 2.0 client for managing authentication flows.
+ *
+ * Supports PKCE (Proof Key for Code Exchange) for enhanced security.
+ * Works in both client-side (browser) and server-side (Node.js) environments.
+ *
+ * @param config - OAuth client configuration
+ * @returns OAuth client instance
+ *
+ * @example
+ * ```ts
+ * import { createOAuthClient } from '@draftlab/auth/toolkit/client'
+ * import { GitHubStrategy, GoogleStrategy } from '@draftlab/auth/toolkit/providers'
+ *
+ * const client = createOAuthClient({
+ *   providers: {
+ *     github: {
+ *       strategy: GitHubStrategy,
+ *       clientId: 'YOUR_CLIENT_ID',
+ *       clientSecret: 'YOUR_CLIENT_SECRET',
+ *       redirectUri: 'http://localhost:3000/auth/callback'
+ *     },
+ *     google: {
+ *       strategy: GoogleStrategy,
+ *       clientId: 'YOUR_CLIENT_ID',
+ *       clientSecret: 'YOUR_CLIENT_SECRET',
+ *       redirectUri: 'http://localhost:3000/auth/callback',
+ *       scopes: ['openid', 'email', 'profile']
+ *     }
+ *   }
+ * })
+ *
+ * // Initiate login
+ * const { url } = await client.authorize('github')
+ *
+ * // Handle callback
+ * const result = await client.handleCallback(callbackUrl)
+ * ```
+ */
+export declare const createOAuthClient: <TProviders extends Record<string, ProviderConfig<OAuthStrategy>>>(config: OAuthClientConfig<TProviders>) => OAuthClient<TProviders>;
+//# sourceMappingURL=client.d.ts.map

package/dist/types/toolkit/client.d.ts.map

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

package/dist/types/toolkit/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * DraftAuth Toolkit - Lightweight OAuth 2.0 Client
+ *
+ * A simple, framework-agnostic OAuth 2.0 client with PKCE support.
+ * Works in both client-side (browser) and server-side (Node.js) environments.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```ts
+ * // Quick Start - Client-side SPA
+ * import { createOAuthClient, GitHubStrategy, createSessionStorage } from '@draftlab/auth/toolkit'
+ *
+ * const client = createOAuthClient({
+ *   providers: {
+ *     github: {
+ *       strategy: GitHubStrategy,
+ *       clientId: 'YOUR_CLIENT_ID',
+ *       clientSecret: 'YOUR_CLIENT_SECRET',
+ *       redirectUri: 'http://localhost:3000/auth/callback'
+ *     }
+ *   },
+ *   storage: createSessionStorage()
+ * })
+ *
+ * // Login
+ * const { url } = await client.authorize('github')
+ * window.location.href = url
+ *
+ * // Callback
+ * const result = await client.handleCallback(window.location.href)
+ * console.log(result.accessToken)
+ * ```
+ */
+export { generatePKCE } from "../pkce";
+export type { AuthorizeOptions, CallbackResult, OAuthClient, OAuthClientConfig, ProviderConfig } from "./client";
+export { createOAuthClient } from "./client";
+export { FacebookStrategy } from "./providers/facebook";
+export { GitHubStrategy } from "./providers/github";
+export { GoogleStrategy } from "./providers/google";
+export type { OAuth2TokenResponse, OAuthStrategy } from "./providers/strategy";
+export type { AuthStorage, PKCEState } from "./storage";
+export { createCookieStorage, createLocalStorage, createMemoryStorage, createSessionStorage } from "./storage";
+export { generateSecureRandom } from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/toolkit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toolkit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,YAAY,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,MAAM,UAAU,CAAA;AAEjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC9E,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAEvD,OAAO,EACN,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA"}

package/dist/types/toolkit/providers/facebook.d.ts

@@ -0,0 +1,8 @@
+import type { OAuthStrategy } from "./strategy";
+/**
+ * Facebook OAuth 2.0 strategy.
+ *
+ * @see https://developers.facebook.com/docs/facebook-login/guides/advanced/manual-flow
+ */
+export declare const FacebookStrategy: OAuthStrategy;
+//# sourceMappingURL=facebook.d.ts.map

package/dist/types/toolkit/providers/facebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facebook.d.ts","sourceRoot":"","sources":["../../../../src/toolkit/providers/facebook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAM9B,CAAA"}

package/dist/types/toolkit/providers/github.d.ts

@@ -0,0 +1,8 @@
+import type { OAuthStrategy } from "./strategy";
+/**
+ * GitHub OAuth 2.0 strategy.
+ *
+ * @see https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps
+ */
+export declare const GitHubStrategy: OAuthStrategy;
+//# sourceMappingURL=github.d.ts.map

package/dist/types/toolkit/providers/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../../src/toolkit/providers/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,aAM5B,CAAA"}

package/dist/types/toolkit/providers/google.d.ts

@@ -0,0 +1,8 @@
+import type { OAuthStrategy } from "./strategy";
+/**
+ * Google OAuth 2.0 / OpenID Connect strategy.
+ *
+ * @see https://developers.google.com/identity/protocols/oauth2
+ */
+export declare const GoogleStrategy: OAuthStrategy;
+//# sourceMappingURL=google.d.ts.map

package/dist/types/toolkit/providers/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../../src/toolkit/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,aAM5B,CAAA"}

package/dist/types/toolkit/providers/strategy.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OAuth 2.0 strategy interface and types for provider configurations.
+ */
+/**
+ * OAuth 2.0 token response from provider's token endpoint.
+ * Based on RFC 6749 Section 5.1.
+ */
+export interface OAuth2TokenResponse {
+    /** The access token issued by the authorization server */
+    access_token: string;
+    /** The type of token (usually "Bearer") */
+    token_type?: string;
+    /** The lifetime in seconds of the access token */
+    expires_in?: number;
+    /** The refresh token for obtaining new access tokens */
+    refresh_token?: string;
+    /** The scope of the access token (space-separated list) */
+    scope?: string;
+    /** OpenID Connect ID token (JWT) */
+    id_token?: string;
+}
+/**
+ * OAuth 2.0 provider strategy definition.
+ * Defines the endpoints and default configuration for an OAuth provider.
+ */
+export interface OAuthStrategy {
+    /** Provider name (e.g., "github", "google") */
+    readonly name: string;
+    /** OAuth authorization endpoint URL */
+    readonly authorizationEndpoint: string;
+    /** OAuth token exchange endpoint URL */
+    readonly tokenEndpoint: string;
+    /** Optional user info endpoint URL (for OpenID Connect) */
+    readonly userInfoEndpoint?: string;
+    /** Default scopes to request */
+    readonly scopes: string[];
+}
+//# sourceMappingURL=strategy.d.ts.map

package/dist/types/toolkit/providers/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../../src/toolkit/providers/strategy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CACzB"}