@builder.io/dev-tools 1.0.20 → 1.1.0-rc0

package/types/cli/add.d.ts

@@ -0,0 +1,53 @@
+/// <reference types="@figma/plugin-typings" />
+import type { ComponentInfo, ComponentInput, ComponentRegistry, DevToolsSys } from "../types";
+import type { FigmaArgs } from "./figma";
+export declare const runFigmaAdd: (sys: DevToolsSys, args: FigmaArgs) => Promise<void>;
+export interface FigmaComponentInput {
+    id: string;
+    name: string;
+    value?: any;
+    type: string;
+    baseType: "text" | "variant" | "boolean" | "slot";
+    variantOptions?: string[];
+    isDefault: boolean;
+    ref?: string;
+}
+export interface FigmaComponentInfo {
+    documentName: string;
+    key: string;
+    tree: string;
+    jsx: string;
+    name: string;
+    inputs: FigmaComponentInput[];
+    description: string;
+    documentationLinks: string[];
+    instanceId: string;
+}
+export declare const parseFigmaURL: (str: string) => {
+    fileID: string;
+    nodeId: string;
+} | null;
+export declare const getFigmaNodeData: (auth: {
+    access_token: string;
+    oauth: boolean;
+}, fileId: string, nodeId: string) => Promise<any>;
+export declare function getInputsSlotsFromComponentPropertyDefinitions(mainComponent: ComponentSetNode | ComponentNode): {
+    inputs: FigmaComponentInput[];
+    nameMap: (key: string) => string;
+};
+export declare const REMOVE_EMOJI: RegExp;
+export declare function getFigmaComponentName(name: string): string;
+export interface MappingCodeV2 {
+    figmaInterface: string;
+    reactInterface: string;
+    componentRegistry: string;
+    figmaComponentName: string;
+    figmaTree: string;
+    meta?: Record<string, any>;
+    previousCode?: string;
+    prompt?: string;
+}
+export declare function getMappingData(figmaNode: FigmaComponentInfo, registeredCmp: ComponentInfo, cmpRegistry: ComponentRegistry, useJSX: boolean): MappingCodeV2;
+export declare const getTypeFromComponentInput: (input: ComponentInput) => string;
+export declare const getPropertyAccessor: (name: string) => string;
+export declare function getMappingPrompt(figmaNode: FigmaComponentInfo, registeredCmp: ComponentInfo, cmpRegistry: ComponentRegistry, useJSX?: boolean): string;

package/types/cli/credentials.d.ts

@@ -0,0 +1,31 @@
+import type { DevToolsSys } from "../types";
+import type { FigmaArgs } from "./figma";
+export interface CredentialsOptions {
+    builderPublicKey?: boolean;
+    builderPrivateKey?: boolean;
+    figmaAuth?: boolean;
+    force?: boolean;
+}
+export interface FigmaAuth {
+    access_token: string;
+    oauth: boolean;
+}
+export interface BuilderAuth {
+    privateKey: string;
+    spaceId: string;
+    name: string;
+    userId: string;
+}
+export interface Credentials {
+    figmaAuth?: FigmaAuth;
+    builderPublicKey?: string;
+    builderPrivateKey?: string;
+}
+export declare const isCI: (args: FigmaArgs) => boolean;
+export declare const getCredentials: (sys: DevToolsSys, args: FigmaArgs, opts: CredentialsOptions) => Promise<{
+    figmaAuth: FigmaAuth | undefined;
+    builderPublicKey: string | undefined;
+    builderPrivateKey: string | undefined;
+}>;
+export declare function getFigmaAuth(): Promise<FigmaAuth>;
+export declare function getBuilderAuth(sys: DevToolsSys): Promise<BuilderAuth>;

package/types/cli/download.d.ts

@@ -0,0 +1,10 @@
+import type { FigmaArgs } from "./figma";
+import type { DevToolsSys } from "../types";
+import { type FigmaBuilderLink } from "./figma-publish";
+interface KVGetRequest {
+    privateKey: string;
+    spaceId: string;
+}
+export declare const runFigmaMigrate: (sys: DevToolsSys, args: FigmaArgs) => Promise<void>;
+export declare function getBuilderSpaceFigmaLinks(kvReq: KVGetRequest): Promise<FigmaBuilderLink[]>;
+export {};

package/types/cli/figma-publish.d.ts

@@ -0,0 +1,39 @@
+import type { DevToolsSys, ExportType } from "../types";
+import type { FigmaArgs } from "./figma";
+export interface FigmaBuilderLink {
+    builderName: string;
+    figmaName: string;
+    figmaKey: string;
+    inputMapper?: string;
+    originalInputMapper?: string;
+    exportType?: ExportType;
+    importName?: string;
+    importPath?: string;
+    source: string;
+}
+export declare const runFigmaPublish: (sys: DevToolsSys, args: FigmaArgs) => Promise<void>;
+export declare const FIGMA_CONNECT_CALL = "figmaMapping";
+export declare function findAllMappingFiles(sys: DevToolsSys): Promise<string[]>;
+export interface BuilderSpace {
+    privateKey: string;
+    spaceId: string;
+    userId: string;
+    name?: string;
+}
+interface KVGetRequest extends BuilderSpace {
+    docId: string;
+}
+interface KVPutRequest extends KVGetRequest {
+    /**
+     * Must be an object but not an array. TS is a fool sometimes.
+     * https://stackoverflow.com/a/70448528/1520787
+     */
+    data: Record<string, any> & {
+        length?: never;
+    };
+}
+export interface FigmaBuilderData {
+    figmaBuilderLinks: FigmaBuilderLink[];
+}
+export declare function putBuilderSpaceKv(kvReq: KVPutRequest): Promise<void>;
+export {};

package/types/cli/figma.d.ts

@@ -0,0 +1,9 @@
+import type { DevToolsSys } from "../types";
+export interface FigmaArgs {
+    privateKey?: string;
+    figmaToken?: string;
+    ci?: boolean;
+    help?: boolean;
+    _: string[];
+}
+export declare const runFigmaCommand: (sys: DevToolsSys, subCommand: string, args: FigmaArgs) => Promise<void>;

package/types/cli/help.d.ts

@@ -0,0 +1 @@
+export declare function printHelp(): void;

package/types/cli/prettier.d.ts

@@ -0,0 +1 @@
+export declare function formatCode(code: string): Promise<string>;

package/types/core/adapters/angular/angular-ensure-builder-setup.d.ts

@@ -1,5 +1,5 @@
 import type { ModifiedFile } from "../../../types";
 import type { AngularDevToolsSys } from ".";
-export declare function angularEnsureBuilderSetup(sys: AngularDevToolsSys): Promise<ModifiedFile[]>;
 export declare function angularEnsureBuilderRegistry(sys: AngularDevToolsSys): Promise<ModifiedFile[]>;
+export declare function angularEnsureBuilderSetup(_sys: AngularDevToolsSys): Promise<ModifiedFile[]>;
 export declare function angularEnsureFigmaImportSetup(_sys: AngularDevToolsSys): Promise<ModifiedFile[]>;

package/types/core/adapters/angular/index.d.ts

@@ -9,5 +9,4 @@ export interface AngularDevToolsSys extends DevToolsSys {
     registryPath: string;
     angularConfigPath: string;
     typescriptEnabled: boolean;
-    builderPageComponentPath: string;
 }

package/types/figma/index.d.ts

@@ -0,0 +1,70 @@
+/// <reference types="@figma/plugin-typings" />
+export type FigmaNodeType = "COMPONENT" | "ELLIPSE" | "FRAME" | "GROUP" | "INSTANCE" | "LINE" | "POLYGON" | "RECTANGLE" | "STAR" | "TEXT" | "VECTOR";
+export interface FigmaComponentInput {
+    id: string;
+    name: string;
+    value?: any;
+    type: string;
+    baseType: "text" | "variant" | "boolean" | "slot";
+    variantOptions?: string[];
+    isDefault: boolean;
+    ref?: string;
+}
+export interface FigmaNode {
+    "@type": "passedNode";
+    $id: string;
+    $name: string;
+    $type: FigmaNodeType;
+    $inputs: readonly FigmaComponentInput[];
+    $componentName?: string;
+    $rawNode: SceneNode;
+    /** Represents the text content of the node and its descendants */
+    $textContent: string;
+    /** URL to the rasterized image of this node */
+    $imageUrl: string;
+    $children: readonly FigmaNode[];
+    /** Recursively finds the first node that matches the callback */
+    $findOne(callback: (node: SceneNode) => boolean): FigmaNode | undefined;
+    /** Recursively finds the first figma child with the given name */
+    $findOneByName(name: string | RegExp): FigmaNode | undefined;
+    /** @deprecated Use $type instead */
+    type: FigmaNodeType;
+    /** @deprecated - */
+    props: {};
+    /** @deprecated - */
+    key: string | null;
+}
+export interface BaseFigmaProps {
+    $id: string;
+    $name: string;
+    $type: FigmaNodeType;
+    $inputs: readonly FigmaComponentInput[];
+    $componentName?: string;
+    /** Represents the text content of the node and its descendants */
+    $textContent: string;
+    $css: Readonly<Record<string, string>>;
+    /** URL to the rasterized image of this node */
+    $imageUrl: string;
+    /** Direct children of the root component node or instance */
+    $children: readonly FigmaNode[];
+    /** Recursively finds the first figma child with the given name */
+    $findOneByName(name: string | RegExp): FigmaNode | undefined;
+    /** Recursively finds the first node that matches the callback */
+    $findOne(callback: (node: SceneNode) => boolean): FigmaNode | undefined;
+}
+interface FigmaProps extends BaseFigmaProps {
+    [key: string]: any;
+}
+export interface FigmaMappingWithKeyMapper<T extends BaseFigmaProps> {
+    url?: string;
+    componentKey: string;
+    mapper?: (figma: T) => any;
+}
+export interface FigmaGenericMapper {
+    genericMapper: (figma: FigmaProps) => any;
+}
+export interface FigmaTokenMapper {
+    designTokenMapper: (token: string) => string | undefined | boolean;
+}
+export declare function figmaMapping<T extends BaseFigmaProps = FigmaProps>(_config: FigmaMappingWithKeyMapper<T> | FigmaGenericMapper | FigmaTokenMapper): void;
+export {};

package/types/figma/jsx-runtime/index.d.cts

@@ -0,0 +1,2 @@
+export function jsx(): null;
+export function jsxs(): null;

package/types/figma/jsx-runtime/index.d.ts

@@ -0,0 +1,2 @@
+export function jsx(): null;
+export function jsxs(): null;

package/types/core/adapters/angular/angular-app-module-imports.d.ts

@@ -1,3 +0,0 @@
-import type { AngularDevToolsSys } from ".";
-export declare function angularUpdateAppModule(sys: AngularDevToolsSys): Promise<string | undefined>;
-export declare function angularEnsureAppModuleImports(sys: AngularDevToolsSys, filePath: string, code: string): Promise<string>;

package/types/core/adapters/angular/angular-app-module-imports.unit.d.ts

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