@builder.io/ai-utils 0.0.73 → 0.0.75

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.0.73",
+  "version": "0.0.75",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/codegen.d.ts

@@ -0,0 +1,63 @@
+import type { UserMessageParam } from "./messages";
+import type { BuilderContent } from "./completion";
+import type { Options as PrettierOptions } from "prettier";
+import type { UserContext } from "./mapping";
+import type { AssistantMessageParam } from "./messages";
+export type ImportType = "named" | "default";
+export interface ESMImport {
+    importName: string;
+    importPath: string;
+    importType: ImportType;
+}
+export interface ProjectFile {
+    filePath: string;
+    content?: string;
+    importance?: number;
+    dropReason?: string;
+    wasIncluded?: boolean;
+}
+export interface CustomInstruction {
+    id: string;
+    name: string;
+    content: string;
+}
+export type CodeGenFramework = "react" | "html" | "mitosis" | "react-native" | "angular" | "vue" | "svelte" | "qwik" | "solid" | "marko" | "swiftui" | "jetpack-compose" | "flutter";
+export type CodeGenStyleLibrary = "tailwind" | "tailwind-precise" | "emotion" | "styled-components" | "styled-jsx" | "react-native" | undefined;
+export type CodeGenStopReason = "error" | "max_tokens" | "end" | "limit";
+export type CodeGenMode = "exact" | "precise" | "precise_vision" | "creative" | "creative_vision" | "creative_only_vision";
+export interface CodeGenInputOptions {
+    position: string;
+    eventName?: string;
+    sessionId: string;
+    codeGenMode?: "fast" | "quality-v2";
+    url?: string;
+    diffActions?: boolean;
+    planningPrompt?: boolean;
+    customInstructions?: CustomInstruction[];
+    userPrompt?: string;
+    files?: ProjectFile[];
+    rerankFiles?: number;
+    builderContent?: BuilderContent;
+    framework?: CodeGenFramework;
+    styleLibrary?: CodeGenStyleLibrary;
+    typescript?: boolean;
+    userContext?: UserContext;
+    maxTokens?: number;
+    maxPages?: number;
+    autoContinue?: number;
+    promptCaching?: boolean;
+    isAutoContinue?: boolean;
+    llmSuggestions?: boolean;
+    requestActions?: boolean;
+    conclusionText?: boolean;
+    searchResponse?: any | null;
+    prettierConfig?: PrettierOptions;
+    /** @deprecated */
+    history?: (UserMessageParam | AssistantMessageParam)[];
+    /** @deprecated */
+    prevId?: string;
+    /** @deprecated */
+    nextPage?: boolean;
+    /** @deprecated */
+    vcpId?: string;
+}

package/src/codegen.js

@@ -0,0 +1 @@
+export {};

package/src/events.d.ts

@@ -2,7 +2,7 @@ import type { BuilderContent, BuilderElement } from "@builder.io/sdk";
 import type { AssistantMessage } from "./messages.js";
 import type { AssistantSettings } from "./settings.js";
 export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
-export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptTextEvent | AppReadyEvent | AppSettingsResetEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelCreateEvent | ModelUpdateEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunRequiresActionEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent;
+export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptTextEvent | AppReadyEvent | AppSettingsResetEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelCreateEvent | ModelUpdateEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunRequiresActionEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | ThreadMessageRetryEvent;
 export interface AssistantCompletionResultEvent {
     type: "assistant.result";
     data: {
@@ -30,6 +30,12 @@ export interface AssistantTrackEvent {
         properties: Record<string, any>;
     };
 }
+export interface AssistantThemeEvent {
+    type: "assistant.app.theme.update";
+    data: {
+        theme: string;
+    };
+}
 export interface AppCloseEvent {
     type: "assistant.app.close";
 }
@@ -369,6 +375,9 @@ export interface ThreadMessageCompletedEvent {
     type: "assistant.thread.message.completed";
     data: ThreadMessageCompleted;
 }
+export interface ThreadMessageRetryEvent {
+    type: "assistant.thread.message.retry";
+}
 export interface ThreadMessageCompleted extends AssistantMessage {
     platformId: string;
     threadId: string;

package/src/index.d.ts

@@ -5,3 +5,6 @@ export * from "./fetch.js";
 export * from "./messages.js";
 export * from "./settings.js";
 export * from "./thread.js";
+export * from "./mapping.js";
+export * from "./codegen.js";
+export * from "./vcp.js";

package/src/index.js

@@ -5,3 +5,6 @@ export * from "./fetch.js";
 export * from "./messages.js";
 export * from "./settings.js";
 export * from "./thread.js";
+export * from "./mapping.js";
+export * from "./codegen.js";
+export * from "./vcp.js";

package/src/mapping.d.ts

@@ -0,0 +1,77 @@
+import type { ESMImport } from "./codegen";
+export interface UserContext {
+    client: string;
+    clientVersion: string;
+    nodeVersion: string;
+    systemPlatform: string;
+    frameworks: string[];
+    systemEOL: string;
+    systemArch: string;
+    systemShell?: string;
+    inGitRepo?: boolean;
+    [key: string]: string | string[] | boolean | undefined;
+}
+export type ExportType = "default" | "named";
+/**
+ * Gets the latest component mappings for a space
+ */
+export interface FigmaMappingsData {
+    id: string;
+    figmaBuilderLinks: FigmaBuilderLink[];
+    version?: number;
+    createdDate?: string;
+    local: boolean;
+    userEmail?: string;
+    remoteUrl?: string;
+}
+export interface FigmaBuilderLink {
+    builderName: string;
+    figmaName: string;
+    figmaKey: string;
+    figmaUrl?: string;
+    inputMapper?: string;
+    originalInputMapper?: string;
+    exportType?: ExportType;
+    importName?: string;
+    importPath?: string;
+    source: string;
+    loc?: string;
+    imports?: ESMImport[];
+}
+export interface FigmaMapperFile {
+    filePath: string;
+    content: string;
+}
+export interface PublishedMapping {
+    figmaBuilderLinks: FigmaBuilderLink[];
+    mapperFiles: FigmaMapperFile[];
+    remoteUrl?: string;
+    defaultBranch?: string;
+    currentBranch?: string;
+    commit?: string;
+    spaceKind?: string;
+    userContext?: UserContext;
+}
+export interface FigmaComponentInfo {
+    documentName: string;
+    key: string;
+    tree?: string;
+    jsx?: string;
+    type: string;
+    name: string;
+    exportJson?: any;
+    inputs: FigmaComponentInput[];
+    description: string;
+    documentationLinks: string[];
+    instanceId: string;
+}
+export interface FigmaComponentInput {
+    id: string;
+    name: string;
+    value?: any;
+    type: string;
+    baseType: "text" | "variant" | "boolean" | "slot";
+    variantOptions?: string[];
+    isDefault: boolean;
+    ref?: string;
+}

package/src/mapping.js

@@ -0,0 +1 @@
+export {};

package/src/messages.d.ts

@@ -64,7 +64,7 @@ export interface AssistantMessageParam {
     /**
      * The contents of the assistant message.
      */
-    content: string | (ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemText | ContentMessageItemToolUse)[];
+    content: string | ContentMessageItem[];
     /**
      * The role of the messages author, in this case `assistant`.
      */
@@ -115,13 +115,15 @@ export interface AssistantActionMessage {
 export type Message = SystemMessage | UserMessage | AssistantMessage;
 export type GeneratingMessage = null | Partial<AssistantActionMessage | AssistantMessage>;
 export declare function getContentText(message: string | ContentMessage): string;
+export declare function getContentAttachments(message: string | ContentMessage): ImageSource[];
 export type Attachment = FileUpload | Template;
 export interface FileUpload {
-    type: string;
+    type: "upload";
+    contentType: string;
     name: string;
     dataUrl: string;
     size: number;
-    id: number;
+    id: string;
 }
 export interface Template {
     type: "template";

package/src/messages.js

@@ -6,3 +6,11 @@ export function getContentText(message) {
         .map((item) => (item.type === "text" ? item.text : ""))
         .join("");
 }
+export function getContentAttachments(message) {
+    if (typeof message === "string") {
+        return [];
+    }
+    return message
+        .filter((item) => item.type === "image")
+        .map((item) => item.source);
+}

package/src/vcp.d.ts

@@ -0,0 +1,32 @@
+import type { ESMImport } from "./codegen";
+export interface BuilderComponentInfo {
+    name: string;
+    inputs?: BuilderComponentInput[];
+    path: string;
+    imports: {
+        [key: string]: string | undefined;
+    };
+    esmImports?: ESMImport[];
+    options?: any;
+}
+export interface BuilderComponentInput {
+    name: string;
+    type: string;
+    value: any;
+}
+export interface BuilderComponentSlot {
+    figmaId: string;
+    builderName: string;
+}
+export interface JSXNode {
+    "@type": "jsx";
+    name: string;
+    props: Record<string, any>;
+    tagName?: string;
+    includeAirLayoutStyles?: boolean;
+    path?: string;
+    imports?: {
+        [key: string]: string | undefined;
+    };
+    esmImports?: ESMImport[];
+}

package/src/vcp.js

@@ -0,0 +1 @@
+export {};