@plasmicapp/host 1.0.223 → 1.0.225

package/registerComponent/dist/registerComponent.d.ts

@@ -1,7 +1,8 @@
 /// <reference types="react" />
 import { CodeComponentElement, CSSProperties } from "./element-types";
-import { ContextDependentConfig, InferDataType, ProjectData, PropType, RestrictPropType, StudioOps } from "./prop-types";
-import { TupleUnion } from "./type-utils";
+import { ComponentContextConfig, ProjectData, PropType, RestrictPropType, StudioOps } from "./types/component-types";
+import { InferDataType } from "./types/shared-controls";
+import { TupleUnion } from "./types/type-utils";
 export type * from "./prop-types";
 export interface ActionProps<P> {
     componentProps: P;
@@ -30,11 +31,11 @@ export type Action<P> = {
     type: "button-action";
     label: string;
     onClick: (props: ActionProps<P>) => void;
-    hidden?: ContextDependentConfig<P, boolean>;
+    hidden?: ComponentContextConfig<P, boolean>;
 } | {
     type: "custom-action";
     control: React.ComponentType<ActionProps<P>>;
-    hidden?: ContextDependentConfig<P, boolean>;
+    hidden?: ComponentContextConfig<P, boolean>;
 };
 type DistributedKeyOf<T> = T extends any ? keyof T : never;
 interface ComponentTemplate<P> extends Omit<CodeComponentElement<P>, "type" | "name"> {
@@ -51,12 +52,12 @@ export type StateSpec<P> = {
     /**
      * If true, will hide the state on studio.
      */
-    hidden?: ContextDependentConfig<P, boolean>;
+    hidden?: ComponentContextConfig<P, boolean>;
     /**
      * If true, will hide the state in a collapsed section; good for states that
      * should not usually be used.
      */
-    advanced?: ContextDependentConfig<P, boolean>;
+    advanced?: ComponentContextConfig<P, boolean>;
 } & ({
     type: "readonly";
     variableType: "text";
@@ -247,7 +248,7 @@ export interface CodeComponentMeta<P> {
      * on the left of the Studio.  This makes it easy to identify an element when
      * looking at the tree.
      */
-    treeLabel?: ContextDependentConfig<P, string>;
+    treeLabel?: ComponentContextConfig<P, string>;
     /**
      * The value of the CSS display property used by this component.
      * Plasmic passes in a class name prop to components to let users style them,

package/registerComponent/dist/registerFunction.d.ts

@@ -1,129 +1,5 @@
-import { Nullish } from "./type-utils";
-/**
- * Context that we pass back to control functions.
- */
-export type ControlContext<P> = [
-    /**
-     * props
-     */
-    Partial<P>,
-    /**
-     * context data
-     */
-    any
-];
-/**
- * Config option that takes the context (e.g., props) of the function call
- * to dynamically set its value.
- */
-export type ContextDependentConfig<P, R> = (...args: ControlContext<P>) => R;
-export interface BaseParam {
-    name: string;
-    description?: string;
-    isOptional?: boolean;
-    isRestParameter?: boolean;
-}
-export interface ChoiceTypeBase<P, T> extends BaseParam {
-    type: "choice";
-    options: T[] | {
-        label: string;
-        value: T;
-    }[] | ContextDependentConfig<P, T[] | {
-        label: string;
-        value: T;
-    }[]>;
-    allowSearch?: boolean;
-    filterOption?: boolean;
-    onSearch?: ContextDependentConfig<P, ((value: string) => void) | undefined>;
-}
-export interface SingleChoiceType<P, T> extends ChoiceTypeBase<P, T> {
-    multiSelect?: false;
-}
-export interface MultiChoiceType<P, T> extends ChoiceTypeBase<P, T[]> {
-    multiSelect: true;
-}
-export interface CustomChoiceType<P, T> extends ChoiceTypeBase<P, T | T[]> {
-    multiSelect: ContextDependentConfig<P, boolean>;
-}
-export type ChoiceType<P, T> = SingleChoiceType<P, T> | MultiChoiceType<P, T> | CustomChoiceType<P, T>;
-export interface PlainStringType<T extends Nullish<string> = string> extends BaseParam {
-    type: "string" | `'${T}'`;
-}
-export type StringType<P, T extends Nullish<string> = string> = "string" | PlainStringType<T> | ChoiceType<P, T> | AnyType;
-export interface PlainNumberType<T extends Nullish<number> = number> extends BaseParam {
-    type: "number" | `${number extends T ? number : T}`;
-}
-export type NumberType<P, T extends Nullish<number> = number> = PlainNumberType<T> | ChoiceType<P, T> | AnyType;
-export interface PlainBooleanType<T extends Nullish<boolean> = boolean> extends BaseParam {
-    type: "boolean" | `${boolean extends T ? boolean : T}`;
-}
-export type BooleanType<P, T extends Nullish<boolean> = boolean> = PlainBooleanType<T> | ChoiceType<P, T> | AnyType;
-export type GraphQLValue = {
-    query: string;
-    variables?: Record<string, any>;
-};
-export interface GraphQLType<P> extends BaseParam {
-    type: "code";
-    lang: "graphql";
-    endpoint: string | ContextDependentConfig<P, string>;
-    method?: string | ContextDependentConfig<P, string>;
-    headers?: object | ContextDependentConfig<P, object>;
-}
-export interface PlainNullType extends BaseParam {
-    type: "null";
-}
-export type NullType = PlainNullType | AnyType;
-export interface PlainUndefinedType extends BaseParam {
-    type: "undefined";
-}
-export type UndefinedType = PlainUndefinedType | AnyType;
-export interface PlainArrayType extends BaseParam {
-    type: "array";
-}
-export type ArrayType = PlainArrayType | AnyType;
-export interface PlainObjectType extends BaseParam {
-    type: "object";
-}
-export type ObjectType = PlainObjectType | AnyType;
-export interface PlainAnyType extends BaseParam {
-    type: "any";
-}
-export type AnyType = PlainAnyType;
-export interface PlainVoidType extends BaseParam {
-    type: "void";
-}
-export type VoidType = PlainVoidType | AnyType;
-type IsAny<T> = 0 extends 1 & T ? true : false;
-type CommonType<P, T> = T extends GraphQLValue ? GraphQLType<P> : T extends null ? NullType : T extends undefined ? UndefinedType : T extends Array<any> ? ArrayType : T extends object ? ObjectType : AnyType;
-type AnyTyping<P, T> = T extends string ? StringType<P, T> : T extends number ? NumberType<P, T> : T extends boolean ? BooleanType<P, T> : CommonType<P, T>;
-export type RestrictedType<P, T> = IsAny<T> extends true ? AnyTyping<P, T> : [T] extends [Nullish<string>] ? StringType<P, T> : [T] extends [Nullish<number>] ? NumberType<P, T> : [T] extends [Nullish<boolean>] ? BooleanType<P, T> : CommonType<P, T>;
-export type ParamType<P, T> = RestrictedType<P, T>;
-export type RequiredParam<P, T> = ParamType<P, T> & {
-    isOptional?: false;
-    isRestParameter?: false;
-};
-export type OptionalParam<P, T> = ParamType<P, T> & {
-    isRestParameter?: false;
-};
-export type RestParam<P, T> = ParamType<P, T> & {
-    isOptional?: false;
-    isRestParameter: true;
-};
-type RequiredParams<T extends any[], U extends any[] = []> = Partial<T> extends T ? U : T extends [infer F, ...infer R] ? RequiredParams<R, [...U, F]> : U;
-type OptionalParams<T extends any[]> = T extends [
-    ...RequiredParams<T>,
-    ...infer R
-] ? [...R] : [];
-type HandleRequiredParams<P, R extends any[]> = R extends [infer H, ...infer T] ? [string | RequiredParam<P, H>, ...HandleRequiredParams<P, T>] : [];
-type HandleOptionalParams<P, R extends any[]> = R extends [infer H, ...infer T] ? [] | [
-    string | OptionalParam<P, H | undefined>,
-    ...HandleOptionalParams<P, T>
-] : R extends [] ? [] : R extends Array<infer T> ? [] | [RestParam<P, T[]>] : [];
-export type HandleParams<P extends any[]> = [
-    ...HandleRequiredParams<P, RequiredParams<P>>,
-    ...HandleOptionalParams<P, Required<OptionalParams<P>>>
-];
-export type HandleReturnType<P, T> = VoidType | ParamType<P, T>;
+import { HandleParams, HandleReturnType } from "./types/function-types";
+export type * from "./types/function-types";
 export interface CustomFunctionMeta<F extends (...args: any[]) => any> {
     /**
      * The javascript name of the function. Notice it must be unique across all
@@ -206,4 +82,3 @@ declare global {
     }
 }
 export default function registerFunction<F extends (...args: any[]) => any>(fn: F, meta: CustomFunctionMeta<F>): void;
-export {};

package/registerComponent/dist/types/choice-type.d.ts

@@ -0,0 +1,16 @@
+import { MaybeContextDependentConfig } from "./shared-controls";
+export type ChoiceValue = string | number | boolean;
+export type ChoiceObject<T = ChoiceValue> = {
+    label: string;
+    value: T;
+};
+export type ChoiceOption<T extends ChoiceValue = ChoiceValue> = T | ChoiceObject<T>;
+export type ChoiceOptions<T extends ChoiceValue = ChoiceValue> = T[] | ChoiceObject<T>[];
+export interface ChoiceCore<Ctx extends any[], T extends ChoiceValue> {
+    type: "choice";
+    options: MaybeContextDependentConfig<Ctx, ChoiceOptions<T>>;
+    multiSelect?: MaybeContextDependentConfig<Ctx, boolean>;
+    allowSearch?: boolean;
+    filterOption?: boolean;
+    onSearch?: MaybeContextDependentConfig<Ctx, ((v: string) => void) | undefined>;
+}

package/registerComponent/dist/types/component-types.d.ts

@@ -0,0 +1,256 @@
+/// <reference types="react" />
+import { CSSProperties, PlasmicElement } from "../element-types";
+import { ChoiceCore, ChoiceValue } from "./choice-type";
+import { ArrayTypeBaseCore, ObjectTypeBaseCore } from "./container-types";
+import { DataPickerValueType, DataSourceCore, GraphQLCore, GraphQLValue, RichDataPickerCore, RichExprEditorCore } from "./misc-types";
+import { CardPickerCore, ClassCore, CodeStringCore, ColorCore, DateRangeStringsCore, DateStringCore, HrefCore, NumberTypeBaseCore, PlainNumberCore, PlainStringCore, RichBooleanCore, RichTextCore, SliderNumberCore, ThemeResetClassCore } from "./primitive-types";
+import { CommonTypeBase, ContextDependentConfig, ControlExtras, GenericContext, InferDataType } from "./shared-controls";
+export type ComponentControlContext<P> = GenericContext<P, // Full component props
+// Full component props
+InferDataType<P> | null, // Canvas data
+ControlExtras>;
+export type ComponentContextConfig<Props, R> = ContextDependentConfig<ComponentControlContext<Props>, R>;
+export interface PropTypeBase<Ctx extends any[]> extends CommonTypeBase<Ctx> {
+    displayName?: string;
+    readOnly?: boolean | ContextDependentConfig<Ctx, boolean>;
+    /**
+     * If true, will hide the prop in a collapsed section; good for props that
+     * should not usually be used.
+     */
+    advanced?: boolean;
+    /**
+     * If set to true, the component will be remounted when the prop value is updated.
+     * (This behavior only applies to canvas)
+     */
+    forceRemount?: boolean;
+    /**
+     * If true, the prop can't be overriden in different variants.
+     */
+    invariantable?: boolean;
+}
+export interface Defaultable<Ctx extends any[], T> {
+    /**
+     * Default value to set for this prop when the component is instantiated
+     */
+    defaultValue?: T;
+    /**
+     * If no prop is given, the component uses a default; specify what
+     * that default is so the Plasmic user can see it in the studio UI
+     */
+    defaultValueHint?: T | ContextDependentConfig<Ctx, T | undefined>;
+    /**
+     * Use a dynamic value expression as the default instead
+     */
+    defaultExpr?: string;
+    defaultExprHint?: string;
+    /**
+     * This function validates whether the prop value is valid.
+     * If the value is invalid, it returns an error message. Otherwise, it returns true.
+     */
+    validator?: (value: T, ...args: Ctx) => (string | true) | Promise<string | true>;
+}
+export interface Controllable {
+    /**
+     * If true, this is a prop that should only be used inside Plasmic
+     * Studio for rendering artboards; will not be actually used in
+     * generated code.
+     */
+    editOnly?: boolean;
+    /**
+     * If specified, the value used for this prop will instead be
+     * mapped to the uncontrolledProp when generating code. This is
+     * useful if, for example, in the artboard, you want to use `value`
+     * prop to control the component, but in generated code, you want to
+     * map it to `defaultValue`.
+     */
+    uncontrolledProp?: string;
+}
+export type PropTypeBaseDefault<P, T> = PropTypeBase<ComponentControlContext<P>> & Defaultable<ComponentControlContext<P>, T> & Controllable;
+export type PlainStringType<P> = PropTypeBaseDefault<P, string> & PlainStringCore;
+export type CodeStringType<P> = PropTypeBaseDefault<P, string> & CodeStringCore;
+export type RichTextType<P> = PropTypeBaseDefault<P, string> & RichTextCore;
+export type HrefType<P> = PropTypeBaseDefault<P, string> & HrefCore;
+export type ColorType<P> = PropTypeBaseDefault<P, string> & ColorCore;
+export type DateStringType<P> = PropTypeBaseDefault<P, string> & DateStringCore;
+export type DateRangeStringsType<P> = PropTypeBaseDefault<P, [string, string]> & DateRangeStringsCore;
+export type ClassType<P> = PropTypeBase<ComponentControlContext<P>> & ClassCore;
+export type ThemeResetClassType<P> = PropTypeBase<ComponentControlContext<P>> & ThemeResetClassCore;
+export type CardPickerType<P> = PropTypeBaseDefault<P, string> & CardPickerCore<ComponentControlContext<P>>;
+export type RichStringType<P> = PlainStringType<P> | CodeStringType<P> | RichTextType<P> | ColorType<P> | ClassType<P> | ThemeResetClassType<P> | CardPickerType<P> | HrefType<P>;
+export type StringType<P> = "string" | "href" | RichStringType<P>;
+export type RichBooleanType<P> = PropTypeBaseDefault<P, boolean> & RichBooleanCore;
+export type BooleanType<P> = "boolean" | RichBooleanType<P>;
+export type GraphQLType<P> = PropTypeBaseDefault<P, GraphQLValue> & GraphQLCore<ComponentControlContext<P>>;
+export type NumberTypeBase<P> = PropTypeBaseDefault<P, number> & NumberTypeBaseCore<ComponentControlContext<P>>;
+export type PlainNumberType<P> = NumberTypeBase<P> & PlainNumberCore<ComponentControlContext<P>>;
+export type SliderNumberType<P> = NumberTypeBase<P> & SliderNumberCore<ComponentControlContext<P>>;
+export type RichNumberType<P> = PlainNumberType<P> | SliderNumberType<P>;
+export type NumberType<P> = "number" | RichNumberType<P>;
+export type ObjectType<P> = PropTypeBaseDefault<P, Record<string, any>> & ObjectTypeBaseCore<ComponentControlContext<P>, PropType<P>>;
+export type ArrayType<P> = PropTypeBaseDefault<P, any[]> & ArrayTypeBaseCore<ComponentControlContext<P>, PropType<P>>;
+export type JSONLikeType<P> = "object" | ObjectType<P> | ArrayType<P>;
+export type DataSourceType<P> = PropTypeBase<ComponentControlContext<P>> & DataSourceCore;
+export type RichDataPickerType<P> = PropTypeBaseDefault<P, DataPickerValueType> & RichDataPickerCore<ComponentControlContext<P>>;
+export type DataPickerType<P> = "dataPicker" | RichDataPickerType<P>;
+export type RichExprEditorType<P> = PropTypeBaseDefault<P, DataPickerValueType> & RichExprEditorCore<ComponentControlContext<P>>;
+export type ExprEditorType<P> = "exprEditor" | RichExprEditorType<P>;
+export type ComponentChoiceType<P, Opt extends ChoiceValue = ChoiceValue, Val = Opt | Opt[]> = PropTypeBaseDefault<P, Val> & ChoiceCore<ComponentControlContext<P>, Opt>;
+export interface SingleChoiceType<P, Opt extends ChoiceValue = ChoiceValue> extends ComponentChoiceType<P, Opt, Opt> {
+    multiSelect?: false;
+}
+export interface MultiChoiceType<P, Opt extends ChoiceValue = ChoiceValue> extends ComponentChoiceType<P, Opt, Opt[]> {
+    multiSelect: true;
+}
+export interface CustomChoiceType<P> extends ComponentChoiceType<P, ChoiceValue, ChoiceValue | ChoiceValue[]> {
+    multiSelect: ComponentContextConfig<P, boolean>;
+}
+export type ChoiceType<P> = SingleChoiceType<P> | MultiChoiceType<P> | CustomChoiceType<P>;
+export interface FormValidationRulesType<P> extends PropTypeBaseDefault<P, any> {
+    type: "formValidationRules";
+}
+export interface EventHandlerType<P> extends PropTypeBase<ComponentControlContext<P>> {
+    type: "eventHandler";
+    argTypes: {
+        name: string;
+        type: ArgType<any>;
+    }[];
+}
+export interface RichSlotType<P> {
+    type: "slot";
+    description?: string;
+    /**
+     * The unique names of all code components that can be placed in the slot
+     */
+    allowedComponents?: string[];
+    /**
+     * Wheter Plasmic Components with a root component included in the
+     * "allowedComponents" list are valid or not.
+     * Only used if the "allowedComponents" list is set.
+     */
+    allowRootWrapper?: boolean;
+    /**
+     * Whether the "empty slot" placeholder should be hidden in the canvas.
+     */
+    hidePlaceholder?: boolean;
+    /**
+     * Whether the slot is repeated, i.e., is rendered multiple times using
+     * repeatedElement().
+     */
+    isRepeated?: boolean;
+    /**
+     * A nicer, human-readable display name for your slot prop
+     */
+    displayName?: string;
+    /**
+     * Function for whether this slot should be hidden from the left tree,
+     * given the current props for this component
+     */
+    hidden?: ComponentContextConfig<P, boolean>;
+    /**
+     * If slot is a render prop (accepts a function that takes in some
+     * arguments and returns some JSX), then specify the names of the
+     * arguments expected by the render prop function.
+     */
+    renderPropParams?: string[];
+    /**
+     * When inserting top-level "page sections", should this slot be the default target?
+     */
+    unstable__isMainContentSlot?: boolean;
+    defaultValue?: PlasmicElement | PlasmicElement[];
+    /**
+     * When true, when you click for the first time in this slot and the component was not selected, the component itself
+     * is selected, making it easier to select the component instead of slot contents. So for
+     * instance, setting this on a Button slot ensures that clicking on the Button’s text will still select the Button and not
+     * the text element in its slot. Clicking again will deep-select the slot content. Similar in this regard to trapsFocus on components.
+     *
+     * Furthermore, the component further shows the props of whatever is in the slot on
+     *  the parent component for the user's convenience. Handy for various “wrapper" components, form fields, and so on.
+     */
+    mergeWithParent?: boolean | ComponentContextConfig<P, boolean>;
+    /**
+     * A function that returns true to hide the merged props conditionally.
+     */
+    hiddenMergedProps?: ComponentContextConfig<P, boolean>;
+}
+export type SlotType<P> = "slot" | RichSlotType<P>;
+export interface RichImageUrlType<P> extends PropTypeBaseDefault<P, string> {
+    type: "imageUrl";
+}
+export type ImageUrlType<P> = "imageUrl" | RichImageUrlType<P>;
+export interface ModalProps {
+    show?: boolean;
+    children?: React.ReactNode;
+    onClose: () => void;
+    style?: CSSProperties;
+}
+export interface StudioOps {
+    showModal: (modalProps: Omit<ModalProps, "onClose"> & {
+        onClose?: () => void;
+    }) => void;
+    refreshQueryData: () => void;
+    appendToSlot: (element: PlasmicElement, slotName: string) => void;
+    removeFromSlotAt: (pos: number, slotName: string) => void;
+    updateProps: (newValues: any) => void;
+    updateStates: (newValues: any) => void;
+}
+export interface ProjectData {
+    components: {
+        name: string;
+    }[];
+    pages: {
+        name: string;
+        pageMeta: {
+            path: string;
+        };
+    }[];
+}
+export interface CustomControlProps<P> {
+    componentProps: P;
+    /**
+     * `contextData` can be `null` if the prop controls are rendering before
+     * the component instance itself (it will re-render once the component
+     * calls `setControlContextData`)
+     */
+    contextData: InferDataType<P> | null;
+    /**
+     * Operations available to the editor that allow modifying the entire component.
+     * Can be null if the custom prop is used in a global context.
+     */
+    studioOps: StudioOps | null;
+    /**
+     * Metadata from the studio project.
+     */
+    projectData: ProjectData;
+    value: any;
+    /**
+     * Sets the value to be passed to the prop. Expects a JSON-compatible value.
+     */
+    updateValue: (newVal: any) => void;
+    /**
+     * Full screen modal component
+     */
+    FullscreenModal: React.ComponentType<ModalProps>;
+    /**
+     * Modal component for the side pane
+     */
+    SideModal: React.ComponentType<ModalProps>;
+    /**
+     * The document that the component will be rendered into; instead of using
+     * `document` directly (for, say, `document.querySelector()` etc.), you
+     * should use this instead.
+     */
+    studioDocument: typeof document;
+}
+export type CustomControl<P> = React.ComponentType<CustomControlProps<P>>;
+export interface RichCustomType<P> extends PropTypeBaseDefault<P, any> {
+    type: "custom";
+    control: CustomControl<P>;
+}
+export type CustomType<P> = RichCustomType<P> | CustomControl<P>;
+export type PrimitiveType<P = any> = Extract<StringType<P> | BooleanType<P> | NumberType<P> | JSONLikeType<P>, string>;
+export type PropType<P> = StringType<P> | BooleanType<P> | GraphQLType<P> | NumberType<P> | JSONLikeType<P> | DataSourceType<P> | DataPickerType<P> | ExprEditorType<P> | FormValidationRulesType<P> | EventHandlerType<P> | ChoiceType<P> | CustomType<P> | ImageUrlType<P> | SlotType<P> | DateStringType<P> | DateRangeStringsType<P>;
+export type ArgType<P> = Exclude<PropType<P>, SlotType<P> | EventHandlerType<P>>;
+export type StringCompatType<P> = DateStringType<P> | StringType<P> | ChoiceType<P> | JSONLikeType<P> | ImageUrlType<P> | CustomType<P> | DataPickerType<P>;
+export type BoolCompatType<P> = BooleanType<P> | CustomType<P> | DataPickerType<P>;
+export type NumberCompatType<P> = NumberType<P> | CustomType<P> | DataPickerType<P>;
+export type RestrictPropType<T, P> = T extends string ? StringCompatType<P> : T extends boolean ? BoolCompatType<P> : T extends number ? NumberCompatType<P> : PropType<P>;

package/registerComponent/dist/types/container-types.d.ts

@@ -0,0 +1,35 @@
+import { ContextDependentConfig } from "./shared-controls";
+export interface ObjectTypeBaseCore<Ctx extends any[], Fields> {
+    type: "object";
+    fields?: Record<string, Fields>;
+    nameFunc?: (item: any, ...args: Ctx) => string | undefined;
+}
+export interface ArrayTypeBaseCore<Ctx extends any[], Fields> {
+    type: "array";
+    itemType?: ObjectTypeBaseCore<Ctx, Fields>;
+    /**
+     * Optional function that determines whether the user can delete a given item.
+     */
+    unstable__canDelete?: (item: any, ...args: Ctx) => boolean;
+    /**
+     * Specify how to let Plasmic know how to update its own internal representation of the data when the value has
+     * changed, or when issuing a minimalValue or shownValue that is different.
+     *
+     * Important to specify this if you are expecting any nested expression values in this data type!
+     */
+    unstable__keyFunc?: (item: any) => any;
+    /**
+     * Specify what would be the tentative new value that is set if the user makes any changes.
+     *
+     * Useful for field mappings.
+     *
+     * For instance, consider a Table where we have a `fields` prop:
+     *
+     * - Initially, the value is undefined. But if the user makes any changes, we would want to save an array of at
+     *   least three items (corresponding to, say, three columns inferred from a schema).
+     *
+     * - Let's say there are 5 columns in the value. The data schema changes, removing a column and adding two new
+     *   ones. Now we would want a different minimal value, containing 6 items.
+     */
+    unstable__minimalValue?: ContextDependentConfig<Ctx, any>;
+}

package/registerComponent/dist/types/function-types.d.ts

@@ -0,0 +1,98 @@
+import { ChoiceCore, ChoiceValue } from "./choice-type";
+import { ArrayTypeBaseCore, ObjectTypeBaseCore } from "./container-types";
+import { GraphQLCore, GraphQLValue } from "./misc-types";
+import { DateRangeStringsCore, DateStringCore, NumberTypeBaseCore, RichBooleanCore } from "./primitive-types";
+import { CommonTypeBase, ContextDependentConfig, GenericContext } from "./shared-controls";
+import { Nullish } from "./type-utils";
+export type FunctionControlContext<P> = GenericContext<Partial<P>, // Partial function props
+any>;
+export type FunctionContextConfig<Args extends any[], R> = ContextDependentConfig<FunctionControlContext<Args>, R>;
+export interface BaseParam {
+    name: string;
+    description?: string;
+    isOptional?: boolean;
+    isRestParameter?: boolean;
+}
+export interface FunctionMeta<Args extends any[] = any> extends CommonTypeBase<FunctionControlContext<Args>> {
+    name: string;
+    rest?: boolean;
+}
+export interface PlainStringType<T extends Nullish<string> = string> extends BaseParam {
+    type: "string" | `'${T}'`;
+}
+export type StringType<P, T extends string = string> = "string" | PlainStringType<T> | ChoiceType<P, T> | DateStringType | DateRangeStringsType | AnyType;
+export interface PlainNumberType<T extends Nullish<number> = number> extends BaseParam {
+    type: "number" | `${number extends T ? number : T}`;
+}
+export type NumberType<P, T extends number = number> = PlainNumberType<T> | (BaseParam & NumberTypeBaseCore<FunctionControlContext<P>>) | ChoiceType<P, T> | AnyType;
+export interface PlainBooleanType<T extends Nullish<boolean> = boolean> extends BaseParam {
+    type: "boolean" | `${boolean extends T ? boolean : T}`;
+}
+export type BooleanType<P, T extends boolean = boolean> = PlainBooleanType<T> | (BaseParam & RichBooleanCore) | ChoiceType<P, T> | AnyType;
+export type GraphQLType<P> = BaseParam & GraphQLCore<FunctionControlContext<P>>;
+export interface PlainNullType extends BaseParam {
+    type: "null";
+}
+export type NullType = PlainNullType | AnyType;
+export interface PlainUndefinedType extends BaseParam {
+    type: "undefined";
+}
+export type UndefinedType = PlainUndefinedType | AnyType;
+export type ObjectType<P> = BaseParam & ObjectTypeBaseCore<FunctionControlContext<P>, AnyTyping<P, any>>;
+export type ArrayType<P> = BaseParam & ArrayTypeBaseCore<FunctionControlContext<P>, AnyTyping<P, any>>;
+export interface PlainAnyType extends BaseParam {
+    type: "any";
+}
+export type AnyType = PlainAnyType;
+export interface PlainVoidType extends BaseParam {
+    type: "void";
+}
+export type VoidType = PlainVoidType | AnyType;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type CommonType<P, T> = T extends GraphQLValue ? GraphQLType<P> : T extends null ? NullType : T extends undefined ? UndefinedType : T extends Array<any> ? ArrayType<P> : T extends object ? ObjectType<P> : AnyType;
+type AnyTyping<P, T> = T extends string ? StringType<P, T> : T extends number ? NumberType<P, T> : T extends boolean ? BooleanType<P, T> : CommonType<P, T>;
+export type ToTuple<T> = T extends any[] ? T : never;
+export type FunctionChoiceType<Args, Opt extends ChoiceValue = ChoiceValue> = FunctionMeta<ToTuple<Args>> & ChoiceCore<FunctionControlContext<ToTuple<Args>>, Opt>;
+export interface SingleChoiceType<P, Opt extends ChoiceValue = ChoiceValue> extends FunctionChoiceType<P, Opt> {
+    multiSelect?: false;
+}
+export interface MultiChoiceType<P, Opt extends ChoiceValue = ChoiceValue> extends FunctionChoiceType<P, Opt> {
+    multiSelect: true;
+}
+export interface CustomChoiceType<P, Opt extends ChoiceValue = ChoiceValue> extends FunctionChoiceType<P, Opt> {
+    multiSelect: FunctionContextConfig<ToTuple<P>, boolean>;
+}
+export type ChoiceType<P, T extends ChoiceValue = ChoiceValue> = SingleChoiceType<P, T> | MultiChoiceType<P, T> | CustomChoiceType<P, T>;
+export type DateStringType = BaseParam & DateStringCore;
+export type DateRangeStringsType = BaseParam & DateRangeStringsCore;
+export type RestrictedType<P, T> = IsAny<T> extends true ? AnyTyping<P, T> : [
+    T
+] extends [string] ? StringType<P, T> : [T] extends [number] ? NumberType<P, T> : [T] extends [boolean] ? BooleanType<P, T> : T extends string | null | undefined ? Exclude<T, null | undefined> extends string ? StringType<P, T extends string ? T : string> : CommonType<P, T> : T extends number | null | undefined ? Exclude<T, null | undefined> extends number ? NumberType<P, T extends number ? T : number> : CommonType<P, T> : T extends boolean | null | undefined ? Exclude<T, null | undefined> extends boolean ? BooleanType<P, T extends boolean ? T : boolean> : CommonType<P, T> : CommonType<P, T>;
+export type ParamType<P, T> = RestrictedType<P, T>;
+export type RequiredParam<P, T> = ParamType<P, T> & {
+    isOptional?: false;
+    isRestParameter?: false;
+};
+export type OptionalParam<P, T> = ParamType<P, T> & {
+    isRestParameter?: false;
+};
+export type RestParam<P, T> = ParamType<P, T> & {
+    isOptional?: false;
+    isRestParameter: true;
+};
+type RequiredParams<T extends any[], U extends any[] = []> = Partial<T> extends T ? U : T extends [infer F, ...infer R] ? RequiredParams<R, [...U, F]> : U;
+type OptionalParams<T extends any[]> = T extends [
+    ...RequiredParams<T>,
+    ...infer R
+] ? [...R] : [];
+type HandleRequiredParams<P, R extends any[]> = R extends [infer H, ...infer T] ? [string | RequiredParam<P, H>, ...HandleRequiredParams<P, T>] : [];
+type HandleOptionalParams<P, R extends any[]> = R extends [infer H, ...infer T] ? [] | [
+    string | OptionalParam<P, H | undefined>,
+    ...HandleOptionalParams<P, T>
+] : R extends [] ? [] : R extends Array<infer T> ? [] | [RestParam<P, T[]>] : [];
+export type HandleParams<P extends any[]> = [
+    ...HandleRequiredParams<P, RequiredParams<P>>,
+    ...HandleOptionalParams<P, Required<OptionalParams<P>>>
+];
+export type HandleReturnType<P, T> = VoidType | ParamType<P, T>;
+export {};

package/registerComponent/dist/types/misc-types.d.ts

@@ -0,0 +1,28 @@
+import { ContextDependentConfig } from "./shared-controls";
+export interface RichExprEditorCore<Ctx extends any[]> {
+    type: "exprEditor";
+    data?: Record<string, any> | ContextDependentConfig<Ctx, Record<string, any>>;
+    isolateEnv?: boolean;
+}
+export interface DataSourceCore {
+    type: "dataSource";
+    dataSource: "airtable" | "cms";
+}
+export type DataPickerValueType = string | number | (string | number)[];
+export interface RichDataPickerCore<Ctx extends any[]> {
+    type: "dataSelector";
+    data?: Record<string, any> | ContextDependentConfig<Ctx, Record<string, any>>;
+    alwaysShowValuePathAsLabel?: boolean;
+    isolateEnv?: boolean;
+}
+export type GraphQLValue = {
+    query: string;
+    variables?: Record<string, any>;
+};
+export interface GraphQLCore<Ctx extends any[]> {
+    type: "code";
+    lang: "graphql";
+    endpoint: string | ContextDependentConfig<Ctx, string>;
+    method?: string | ContextDependentConfig<Ctx, string>;
+    headers?: object | ContextDependentConfig<Ctx, object>;
+}