@project-ajax/sdk 0.0.28

package/README.md

@@ -0,0 +1,22 @@
+# Workers SDK
+
+## Development
+
+1. Install [mise](https://mise.jdx.dev/getting-started.html)
+2. Run `mise install`
+3. Run `npm run bootstrap`
+
+## Publishing New Versions
+
+Increment the package.json version and create a new Git tag:
+
+```shell
+# This also creates a Git tag.
+npm version patch
+```
+
+Then, push the commit and tag:
+
+```shell
+git push origin main --follow-tags
+```

package/dist/block.d.ts

@@ -0,0 +1,321 @@
+type ApiColor = "default" | "gray" | "brown" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "red" | "gray_background" | "brown_background" | "orange_background" | "yellow_background" | "green_background" | "blue_background" | "purple_background" | "pink_background" | "red_background";
+type RichTextAnnotations = {
+    bold: boolean;
+    italic: boolean;
+    strikethrough: boolean;
+    underline: boolean;
+    code: boolean;
+    color: ApiColor;
+};
+type RichTextBase = {
+    plain_text: string;
+    href: string | null;
+    annotations: RichTextAnnotations;
+};
+type TextContent = {
+    content: string;
+    link: {
+        url: string;
+    } | null;
+};
+type EquationContent = {
+    expression: string;
+};
+type DateMention = {
+    type: "date";
+    date: {
+        start: string;
+        end?: string | null;
+        time_zone?: string | null;
+    };
+};
+type CustomEmojiMention = {
+    type: "custom_emoji";
+    custom_emoji: {
+        id: string;
+        name?: string;
+        url?: string;
+    };
+};
+type LinkPreviewMention = {
+    type: "link_preview";
+    link_preview: {
+        url: string;
+    };
+};
+type LinkMention = {
+    type: "link_mention";
+    link_mention: {
+        href: string;
+    };
+};
+type MentionContent = DateMention | CustomEmojiMention | LinkPreviewMention | LinkMention;
+type RichTextItem = RichTextBase & ({
+    type: "text";
+    text: TextContent;
+} | {
+    type: "mention";
+    mention: MentionContent;
+} | {
+    type: "equation";
+    equation: EquationContent;
+});
+type RichText = RichTextItem[];
+type EmojiIcon = {
+    type: "emoji";
+    emoji: string;
+};
+type ExternalIcon = {
+    type: "external";
+    external: {
+        url: string;
+    };
+};
+type FileIcon = {
+    type: "file";
+    file: {
+        url: string;
+        expiry_time: string;
+    };
+};
+type Icon = EmojiIcon | ExternalIcon | FileIcon;
+type ExternalFile = {
+    type: "external";
+    external: {
+        url: string;
+    };
+};
+type HostedFile = {
+    type: "file";
+    file: {
+        url: string;
+        expiry_time: string;
+    };
+    name?: string;
+};
+type FileObject = ExternalFile | HostedFile;
+type BlockBase = {
+    object: "block";
+};
+type ParagraphBlock = BlockBase & {
+    type: "paragraph";
+    paragraph: {
+        rich_text: RichText;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type Heading1Block = BlockBase & {
+    type: "heading_1";
+    heading_1: {
+        rich_text: RichText;
+        color?: ApiColor;
+        is_toggleable?: boolean;
+        children?: Block[];
+    };
+};
+type Heading2Block = BlockBase & {
+    type: "heading_2";
+    heading_2: {
+        rich_text: RichText;
+        color?: ApiColor;
+        is_toggleable?: boolean;
+        children?: Block[];
+    };
+};
+type Heading3Block = BlockBase & {
+    type: "heading_3";
+    heading_3: {
+        rich_text: RichText;
+        color?: ApiColor;
+        is_toggleable?: boolean;
+        children?: Block[];
+    };
+};
+type BulletedListItemBlock = BlockBase & {
+    type: "bulleted_list_item";
+    bulleted_list_item: {
+        rich_text: RichText;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type NumberedListItemBlock = BlockBase & {
+    type: "numbered_list_item";
+    numbered_list_item: {
+        rich_text: RichText;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type ToDoBlock = BlockBase & {
+    type: "to_do";
+    to_do: {
+        rich_text: RichText;
+        checked: boolean;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type ToggleBlock = BlockBase & {
+    type: "toggle";
+    toggle: {
+        rich_text: RichText;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type QuoteBlock = BlockBase & {
+    type: "quote";
+    quote: {
+        rich_text: RichText;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type CalloutBlock = BlockBase & {
+    type: "callout";
+    callout: {
+        rich_text: RichText;
+        icon?: Icon | null;
+        color?: ApiColor;
+        children?: Block[];
+    };
+};
+type CodeBlock = BlockBase & {
+    type: "code";
+    code: {
+        rich_text: RichText;
+        caption?: RichText;
+        language: string;
+    };
+};
+type EquationBlock = BlockBase & {
+    type: "equation";
+    equation: {
+        expression: string;
+    };
+};
+type DividerBlock = BlockBase & {
+    type: "divider";
+    divider: Record<string, never>;
+};
+type BreadcrumbBlock = BlockBase & {
+    type: "breadcrumb";
+    breadcrumb: Record<string, never>;
+};
+type TableOfContentsBlock = BlockBase & {
+    type: "table_of_contents";
+    table_of_contents: {
+        color?: ApiColor;
+    };
+};
+type ColumnListBlock = BlockBase & {
+    type: "column_list";
+    column_list: {
+        children: ColumnBlock[];
+    };
+};
+type ColumnBlock = BlockBase & {
+    type: "column";
+    column: {
+        children?: Block[];
+    };
+};
+type ImageBlock = BlockBase & {
+    type: "image";
+    image: FileObject & {
+        caption?: RichText;
+    };
+};
+type VideoBlock = BlockBase & {
+    type: "video";
+    video: FileObject & {
+        caption?: RichText;
+    };
+};
+type AudioBlock = BlockBase & {
+    type: "audio";
+    audio: FileObject & {
+        caption?: RichText;
+    };
+};
+type PDFBlock = BlockBase & {
+    type: "pdf";
+    pdf: FileObject & {
+        caption?: RichText;
+    };
+};
+type FileBlock = BlockBase & {
+    type: "file";
+    file: FileObject & {
+        caption?: RichText;
+    };
+};
+type EmbedBlock = BlockBase & {
+    type: "embed";
+    embed: {
+        url: string;
+        caption?: RichText;
+    };
+};
+type BookmarkBlock = BlockBase & {
+    type: "bookmark";
+    bookmark: {
+        url: string;
+        caption?: RichText;
+    };
+};
+type LinkPreviewBlock = BlockBase & {
+    type: "link_preview";
+    link_preview: {
+        url: string;
+    };
+};
+type ChildPageBlock = BlockBase & {
+    type: "child_page";
+    child_page: {
+        title: string;
+    };
+};
+type ChildDatabaseBlock = BlockBase & {
+    type: "child_database";
+    child_database: {
+        title: string;
+    };
+};
+type TemplateBlock = BlockBase & {
+    type: "template";
+    template: {
+        rich_text: RichText;
+        children?: Block[];
+    };
+};
+type TableBlock = BlockBase & {
+    type: "table";
+    table: {
+        table_width: number;
+        has_column_header: boolean;
+        has_row_header: boolean;
+        children: TableRowBlock[];
+    };
+};
+type TableRowBlock = BlockBase & {
+    type: "table_row";
+    table_row: {
+        cells: RichText[];
+    };
+};
+type AIBlock = BlockBase & {
+    type: "ai_block";
+    ai_block: {
+        prompt?: string;
+    };
+};
+type UnsupportedBlock = BlockBase & {
+    type: "unsupported";
+    unsupported: Record<string, never>;
+};
+type Block = ParagraphBlock | Heading1Block | Heading2Block | Heading3Block | BulletedListItemBlock | NumberedListItemBlock | ToDoBlock | ToggleBlock | QuoteBlock | CalloutBlock | CodeBlock | EquationBlock | DividerBlock | BreadcrumbBlock | TableOfContentsBlock | ColumnListBlock | ColumnBlock | ImageBlock | VideoBlock | AudioBlock | PDFBlock | FileBlock | EmbedBlock | BookmarkBlock | LinkPreviewBlock | ChildPageBlock | ChildDatabaseBlock | TemplateBlock | TableBlock | TableRowBlock | AIBlock | UnsupportedBlock;
+export type { RichText, RichTextItem, RichTextBase, RichTextAnnotations, TextContent, EquationContent, MentionContent, DateMention, CustomEmojiMention, LinkPreviewMention, LinkMention, ApiColor, Icon, EmojiIcon, ExternalIcon, FileIcon, FileObject, ExternalFile, HostedFile, BlockBase, ParagraphBlock, Heading1Block, Heading2Block, Heading3Block, BulletedListItemBlock, NumberedListItemBlock, ToDoBlock, ToggleBlock, QuoteBlock, CalloutBlock, CodeBlock, EquationBlock, DividerBlock, BreadcrumbBlock, TableOfContentsBlock, ColumnListBlock, ColumnBlock, ImageBlock, VideoBlock, AudioBlock, PDFBlock, FileBlock, EmbedBlock, BookmarkBlock, LinkPreviewBlock, ChildPageBlock, ChildDatabaseBlock, TemplateBlock, TableBlock, TableRowBlock, AIBlock, UnsupportedBlock, Block, };
+//# sourceMappingURL=block.d.ts.map

package/dist/block.d.ts.map

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

package/dist/builder.d.ts

@@ -0,0 +1,12 @@
+import type { TextValue } from "./types.js";
+export declare function richText(content: string): TextValue;
+export declare function url(url: string): TextValue;
+export declare function title(content: string): TextValue;
+export declare function text(content: string): TextValue;
+/**
+ * Creates a link with custom display text
+ * @param displayText - The text to display
+ * @param url - The URL to link to
+ */
+export declare function link(displayText: string, url: string): TextValue;
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE"}

package/dist/builder.js

@@ -0,0 +1,22 @@
+function richText(content) {
+  return [[content]];
+}
+function url(url2) {
+  return [[url2]];
+}
+function title(content) {
+  return [[content]];
+}
+function text(content) {
+  return [[content]];
+}
+function link(displayText, url2) {
+  return [[displayText, [["a", url2]]]];
+}
+export {
+  link,
+  richText,
+  text,
+  title,
+  url
+};

package/dist/capabilities/slashCommand.d.ts

@@ -0,0 +1,56 @@
+import type { Block } from "../block.js";
+export type SlashCommandConfiguration = {
+    menuTitle: string;
+    menuDescription: string;
+    search: {
+        placeholder: string;
+        debounce: number;
+    };
+    /**
+     * A function that returns a list of items to display in the search results
+     * as well as the corresponding blocks to insert for each item should it be selected.
+     */
+    executeSearch: (searchQuery: string) => Promise<{
+        items: {
+            title: string;
+            description: string;
+            id: string;
+        }[];
+    }>;
+    executeSelect: (selectedItemId: string) => Promise<Block[]>;
+};
+export type SlashCommandHandlerResult = {
+    menuTitle: string;
+    menuDescription: string;
+    search: {
+        placeholder: string;
+        debounce: number;
+    };
+};
+/**
+ * Creates a special handler for handling slash commands.
+ *
+ * @param slashCommandConfiguration - The configuration for the slash command.
+ * @returns A handler function that executes the slash command function, and passes data
+ * needed to complete the operation back to the platform.
+ */
+export declare function slashCommand(slashCommandConfiguration: SlashCommandConfiguration): {
+    _tag: string;
+    config: {
+        menuTitle: string;
+        menuDescription: string;
+        search: {
+            placeholder: string;
+            debounce: number;
+        };
+    };
+    handleSearch(searchQuery: string): Promise<{
+        items: {
+            title: string;
+            description: string;
+            id: string;
+        }[];
+    }>;
+    handleSelect(selectedItemId: string): Promise<Block[]>;
+};
+//# sourceMappingURL=slashCommand.d.ts.map

package/dist/capabilities/slashCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slashCommand.d.ts","sourceRoot":"","sources":["../../src/capabilities/slashCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;OAGG;IACH,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;QAC/C,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC5D,CAAC,CAAC;IACH,aAAa,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;CACF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,yBAAyB,EAAE,yBAAyB;;;;;;yBA/BtC,MAAM;sBACT,MAAM;;;8BAuCgB,MAAM;eA/B/B;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE;;iCA0CxB,MAAM;EAY1C"}

package/dist/capabilities/slashCommand.js

@@ -0,0 +1,32 @@
+import { ExecutionError } from "../error.js";
+function slashCommand(slashCommandConfiguration) {
+  return {
+    _tag: "slashCommand",
+    config: {
+      menuTitle: slashCommandConfiguration.menuTitle,
+      menuDescription: slashCommandConfiguration.menuDescription,
+      search: slashCommandConfiguration.search
+    },
+    async handleSearch(searchQuery) {
+      const result = await slashCommandConfiguration.executeSearch(searchQuery).catch((err) => {
+        throw new ExecutionError(err);
+      });
+      process.stdout.write(`
+<output>${JSON.stringify(result)}</output>
+`);
+      return result;
+    },
+    async handleSelect(selectedItemId) {
+      const result = await slashCommandConfiguration.executeSelect(selectedItemId).catch((err) => {
+        throw new ExecutionError(err);
+      });
+      process.stdout.write(`
+<output>${JSON.stringify(result)}</output>
+`);
+      return result;
+    }
+  };
+}
+export {
+  slashCommand
+};

package/dist/capabilities/sync.d.ts

@@ -0,0 +1,58 @@
+import type { PropertySchema, Schema } from "../schema.js";
+import type { TextValue } from "../types.js";
+/**
+ * An object representing a third-party record to be synced.
+ */
+export type SyncedObject<PK extends string, S extends PropertySchema<PK>> = {
+    key: string;
+    properties: {
+        [Property in keyof S]: TextValue;
+    };
+};
+/**
+ * A configuration object that enables synchronization between a data
+ * source and a third-party source.
+ */
+export type SyncConfiguration<PK extends string, S extends Schema<PK>> = {
+    /**
+     * The property of the data source that maps to a "primary key" in the
+     * third-party data. This is used to match existing pages to
+     * records in the third-party service. Must be a property defined in the schema.
+     */
+    primaryKeyProperty: PK;
+    /**
+     * The schema defining the structure of properties in the collection.
+     */
+    schema: S;
+    /**
+     * A function that fetches the data to sync from the third-party service.
+     *
+     * For now, this function must return all of the data to be synced each time
+     * it's called. The runtime will handle diffing this against the data source
+     * and creating, updating, and deleting pages as necessary.
+     */
+    execute: () => Promise<SyncedObject<PK, PropertySchema<PK>>[]>;
+};
+export type SyncHandlerResult<PK extends string> = {
+    primaryKeyProperty: PK;
+    objects: SyncedObject<PK, PropertySchema<PK>>[];
+};
+/**
+ * Creates a special handler for syncing third-party data to a collection.
+ *
+ * @param syncConfiguration - The configuration for the sync.
+ * @returns A handler function that executes the sync function, and passes data
+ * needed to complete the sync back to the platform.
+ */
+export declare function sync<PK extends string, S extends Schema<PK>>(syncConfiguration: SyncConfiguration<PK, S>): {
+    _tag: string;
+    config: {
+        schema: S;
+    };
+    handler(): Promise<{
+        schema: S;
+        primaryKeyProperty: PK;
+        objects: SyncedObject<PK, PropertySchema<PK>>[];
+    }>;
+};
+//# sourceMappingURL=sync.d.ts.map

package/dist/capabilities/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,EAAE,CAAC,IAAI;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;SAAG,QAAQ,IAAI,MAAM,CAAC,GAAG,SAAS;KAAE,CAAC;CACjD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,IAAI;IACxE;;;;OAIG;IACH,kBAAkB,EAAE,EAAE,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,IAAI;IAClD,kBAAkB,EAAE,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;CAChD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAC3D,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,CAAC;;;;;;;;;;EAuB3C"}

package/dist/capabilities/sync.js

@@ -0,0 +1,26 @@
+import { ExecutionError } from "../error.js";
+function sync(syncConfiguration) {
+  return {
+    _tag: "sync",
+    config: {
+      schema: syncConfiguration.schema
+    },
+    async handler() {
+      const objects = await syncConfiguration.execute().catch((err) => {
+        throw new ExecutionError(err);
+      });
+      const result = {
+        schema: syncConfiguration.schema,
+        primaryKeyProperty: syncConfiguration.primaryKeyProperty,
+        objects
+      };
+      process.stdout.write(`
+<output>${JSON.stringify(result)}</output>
+`);
+      return result;
+    }
+  };
+}
+export {
+  sync
+};

package/dist/capabilities/tool.d.ts

@@ -0,0 +1,69 @@
+import { type JSONSchemaType } from "ajv";
+type JSONValue = string | number | boolean | null | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export interface ToolConfiguration<I extends JSONValue, O extends JSONValue = JSONValue> {
+    description: string;
+    schema: JSONSchemaType<I>;
+    outputSchema?: JSONSchemaType<O>;
+    execute: (input: I) => O | Promise<O>;
+}
+/**
+ * An error returned when the input to a tool doesn't match the input schema.
+ */
+export declare class InvalidToolInputError extends Error {
+    constructor(message: string);
+}
+/**
+ * An error returned when the output from a tool doesn't match the output schema.
+ */
+export declare class InvalidToolOutputError extends Error {
+    constructor(message: string);
+}
+/**
+ * An error returned when the tool execution fails.
+ */
+export declare class ToolExecutionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Creates a capability definition for a tool to be used by an agent.
+ *
+ * Example:
+ *
+ * ```ts
+ * tool<{ name: string }>({
+ *   description: "Say hello to the user",
+ *   schema: {
+ *     type: "object",
+ *     properties: {
+ *       name: { type: "string" },
+ *     },
+ *     required: ["name"],
+ *   },
+ *   execute: ({ name }) => {
+ *     return `Hello, ${name}!`;
+ *   },
+ * })
+ * ```
+ *
+ * @param config - The configuration for the tool.
+ * @returns A capability definition for the tool.
+ */
+export declare function tool<I extends JSONValue, O extends JSONValue = JSONValue>(config: ToolConfiguration<I, O>): {
+    _tag: string;
+    config: {
+        description: string;
+        schema: JSONSchemaType<I>;
+        outputSchema: JSONSchemaType<O> | undefined;
+    };
+    handler(input: JSONValue): Promise<{
+        _tag: "success";
+        value: O;
+    } | {
+        _tag: "error";
+        error: InvalidToolInputError | InvalidToolOutputError | ToolExecutionError;
+    }>;
+};
+export {};
+//# sourceMappingURL=tool.d.ts.map

package/dist/capabilities/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/capabilities/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE/C,KAAK,SAAS,GACX,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEhC,MAAM,WAAW,iBAAiB,CACjC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,EACxE,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;;;;;;;mBAeT,SAAS,GAAG,OAAO,CACrC;QACA,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,CAAC,CAAC;KACR,GACD;QACA,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EACF,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,CAAC;KACrB,CACH;EA0CF"}