@brokr/sdk 1.0.0 → 2.0.0

package/dist/src/react/styles-entry.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function BrokrStyles(): React.JSX.Element;
+export { BROKR_GLOBAL_CSS } from './styles';
+//# sourceMappingURL=styles-entry.d.ts.map

package/dist/src/react/styles-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-entry.d.ts","sourceRoot":"","sources":["../../../src/react/styles-entry.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,wBAAgB,WAAW,sBAE1B;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/react/styles.d.ts

@@ -0,0 +1,2 @@
+export { BROKR_GLOBAL_CSS, createBrokrCSS } from './css/index';
+//# sourceMappingURL=styles.d.ts.map

package/dist/src/react/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/react/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/react/theme-entry.d.ts

@@ -0,0 +1,3 @@
+export { defaultBrokrTheme, getBrokrRootStyle, resolveBrokrTheme } from './theme';
+export { defineBrokrTheme, type BrokrThemeColors, type BrokrThemeDef, type BrokrThemeMode, type BrokrThemeRadii, type BrokrThemeResolved, } from './types';
+//# sourceMappingURL=theme-entry.d.ts.map

package/dist/src/react/theme-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-entry.d.ts","sourceRoot":"","sources":["../../../src/react/theme-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC"}

package/dist/src/react/theme.d.ts

@@ -0,0 +1,6 @@
+import type { CSSProperties } from 'react';
+import { type BrokrThemeDef, type BrokrThemeResolved } from './types';
+export declare const defaultBrokrTheme: BrokrThemeDef;
+export declare function resolveBrokrTheme(theme: BrokrThemeDef, mode: 'light' | 'dark'): BrokrThemeResolved;
+export declare function getBrokrRootStyle(theme: BrokrThemeResolved): CSSProperties;
+//# sourceMappingURL=theme.d.ts.map

package/dist/src/react/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/react/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIxF,eAAO,MAAM,iBAAiB,eA2C5B,CAAC;AAEH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,kBAAkB,CAEpB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CA0B1E"}

package/dist/src/react/types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Brokr SDK — React type contracts
+ *
+ * *** CODEX CONTRACT ***
+ *
+ * These types define the exact shape that BrokrProvider exposes via context,
+ * the theme system, and the gate component props. Codex builds the React
+ * components; this file is their source of truth.
+ *
+ * DO NOT modify these types without coordinating with the UI track.
+ */
+import type { UserPlan, EntitlementMap, PlanCatalogEntry, BillingSummary } from '../payments/types';
+import type { BrokrConfig } from './config';
+export interface BrokrUser {
+    id: string;
+    email: string;
+    name?: string;
+    image?: string;
+    emailVerified: boolean;
+}
+export interface BrokrSession {
+    id: string;
+    /** When the session was created. */
+    createdAt: Date;
+    /** When the session expires. */
+    expiresAt: Date;
+    /** User agent string (browser/device info). */
+    userAgent?: string;
+    /** IP address (last known). */
+    ipAddress?: string;
+    /** Whether this is the current session. */
+    isCurrent: boolean;
+}
+export interface SignInParams {
+    email: string;
+    password: string;
+}
+export interface SignUpParams {
+    email: string;
+    password: string;
+    name?: string;
+}
+/**
+ * The shape exposed by BrokrProvider via React context.
+ *
+ * Design principles:
+ * - Provider owns cross-cutting state: auth, theme, billing, entitlements.
+ * - Only UI-facing data and actions — no raw API responses.
+ * - Composite components (FabAI, SmartUpload, FeedbackWidget) are self-contained
+ *   but context-aware — they read from this context, they don't add to it.
+ */
+export interface BrokrContextValue {
+    user: BrokrUser | null;
+    session: {
+        sessionId: string;
+        expiresAt: Date;
+    } | null;
+    isLoaded: boolean;
+    /** Current user's plan. */
+    plan: UserPlan | null;
+    /** Full plan catalog for UI (Plans grid, upgrade prompts). */
+    plans: PlanCatalogEntry[];
+    /** Per-feature entitlement map. */
+    entitlements: EntitlementMap | null;
+    /** Billing summary (payment method, balance, auto-reload). */
+    billing: BillingSummary | null;
+    /** Whether payments are in sandbox or live mode. */
+    paymentsMode: 'sandbox' | 'live' | null;
+    /** Active sessions for the current user (for AccountPanel). */
+    sessions: BrokrSession[];
+    theme: BrokrThemeResolved;
+    mode: 'light' | 'dark';
+    config?: BrokrConfig;
+    signIn: (params: SignInParams) => Promise<void>;
+    signUp: (params: SignUpParams) => Promise<void>;
+    signOut: () => Promise<void>;
+    /** Update user profile fields (name, etc.). Refreshes context.user on success. */
+    updateProfile: (params: {
+        name?: string;
+    }) => Promise<void>;
+    /** Upload and set a new profile photo. Refreshes context.user.image on success. */
+    updateProfilePhoto: (file: File) => Promise<void>;
+    /** Revoke a specific session by ID. Refreshes context.sessions. */
+    revokeSession: (sessionId: string) => Promise<void>;
+    /** Revoke all sessions except the current one. Refreshes context.sessions. */
+    revokeOtherSessions: () => Promise<void>;
+    /** Start checkout for a plan. Returns checkout URL — caller should redirect. */
+    checkout: (params: {
+        plan: string;
+    }) => Promise<string>;
+    /** Open Stripe Customer Portal. Returns portal URL — caller should redirect. */
+    portal: () => Promise<string>;
+    /** Check if current user has access to a feature. Synchronous, reads from context. */
+    can: (feature: string) => boolean;
+    /** Get usage stats for a metered feature. Synchronous, reads from context. */
+    usage: (feature: string) => {
+        used: number;
+        limit: number | null;
+        remaining: number | null;
+    } | null;
+    /** Re-fetch all context state (auth, billing). Call after external changes. */
+    refresh: () => Promise<void>;
+    /** Fetch active sessions list. Only call from account/settings UI — not on every page. */
+    refreshSessions: () => Promise<void>;
+}
+export interface BrokrThemeColors {
+    bg: string;
+    surface: string;
+    surfaceMuted: string;
+    textPrimary: string;
+    textSecondary: string;
+    border: string;
+    primary: string;
+    primaryContrast: string;
+    /** Optional semantic color for error states. If omitted, use primary at reduced opacity. */
+    error?: string;
+    /** Optional semantic color for success states. If omitted, use primary at reduced opacity. */
+    success?: string;
+    /** Optional semantic color for warning states. If omitted, use primary at reduced opacity. */
+    warning?: string;
+    /** Toast background. Defaults to #ffffff (white in both modes — pops against any background). */
+    toastBg?: string;
+    /** Toast text color. Defaults to #0a0a0a. */
+    toastText?: string;
+    /** Toast secondary text color. Defaults to #52525b. */
+    toastTextSecondary?: string;
+    /** Toast border color. Defaults to #e4e4e7. */
+    toastBorder?: string;
+}
+export interface BrokrThemeRadii {
+    card: number;
+    input: number;
+    button: number;
+}
+export interface BrokrThemeMode {
+    brand: {
+        name: string;
+        logo?: string;
+    };
+    auth?: {
+        variant?: number | `${number}`;
+        heroImage?: string;
+        heroText?: string;
+    };
+    colors: BrokrThemeColors;
+    radii: BrokrThemeRadii;
+}
+export interface BrokrThemeDef {
+    light: BrokrThemeMode;
+    dark: BrokrThemeMode;
+}
+/** The resolved theme for the current mode (light or dark). */
+export type BrokrThemeResolved = BrokrThemeMode;
+/**
+ * Define the Brokr theme for your app.
+ * Type-checked passthrough — used by BrokrProvider to resolve the current mode.
+ */
+export declare function defineBrokrTheme(def: BrokrThemeDef): BrokrThemeDef;
+/**
+ * Gate fallback modes (v1).
+ *
+ * Only modes we actually ship primitives for. No modal/toast until
+ * the SDK owns those primitives.
+ *
+ * - 'redirect'     — router.push(redirectTo)
+ * - 'upgrade-card' — inline card with plan comparison + CTA
+ * - 'hidden'       — render nothing (no visual feedback)
+ * - React.ReactNode — custom fallback UI
+ */
+export type GateFallback = 'redirect' | 'upgrade-card' | 'hidden' | React.ReactNode;
+export interface GateProps {
+    /** What to show when the gate blocks access. */
+    fallback?: GateFallback;
+    /** Custom message for the fallback UI. */
+    message?: string;
+    /** Redirect destination (used when fallback='redirect'). */
+    redirectTo?: string;
+    children: React.ReactNode;
+}
+export interface RequirePlanProps extends GateProps {
+    /** Plan slugs that grant access. */
+    plans: string[];
+}
+export interface UsageGateProps extends GateProps {
+    /** Feature slug to check usage for. */
+    feature: string;
+    /** Minimum remaining usage required (default: 1). */
+    min?: number;
+}
+export type { UserPlan, EntitlementMap, PlanCatalogEntry, BillingSummary, } from '../payments/types';
+//# sourceMappingURL=types.d.ts.map

package/dist/src/react/types.d.ts.map

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

package/dist/src/react/use-brokr-theme.d.ts

@@ -0,0 +1,6 @@
+import type { BrokrThemeResolved } from './types';
+export declare function useBrokrTheme(): {
+    theme: BrokrThemeResolved;
+    mode: 'light' | 'dark';
+};
+//# sourceMappingURL=use-brokr-theme.d.ts.map

package/dist/src/react/use-brokr-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brokr-theme.d.ts","sourceRoot":"","sources":["../../../src/react/use-brokr-theme.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,wBAAgB,aAAa,IAAI;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAGrF"}

package/dist/src/runtime.d.ts

@@ -11,207 +11,96 @@
  * import { createBrokr } from '@brokr/sdk';
  * export const brokr = createBrokr();
  *
- * // anywhere in your app
- * const reply = await brokr.ai.chat([{ role: 'user', content: 'Hello' }]);
- * const { key } = await brokr.storage.upload(file, 'avatar.png', 'image/png');
- * await brokr.email.send({ to: 'user@example.com', subject: 'Hi', html: '<p>Hey</p>' });
+ * // Root aliases
+ * const reply = await brokr.chat('Explain quantum computing');
+ * const file  = await brokr.upload({ file: buffer, path: 'photo.jpg' });
+ * const { checkoutUrl } = await brokr.purchase({ plan: 'pro' });
+ *
+ * // Namespaces
+ * const data = await brokr.ai.structured({ prompt: '...', schema: { ... } });
+ * await brokr.email.sendTemplate({ template: 'welcome', to: '...', variables: { ... } });
  * ```
  */
-export declare const GATEWAY_URL = "https://api.brokr.sh";
-export declare class BrokrError extends Error {
-    readonly code: string;
-    readonly capability?: string | undefined;
-    readonly retryable: boolean;
-    constructor(message: string, code: string, capability?: string | undefined, retryable?: boolean);
-}
-/** Thrown when BROKR_TOKEN is missing or invalid. */
-export declare class BrokrAuthError extends BrokrError {
-    constructor(message: string, code: string);
-}
-/** Thrown on HTTP 429 — includes `retryAfter` seconds from the Retry-After header. */
-export declare class BrokrRateLimitError extends BrokrError {
-    readonly retryAfter: number;
-    constructor(message: string, retryAfter: number, capability?: string);
-}
-/** Thrown when the Brokr gateway is unreachable. */
-export declare class BrokrNetworkError extends BrokrError {
-    constructor(message: string, capability?: string);
-}
-/** Convenience model aliases for common use cases. */
-export declare const models: {
-    /** Cheapest and fastest model (Deepseek Chat). */
-    readonly FAST: "deepseek-chat";
-    /** Most capable model. */
-    readonly SMART: "claude-sonnet-4-20250514";
-    /** Default balanced model (Deepseek Chat). */
-    readonly BALANCED: "deepseek-chat";
-};
-export interface ChatMessage {
-    role: 'user' | 'assistant' | 'system';
-    content: string;
-}
-export interface ChatOptions {
-    model?: string;
-    maxTokens?: number;
-    temperature?: number;
-}
-export interface ChatResponse {
-    content: string;
-    model: string;
-    usage: {
-        promptTokens: number;
-        completionTokens: number;
-    };
-}
-export interface UploadResult {
-    /** The stable object key — use this to retrieve the file later. */
-    key: string;
-}
-export interface EmailParams {
-    to: string | string[];
-    subject: string;
-    html?: string;
-    text?: string;
-    /**
-     * Override the from address. Must be on your stack's verified domain.
-     * Defaults to noreply@{your stack domain}.
-     */
-    from?: string;
-}
+import { BrokrAIClient } from './ai/client';
+import { BrokrStorageClient } from './storage/client';
+import { BrokrEmailClient } from './email/client';
+import { BrokrFilesClient } from './files/client';
+import { BrokrPaymentsClient } from './payments/client';
+import { BrokrEntitlementsClient } from './payments/entitlements';
+import { BrokrNotificationsClient } from './notifications/client';
+import { BrokrAuthClient } from './auth';
+import type { ChatInput, ChatOptions, ChatResponse } from './ai/types';
+import type { UploadParams } from './storage/types';
+import type { UploadedFile } from './storage/types';
+import type { CheckoutResult } from './payments/types';
+export { GATEWAY_URL } from './gateway';
+export { detectEnv, isDev, isStaging, isProd } from './env-detect';
+export type { BrokrEnv } from './env-detect';
+export { BrokrError, BrokrAuthError, BrokrRateLimitError, BrokrNetworkError, BrokrTimeoutError, BrokrNotFoundError, BrokrValidationError } from './errors';
+export { models } from './models';
+export { BrokrAIClient } from './ai/client';
+export { BrokrStorageClient } from './storage/client';
+export { BrokrEmailClient } from './email/client';
+export { BrokrFilesClient } from './files/client';
+export { BrokrPaymentsClient } from './payments/client';
+export { BrokrEntitlementsClient } from './payments/entitlements';
+export { BrokrNotificationsClient } from './notifications/client';
+export type { ChatMessage, ChatOptions, ChatResponse, ChatInput, ChatContentPart } from './ai/types';
+export type { StorageFile, UploadedFile, UploadParams, UploadResult } from './storage/types';
+export type { EmailParams, SendTemplateParams } from './email/types';
+export type { CheckoutResult, PortalResult, UserPlan, EntitlementMap, PaymentsConfig, GatingContext, PlanCatalogEntry, BillingSummary } from './payments/types';
+export type { Notification } from './notifications/types';
+export type { SendParams as NotificationSendParams, ListParams as NotificationListParams } from './notifications/client';
 export interface RuntimeOptions {
     /** Override the BROKR_TOKEN env var. Useful for testing. */
     token?: string;
     /** Override the gateway URL. Defaults to https://api.brokr.sh */
     gatewayUrl?: string;
 }
-export declare class BrokrAIClient {
-    private readonly _token;
-    private readonly _gatewayUrl;
-    constructor(_token: string | undefined, _gatewayUrl: string);
-    /**
-     * Send a chat completion request.
-     *
-     * @example
-     * ```typescript
-     * const reply = await brokr.ai.chat([
-     *   { role: 'user', content: 'Explain quantum computing in one sentence.' }
-     * ]);
-     * console.log(reply.content);
-     * ```
-     */
-    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
-    /**
-     * Stream a chat completion. Yields text strings directly.
-     *
-     * @example
-     * ```typescript
-     * for await (const text of brokr.ai.stream(messages)) {
-     *   process.stdout.write(text);
-     * }
-     * ```
-     */
-    stream(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<string>;
-    /**
-     * OpenAI-SDK compatible base URL.
-     *
-     * @example
-     * ```typescript
-     * const openai = new OpenAI({ baseURL: brokr.ai.baseURL, apiKey: brokr.ai.apiKey });
-     * ```
-     */
-    get baseURL(): string;
-    /** Use as `apiKey` with the official OpenAI SDK to route through Brokr's gateway. */
-    get apiKey(): string;
-}
-export declare class BrokrStorageClient {
-    private readonly _token;
-    private readonly _gatewayUrl;
-    constructor(_token: string | undefined, _gatewayUrl: string);
-    /**
-     * Get a presigned upload URL for browser-direct or streaming uploads.
-     *
-     * @example
-     * ```typescript
-     * const { url, key } = await brokr.storage.getUploadUrl('avatar.png', 'image/png');
-     * await fetch(url, { method: 'PUT', body: file });
-     * ```
-     */
-    getUploadUrl(filename: string, contentType?: string): Promise<{
-        url: string;
-        key: string;
-    }>;
-    /**
-     * Upload data to R2. Returns the stable object key.
-     *
-     * @example
-     * ```typescript
-     * const { key } = await brokr.storage.upload(fileBuffer, 'photo.jpg', 'image/jpeg');
-     * ```
-     */
-    upload(data: Uint8Array | string | Blob, filename: string, contentType?: string): Promise<UploadResult>;
-    /**
-     * Get a presigned download URL for a stored object.
-     *
-     * @example
-     * ```typescript
-     * const { url } = await brokr.storage.url('photos/avatar.jpg');
-     * // use url in <img src={url} /> or redirect
-     * ```
-     */
-    url(key: string, options?: {
-        expiresIn?: number;
-    }): Promise<{
-        url: string;
-    }>;
-    /** @deprecated Use `url()` instead. */
-    getUrl(key: string, options?: {
-        expiresIn?: number;
-    }): Promise<{
-        url: string;
-    }>;
-}
-export declare class BrokrEmailClient {
+export declare class BrokrRuntime {
     private readonly _token;
     private readonly _gatewayUrl;
-    constructor(_token: string | undefined, _gatewayUrl: string);
-    /**
-     * Send an email. The from address and API credentials are resolved server-side.
-     *
-     * @example
-     * ```typescript
-     * await brokr.email.send({
-     *   to: 'user@example.com',
-     *   subject: 'Welcome!',
-     *   html: '<h1>Welcome to the app</h1>',
-     * });
-     * ```
-     */
-    send(params: EmailParams): Promise<{
-        id: string;
-    }>;
-}
-export declare class BrokrRuntime {
     readonly ai: BrokrAIClient;
     readonly storage: BrokrStorageClient;
     readonly email: BrokrEmailClient;
+    private _files;
+    private _payments;
+    private _entitlements;
+    private _notifications;
     private _auth;
-    private readonly _token;
-    private readonly _gatewayUrl;
     constructor(options?: RuntimeOptions);
-    /** Auth client — lazily initialized to avoid pulling in auth deps when not needed. */
-    get auth(): import('./auth').BrokrAuthClient;
+    /** Files client (upload + AI processing). */
+    get files(): BrokrFilesClient;
+    /** Payments client (checkout, portal, plan queries). */
+    get payments(): BrokrPaymentsClient;
+    /** Notifications client (send + list notifications). */
+    get notifications(): BrokrNotificationsClient;
+    /** Entitlements client (feature checks, usage queries). */
+    get entitlements(): BrokrEntitlementsClient;
+    /** Auth client — lazily initialized. */
+    get auth(): BrokrAuthClient;
+    /** Send a chat message. Alias for `brokr.ai.chat()`. */
+    chat(input: ChatInput, options?: ChatOptions): Promise<ChatResponse>;
+    /** Upload a file. Alias for `brokr.storage.upload()`. */
+    upload(params: UploadParams): Promise<UploadedFile>;
+    /** Start a checkout flow. Alias for `brokr.payments.checkout()`. */
+    checkout(params: {
+        plan: string;
+        userId: string;
+        returnUrl?: string;
+    }): Promise<CheckoutResult>;
+    /** Start a checkout flow. Alias for `brokr.checkout()` — north star one-liner. */
+    purchase(params: {
+        plan: string;
+        userId: string;
+        returnUrl?: string;
+    }): Promise<CheckoutResult>;
 }
 /**
  * Create a Brokr runtime client. Zero config required.
  *
  * BROKR_TOKEN is injected automatically at deploy time.
  * For local development, run: brokr env pull --stack <name>
- *
- * @example
- * ```typescript
- * import { createBrokr } from '@brokr/sdk';
- * export const brokr = createBrokr();
- * ```
  */
 export declare function createBrokr(options?: RuntimeOptions): BrokrRuntime;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/src/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAMlD,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,UAAU,CAAC,EAAE,MAAM;aACnB,SAAS;gBAHzB,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,SAAS,UAAQ;CAKpC;AAED,qDAAqD;AACrD,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAED,sFAAsF;AACtF,qBAAa,mBAAoB,SAAQ,UAAU;aAG/B,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClC,UAAU,CAAC,EAAE,MAAM;CAKtB;AAED,oDAAoD;AACpD,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAIjD;AAMD,sDAAsD;AACtD,eAAO,MAAM,MAAM;IACjB,kDAAkD;;IAElD,0BAA0B;;IAE1B,8CAA8C;;CAEtC,CAAC;AAsFX,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM;IAGtC;;;;;;;;;;OAUG;IACG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBjF;;;;;;;;;OASG;IACI,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC;IA6DrF;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,qFAAqF;IACrF,IAAI,MAAM,IAAI,MAAM,CAGnB;CACF;AAMD,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM;IAGtC;;;;;;;;OAQG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,SAA6B,GACvC,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAQxC;;;;;;;OAOG;IACG,MAAM,CACV,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,EAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,SAA6B,GACvC,OAAO,CAAC,YAAY,CAAC;IAiBxB;;;;;;;;OAQG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAQlF,uCAAuC;IACjC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAGtF;AAMD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM;IAGtC;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAMzD;AAMD,qBAAa,YAAY;IACvB,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAEjC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,CAAC,EAAE,cAAc;IASpC,sFAAsF;IACtF,IAAI,IAAI,IAAI,OAAO,QAAQ,EAAE,eAAe,CAQ3C;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,YAAY,CAElE"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"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"}