@multiplatform.one/frappe 6.1.0 → 6.4.0

package/types/devtools/plugin.d.ts

@@ -0,0 +1,9 @@
+import type { SyncModule } from "../sync";
+export declare function frappeDevtoolsPlugin(syncModule: SyncModule): {
+    id: string;
+    name: string;
+    render: (_el: HTMLElement, props: {
+        theme: "dark" | "light";
+    }) => import("react/jsx-runtime").JSX.Element;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/types/devtools/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/devtools/plugin.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU;;;kBAIzC,WAAW,SAAS;QAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;EAIhE"}

package/types/devtools/theme.d.ts

@@ -0,0 +1,15 @@
+export interface PanelTheme {
+    bg: string;
+    bgSubtle: string;
+    bgHover: string;
+    text: string;
+    textSecondary: string;
+    border: string;
+    accent: string;
+    success: string;
+    warning: string;
+    error: string;
+    pending: string;
+}
+export declare const themes: Record<"light" | "dark", PanelTheme>;
+//# sourceMappingURL=theme.d.ts.map

package/types/devtools/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/devtools/theme.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,UAAU,CA2BvD,CAAC"}

package/types/doctype.d.ts

@@ -0,0 +1,256 @@
+/**
+ * DocType metadata hooks for @multiplatform.one/frappe
+ *
+ * Provides hooks for fetching and caching DocType schemas, searching linked
+ * documents, and searching across DocTypes for navigation (Awesomebar).
+ */
+import type { FrappeConnectionConfig } from "./pacer";
+/** All Frappe field type strings */
+export type FrappeFieldType = "Autocomplete" | "Attach" | "Attach Image" | "Barcode" | "Check" | "Code" | "Color" | "Column Break" | "Currency" | "Data" | "Date" | "Datetime" | "Duration" | "Dynamic Link" | "Float" | "Geolocation" | "HTML" | "HTML Editor" | "Heading" | "Icon" | "Image" | "Int" | "JSON" | "Link" | "Long Text" | "Markdown Editor" | "Password" | "Percent" | "Phone" | "Rating" | "Read Only" | "Section Break" | "Select" | "Signature" | "Small Text" | "Tab Break" | "Table" | "Table MultiSelect" | "Text" | "Text Editor" | "Time";
+/** Normalized DocType field descriptor */
+export interface DocTypeField {
+    fieldname: string;
+    fieldtype: FrappeFieldType;
+    label?: string;
+    /** Link target DocType, Select options, or Table child DocType */
+    options?: string;
+    reqd?: boolean;
+    unique?: boolean;
+    default?: string;
+    /** Conditional visibility expression (e.g. `eval:doc.status=="Active"`) */
+    depends_on?: string;
+    read_only?: boolean;
+    hidden?: boolean;
+    in_list_view?: boolean;
+    in_standard_filter?: boolean;
+    description?: string;
+    length?: number;
+    precision?: number;
+    /** For Link fields: comma-separated search fields */
+    search_fields?: string;
+    /** For Section Break fields: whether the section is collapsible */
+    collapsible?: boolean;
+}
+/** DocType permission entry */
+export interface DocTypePermission {
+    role: string;
+    read?: boolean;
+    write?: boolean;
+    create?: boolean;
+    delete?: boolean;
+    submit?: boolean;
+    cancel?: boolean;
+    amend?: boolean;
+}
+/** A column in a form section, containing an ordered list of fields */
+export interface FormColumn {
+    fields: DocTypeField[];
+}
+/** A section in the form layout, containing one or more columns */
+export interface FormSection {
+    label?: string;
+    collapsible?: boolean;
+    /** Whether this section represents a Tab Break */
+    tab?: boolean;
+    columns: FormColumn[];
+}
+/** Normalized DocType metadata */
+export interface DocTypeMeta {
+    name: string;
+    module: string;
+    title_field?: string;
+    image_field?: string;
+    is_tree?: boolean;
+    sort_field: string;
+    sort_order: string;
+    /** Flat list of all fields (ordered by field_order or position) */
+    fields: DocTypeField[];
+    /** Parsed layout tree from Section Break / Column Break / Tab Break fields */
+    sections: FormSection[];
+    permissions: DocTypePermission[];
+}
+/** A search result for a Link field */
+export interface LinkSearchResult {
+    /** The document name (ID) */
+    value: string;
+    /** The display label (server `label` when the doctype shows its title in links, else the name) */
+    label: string;
+    /** Ranked description from the server (title field / matched context), like stock Frappe */
+    description?: string;
+}
+/** Options for the `useLinkSearch` hook */
+export interface LinkSearchOptions {
+    /** Search query text */
+    query?: string;
+    /**
+     * Restrict matching to one field (maps to `search_link`'s `searchfield`).
+     * Extra entries are ignored — the server owns multi-field ranking now.
+     */
+    searchFields?: string[];
+    /** Additional Frappe filters (server-side, on top of the doctype's link query) */
+    filters?: Record<string, unknown> | Array<[string, string, unknown]>;
+    /** Maximum results / `page_length` (default 20) */
+    limit?: number;
+    /**
+     * Fetch the first page when the query is empty (stock Frappe behavior on
+     * focus). Default false: empty query returns no results and no request.
+     */
+    allowEmptyQuery?: boolean;
+    /** Gate searching entirely (e.g. only while the picker is open). Default true. */
+    enabled?: boolean;
+    /** Debounce before hitting the server, in ms (default 300) */
+    debounceMs?: number;
+    /** Doctype of the form the link sits on (server `reference_doctype`, feeds link queries) */
+    referenceDoctype?: string;
+}
+/** A navigation suggestion from DocType search */
+export interface DocTypeSearchResult {
+    /** Display label (e.g. "Pokemon List", "New Pokemon") */
+    label: string;
+    /** The DocType name */
+    doctype: string;
+    /** Suggestion type */
+    type: "list" | "report" | "new";
+}
+/**
+ * Parse a Frappe `depends_on` expression into an evaluable function.
+ *
+ * Handles expressions like:
+ * - `eval:doc.status=="Active"` — JS expression with `doc` bound
+ * - `doc.field_name` — truthy check on a field value
+ * - `eval:doc.field1 && doc.field2` — compound boolean
+ *
+ * @param expression - The depends_on expression string, or undefined
+ * @returns A function that evaluates the expression given a document object
+ */
+export declare function parseDependsOn(expression?: string): (doc: Record<string, unknown>) => boolean;
+/**
+ * Parse a flat array of DocType fields into a structured `FormSection[]` layout.
+ *
+ * Algorithm:
+ * 1. Start with an implicit first section (no label) containing one column.
+ * 2. `Section Break` → start a new section.
+ * 3. `Column Break` → start a new column within the current section.
+ * 4. `Tab Break` → start a new section with `tab: true`.
+ * 5. All other fields → add to the current column (skip hidden fields).
+ * 6. Drop empty leading sections (see below) so meta that begins with a
+ *    Section Break doesn't produce an empty card before the first real one.
+ *
+ * @param fields - Flat list of DocType fields, ordered by field_order or position
+ * @returns Structured layout tree of sections and columns
+ */
+export declare function parseFormLayout(fields: DocTypeField[]): FormSection[];
+/**
+ * Fetch and cache DocType metadata (schema, fields, layout, permissions).
+ *
+ * Responses are cached per-session in memory keyed by `{baseURL}:{doctype}`.
+ * The `refetch` function clears the cache entry and forces a fresh fetch.
+ *
+ * @param config - Frappe connection config, or undefined to disable
+ * @param doctype - The DocType name to fetch metadata for
+ * @returns `{ meta, isLoading, error, refetch }`
+ *
+ * @example
+ * ```tsx
+ * function PokemonForm() {
+ *   const { meta, isLoading } = useDocTypeMeta(config, "Pokemon");
+ *   if (isLoading) return <Spinner />;
+ *   return meta?.sections.map(section => (
+ *     <FormSection key={section.label} section={section} />
+ *   ));
+ * }
+ * ```
+ */
+export declare function useDocTypeMeta(config: FrappeConnectionConfig | undefined, doctype: string): {
+    meta: DocTypeMeta | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+/**
+ * Debounced backend search for Link field suggestions — the same server
+ * search stock Frappe's link control uses.
+ *
+ * Calls `GET /api/method/frappe.desk.search.search_link` (doctype + txt +
+ * filters + page_length) with a 300ms debounce, returning the server's
+ * ranked `{value, description, label?}` pairs. The endpoint enforces
+ * permissions and the doctype's link/`get_query` conditions server-side.
+ *
+ * @param config - Frappe connection config, or undefined to disable
+ * @param doctype - The target DocType to search within
+ * @param options - Search options (query, filters, limit, enabled, allowEmptyQuery, debounceMs)
+ * @returns `{ results, isLoading, error }`
+ *
+ * @example
+ * ```tsx
+ * function SpeciesLink() {
+ *   const [text, setText] = useState("");
+ *   const { results, isLoading } = useLinkSearch(config, "Poke Species", {
+ *     query: text,
+ *     limit: 10,
+ *   });
+ *   return (
+ *     <div>
+ *       <input value={text} onChange={e => setText(e.target.value)} />
+ *       {isLoading && <span>Searching...</span>}
+ *       {results.map(r => <div key={r.value}>{r.label}</div>)}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useLinkSearch(config: FrappeConnectionConfig | undefined, doctype: string, options?: LinkSearchOptions): {
+    results: LinkSearchResult[];
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Fetch the display title for an existing Link value (foreign key) — what
+ * stock Frappe does on form load so a saved link shows its label before any
+ * search has run.
+ *
+ * Calls `frappe.desk.search.get_link_title`, which resolves the doctype's
+ * `title_field` server-side (returns the plain name when the doctype does
+ * not show titles in links). Results are cached per session; failures fall
+ * back to the raw name so the field never renders empty.
+ *
+ * @param config - Frappe connection config, or undefined to disable
+ * @param doctype - The Link's target DocType
+ * @param name - The linked document name (current field value)
+ * @returns `{ title, isLoading }` — `title` is undefined while nothing is known
+ */
+export declare function useLinkTitle(config: FrappeConnectionConfig | undefined, doctype: string, name: string | undefined): {
+    title: string | undefined;
+    isLoading: boolean;
+};
+/**
+ * Search across all DocType names for Awesomebar navigation.
+ *
+ * Fetches and caches the full list of DocTypes, then filters locally
+ * for instant results. Returns navigation suggestions in the format:
+ * "{name} List", "{name} Report", "New {name}".
+ *
+ * @param config - Frappe connection config, or undefined to disable
+ * @param query - Search query string
+ * @returns `{ results, isLoading, error }`
+ *
+ * @example
+ * ```tsx
+ * function Awesomebar() {
+ *   const [text, setText] = useState("");
+ *   const { results } = useDocTypeSearch(config, text);
+ *   return (
+ *     <div>
+ *       <input value={text} onChange={e => setText(e.target.value)} />
+ *       {results.map(r => <div key={r.label}>{r.label}</div>)}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useDocTypeSearch(config: FrappeConnectionConfig | undefined, query: string): {
+    results: DocTypeSearchResult[];
+    isLoading: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=doctype.d.ts.map

package/types/doctype.d.ts.map

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

package/types/file.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient } from "./core/http";
+export type UploadArgs = {
+    isPrivate?: boolean;
+    folder?: string;
+    file_url?: string;
+    doctype?: string;
+    docname?: string;
+    fieldname?: string;
+};
+export declare class FileModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    uploadFile(file: File | Blob, args: UploadArgs, _onProgress?: (completed: number, total: number) => void): Promise<import("./core/http").HttpResponse<unknown>>;
+}
+//# sourceMappingURL=file.d.ts.map

package/types/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B,UAAU,CACR,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI;CAS3D"}

package/types/fixtureDb.d.ts

@@ -0,0 +1,76 @@
+/**
+ * DbModule adapter backed by a FixtureProvider.
+ *
+ * Implements the same interface as DbModule so that SyncModule works
+ * identically whether data comes from a live Frappe server or in-memory
+ * fixtures. This means virtual pagination, progressive cache, mutation
+ * journal, and devtools all work in fixture/Storybook mode.
+ */
+import type { FrappeDoc, FrappeDocData } from "./common/types";
+import type { ListOptions } from "./core/types";
+import type { BackfillArgs, BackfillResponse } from "./db";
+import type { FixtureProvider } from "./fixtures";
+import type { OrderBy } from "./sync/types";
+export declare class FixtureDbModule {
+    private readonly fixtures;
+    constructor(fixtures: FixtureProvider);
+    getAppName(): string | undefined;
+    getEndpoints(): {
+        createDoc: string;
+        updateDoc: string;
+        deleteDoc: string;
+        backfill: string;
+        getListWithCursor: string;
+        batchMutations: string;
+        listSince: string;
+    };
+    getDoc<Data extends FrappeDocData>(doctype: string, name: string): Promise<FrappeDoc<Data>>;
+    getDocVersion(_doctype: string, _name: string): Promise<string | undefined>;
+    getDocList<Data extends FrappeDocData>(doctype: string, options?: ListOptions): Promise<FrappeDoc<Data>[]>;
+    getCount(doctype: string, filters?: Array<[string, string, unknown]> | Record<string, unknown>): Promise<number>;
+    createDoc<Data extends FrappeDocData>(doc: Partial<FrappeDoc<Data>> & Pick<FrappeDoc<Data>, "doctype" | "name">): Promise<FrappeDoc<Data>>;
+    updateDoc<Data extends FrappeDocData>(doc: Partial<FrappeDoc<Data>> & Pick<FrappeDoc<Data>, "doctype" | "name">): Promise<FrappeDoc<Data>>;
+    deleteDoc<Data extends FrappeDocData>(doc: Pick<FrappeDoc<Data>, "doctype" | "name">): Promise<{
+        message: string;
+    }>;
+    renameDoc<Data extends FrappeDocData>(_doc: Pick<FrappeDoc<Data>, "doctype" | "name">, _newName: string, _merge?: boolean): Promise<{
+        message: string;
+    }>;
+    backfill<Data extends FrappeDocData>(args: BackfillArgs): Promise<BackfillResponse<Data>>;
+    getListWithCursor<Data extends FrappeDocData>(args: {
+        doctype: string;
+        fields?: readonly string[];
+        filters?: Array<[string, string, unknown]> | Record<string, unknown>;
+        cursor?: string | null;
+        limit?: number;
+        orderBy?: OrderBy;
+    }): Promise<{
+        data: FrappeDoc<Data>[];
+        next_cursor: any;
+    }>;
+    batchMutations<Data extends FrappeDocData>(args: {
+        mutations: Array<{
+            type: string;
+            doctype: string;
+            name?: string;
+            data?: Partial<Data>;
+        }>;
+        atomic?: boolean;
+    }): Promise<{
+        success: boolean;
+        data?: FrappeDocData;
+        error?: string;
+    }[]>;
+    listSince<Data extends FrappeDocData>(args: {
+        doctype: string;
+        modifiedAfter?: string;
+        fields?: readonly string[];
+        filters?: Array<[string, string, unknown]> | Record<string, unknown>;
+        limit?: number;
+    }): Promise<{
+        rows: FrappeDoc<Data>[];
+        deleted: string[];
+        checkpoint: string;
+    }>;
+}
+//# sourceMappingURL=fixtureDb.d.ts.map

package/types/fixtureDb.d.ts.map

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

package/types/fixtures.d.ts

@@ -0,0 +1,55 @@
+import type { FrappeDocData } from "./common/types";
+export interface FixtureDoc extends FrappeDocData {
+    name: string;
+    doctype: string;
+    [key: string]: any;
+}
+export type FixtureData = {
+    [doctype: string]: FixtureDoc[];
+};
+export interface FixtureProvider {
+    getList<TDoc extends FrappeDocData>(doctype: string, options?: {
+        fields?: readonly string[];
+        filters?: Partial<TDoc> | Array<[string, string, any]>;
+        orderBy?: {
+            field: string;
+            order: string;
+        } | Array<{
+            field: string;
+            order: string;
+        }>;
+        limitStart?: number;
+        limit?: number;
+    }): Promise<Partial<TDoc>[]>;
+    getDoc<TDoc extends FrappeDocData>(doctype: string, name: string, fields?: readonly string[]): Promise<Partial<TDoc> | null>;
+    createDoc<TDoc extends FrappeDocData>(doctype: string, doc: Partial<TDoc>): Promise<TDoc>;
+    updateDoc<TDoc extends FrappeDocData>(doctype: string, name: string, values: Partial<TDoc>): Promise<TDoc>;
+    deleteDoc(doctype: string, name: string): Promise<void>;
+}
+export declare class InMemoryFixtureProvider implements FixtureProvider {
+    private data;
+    constructor(fixtureData?: FixtureData);
+    getList<TDoc extends FrappeDocData>(doctype: string, options?: {
+        fields?: readonly string[];
+        filters?: Partial<TDoc> | Array<[string, string, any]>;
+        orderBy?: {
+            field: string;
+            order: string;
+        } | Array<{
+            field: string;
+            order: string;
+        }>;
+        limitStart?: number;
+        limit?: number;
+    }): Promise<Partial<TDoc>[]>;
+    getDoc<TDoc extends FrappeDocData>(doctype: string, name: string, fields?: readonly string[]): Promise<Partial<TDoc> | null>;
+    createDoc<TDoc extends FrappeDocData>(doctype: string, doc: Partial<TDoc>): Promise<TDoc>;
+    updateDoc<TDoc extends FrappeDocData>(doctype: string, name: string, values: Partial<TDoc>): Promise<TDoc>;
+    deleteDoc(doctype: string, name: string): Promise<void>;
+    private applyFilters;
+    private applyOrderBy;
+    private projectFields;
+    reset(fixtureData?: FixtureData): void;
+    getData(): FixtureData;
+}
+//# sourceMappingURL=fixtures.d.ts.map

package/types/fixtures.d.ts.map

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

package/types/frappeApp.d.ts

@@ -0,0 +1,45 @@
+import { AuthModule } from "./auth";
+import { CallModule } from "./call";
+import type { AuthConfig, CustomEndpoints, FrappeLiveConfig } from "./core/types";
+import { DbModule } from "./db";
+import { FileModule } from "./file";
+import { type RealtimeConfig, RealtimeModule } from "./realtime";
+import { SyncModule } from "./sync/index";
+export type FrappeConfig = AuthConfig & {
+    sessionId?: string;
+    credentials?: RequestCredentials;
+    realtimeOptions?: Partial<RealtimeConfig>;
+    /** Configuration for frappe_live extension endpoints */
+    frappeLive?: FrappeLiveConfig;
+    /**
+     * Raw cookie string forwarded on every HTTP request.
+     * Use this in SSR / Node.js where the browser cookie jar is unavailable.
+     *
+     * @example `"sid=abc123; system_user=yes"`
+     */
+    cookie?: string;
+};
+/**
+ * Main entry point for Frappe SDK
+ * Orchestrates all modules and provides unified API
+ */
+export declare class FrappeApp {
+    private http;
+    private _db;
+    private _auth;
+    private _call;
+    private _file;
+    private _realtime;
+    private _sync;
+    constructor(baseURL: string, auth?: FrappeConfig, customEndpoints?: CustomEndpoints);
+    db(): DbModule;
+    auth(): AuthModule;
+    call(): CallModule;
+    file(): FileModule;
+    realtime(): RealtimeModule;
+    sync(): SyncModule;
+    dispose(): Promise<void>;
+    getConfig(): FrappeConfig;
+    updateAuth(auth: FrappeConfig): Promise<void>;
+}
+//# sourceMappingURL=frappeApp.d.ts.map

package/types/frappeApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frappeApp.d.ts","sourceRoot":"","sources":["../src/frappeApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,KAAK,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,wDAAwD;IACxD,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAa;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,EAAE,eAAe,GAAE,eAAoB;IAqC3F,EAAE;IAGF,IAAI;IAGJ,IAAI;IAGJ,IAAI;IAGJ,QAAQ;IAGR,IAAI;IAKE,OAAO;IAMb,SAAS,IAAI,YAAY;IAInB,UAAU,CAAC,IAAI,EAAE,YAAY;CAIpC"}