@weaverse/core 0.7.48 → 0.7.50

package/dist/index.d.ts

@@ -0,0 +1,349 @@
+import * as Stitches from '@stitches/core';
+import { ForwardRefExoticComponent, RefObject } from 'react';
+import Stitches$1 from '@stitches/core/types/stitches';
+
+declare let stichesUtils: {
+    m: (value: string) => {
+        margin: string;
+    };
+    mt: (value: string) => {
+        marginTop: string;
+    };
+    mr: (value: string) => {
+        marginRight: string;
+    };
+    mb: (value: string) => {
+        marginBottom: string;
+    };
+    ml: (value: string) => {
+        marginLeft: string;
+    };
+    mx: (value: string) => {
+        marginLeft: string;
+        marginRight: string;
+    };
+    my: (value: string) => {
+        marginTop: string;
+        marginBottom: string;
+    };
+    size: (value: string) => {
+        width: string;
+        height: string;
+    };
+    px: (value: string) => {
+        paddingLeft: string;
+        paddingRight: string;
+    };
+    py: (value: string) => {
+        paddingTop: string;
+        paddingBottom: string;
+    };
+};
+declare function createGlobalStyles(stitches: Stitches$1): void;
+
+declare const isReactNative: boolean;
+declare const isBrowser: boolean;
+declare const isIframe: boolean;
+/**
+ * Deep merge two objects.
+ * @param target
+ * @param source
+ */
+declare function merge(target: Record<string, any>, source: Record<string, any>): {
+    [x: string]: any;
+};
+
+interface ProjectDataType {
+    items: ElementData[];
+    rootId: string;
+    script: {
+        css: string;
+        js: string;
+    };
+    pageId?: string;
+}
+interface InitializeData {
+    id: string;
+    handle: string;
+    data: ProjectDataType;
+    published: boolean;
+    projectKey?: string;
+    studioUrl?: string;
+}
+interface BreakPoints {
+    mobile: string;
+    desktop: string;
+}
+interface WeaverseType {
+    mediaBreakPoints?: BreakPoints;
+    appUrl?: string;
+    projectKey?: string;
+    projectData?: ProjectDataType;
+    isDesignMode?: boolean;
+    ssrMode?: boolean;
+}
+interface WeaverseElement {
+    Component: ForwardRefExoticComponent<any>;
+    type: string;
+    schema?: ElementSchema;
+    defaultCss?: ElementCSS;
+    permanentCss?: ElementCSS;
+}
+type CatalogGroup = "essential" | "composition" | "shopify";
+interface ElementCatalog {
+    name: string;
+    icon?: string;
+    group?: CatalogGroup;
+    data?: ElementDataInCatalog[];
+}
+interface ElementDataInCatalog extends Omit<ElementData, "id"> {
+    id: string | number;
+}
+type FlagType = "draggable" | "resizable" | "sortable" | "ignoreShortcutKeys" | "hasContextMenu" | "isSortableContext";
+type ElementFlags = Partial<Record<FlagType, boolean>>;
+type ChildElementSelector = string | string[];
+interface ChildElement {
+    label: string;
+    selector: ChildElementSelector;
+}
+type ParentType = "container" | "layout" | "root" | "product-details" | "product-info" | "collection.box" | "collection-box" | "article-box" | "article-list" | "slider" | "tab" | "accordion" | "accordion.wrapper";
+type GridSize = {
+    rowSpan: number;
+    colSpan: number;
+};
+type ToolbarAction = "general-settings" | "edit-text" | "duplicate" | "delete" | "copy-styles" | "paste-styles" | "move-up" | "move-down" | "toggle-visibility";
+interface ElementSchema {
+    title: string;
+    type: string;
+    parentTypes: ParentType[];
+    gridSize?: GridSize;
+    inspector?: ElementInspector;
+    toolbar?: (ToolbarAction | ToolbarAction[])[];
+    childElements?: ChildElement[];
+    catalog?: ElementCatalog;
+    flags?: ElementFlags;
+}
+interface ElementData {
+    id: string;
+    type: string;
+    childIds?: (string | number)[];
+    css?: ElementCSS;
+    [key: string]: any;
+}
+type WeaverseCSSProperties = Stitches.CSS & Partial<Record<keyof typeof stichesUtils, string | number>>;
+type ChildElementCSS = Partial<{
+    [selector: string]: WeaverseCSSProperties & ChildElementCSS;
+}>;
+interface ElementCSS {
+    "@desktop"?: WeaverseCSSProperties | ChildElementCSS;
+    "@mobile"?: WeaverseCSSProperties | ChildElementCSS;
+}
+interface ElementInspector {
+    settings?: (AdvancedGroup | BasicGroup)[];
+    styles?: (AdvancedGroup | BasicGroup)[];
+}
+interface AdvancedGroup {
+    groupType: AdvancedGroupType;
+    useData?: boolean;
+}
+interface BasicGroup {
+    groupType: "basic";
+    groupHeader: string;
+    inputs: BasicInput[];
+}
+type AdvancedGroupType = "border" | "alignment" | "background" | "dimensions" | "spacing" | "typography" | "visibility" | "shadows-and-effects" | "layout-background";
+interface BasicInput<ConfigsType = AdditionalInputConfigs> {
+    type: InputType;
+    label?: string;
+    binding?: "style" | "data";
+    /**
+     * The key of the value of the element data or styles
+     * @example
+     * // Bind to `element.data.title`
+     * name: "title"
+     * // Bind to `element.css["@desktop"].backgroundColor`
+     * name: "backgroundColor"
+     */
+    name?: string;
+    /**
+     * Additional options for inputs that require more configuration
+     */
+    configs?: ConfigsType;
+    /**
+     * Only display if condition matches.
+     *
+     * Format: `dataBindingKey.conditionalOperator.value`
+     *
+     * Supported operators: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`
+     *
+     * @example
+     * `clickAction.eq.openLink`
+     * `clickAction.ne.openLink`
+     * `imagesPerRow.gt.1`
+     */
+    condition?: string;
+    defaultValue?: string | number | boolean;
+    placeholder?: string;
+    helpText?: string;
+}
+type AdditionalInputConfigs = SelectInputConfigs | ToggleGroupConfigs | RangeInputConfigs | SortableInputConfigs | PositionInputConfigs;
+interface SelectInputConfigs {
+    options?: {
+        value: string;
+        label: string;
+        icon?: string;
+        weight?: string;
+    }[];
+}
+interface PositionInputConfigs {
+    positionValues: string[];
+}
+interface ToggleGroupConfigs {
+    options?: {
+        value: string;
+        label: string;
+        icon?: string;
+        weight?: string;
+    }[];
+}
+interface RangeInputConfigs {
+    min?: number;
+    max?: number;
+    step?: number;
+}
+type SortableItemAction = "add" | "edit" | "duplicate" | "delete" | "toggle-visibility";
+interface SortableInputConfigs {
+    actions: SortableItemAction[];
+}
+type InputType = "color" | "datepicker" | "image" | "range" | "select" | "sortable" | "switch" | "text" | "textarea" | "toggle-group" | "position" | "form" | "product" | "product-list" | "product-swatches" | "text-editor" | "custom.html" | "instagram" | "collection-list" | "collection" | "article-list" | "map-autocomplete";
+declare global {
+    interface Window {
+        WeaverseStudioBridge: any;
+        Blinkloader: any;
+    }
+}
+
+/**
+ * WeaverseItemStore is a store for Weaverse item, it can be used to subscribe/update the item data
+ * @param itemData {ElementData} Weaverse item data
+ * @param weaverse {Weaverse} Weaverse instance
+ * @example
+ * useEffect(() => {
+ *     let handleUpdate = (update: any) => {
+ *       setData({...update})
+ *     }
+ *     itemInstance.subscribe(handleUpdate)
+ *     return () => {
+ *       itemInstance.unsubscribe(handleUpdate)
+ *     }
+ * }, [])
+ */
+declare class WeaverseItemStore {
+    listeners: Set<any>;
+    ref: RefObject<HTMLElement>;
+    weaverse: Weaverse;
+    stitchesClass: string;
+    _data: ElementData;
+    _flags: ElementFlags;
+    constructor(itemData: ElementData, weaverse: Weaverse);
+    get _id(): string;
+    get _element(): HTMLElement | null;
+    get Element(): WeaverseElement | undefined;
+    set data(data: Omit<ElementData, "id" | "type">);
+    get data(): ElementData;
+    setData: (data: Omit<ElementData, "id" | "type">) => ElementData;
+    subscribe: (fn: any) => void;
+    unsubscribe: (fn: any) => void;
+    triggerUpdate: () => void;
+}
+declare class Weaverse {
+    /**
+     * The `weaverse-content-root` element of Weaverse SDK
+     */
+    contentRootElement: HTMLElement | undefined;
+    /**
+     * For storing, registering element React component from Weaverse or created by user/developer
+     */
+    elementInstances: Map<string, WeaverseElement>;
+    /**
+     * list of element/items store to provide data, handle state update, state sharing, etc.
+     */
+    itemInstances: Map<string | number, WeaverseItemStore>;
+    /**
+     * Weaverse base URL that can provide by user/developer. for local development, use localhost:3000
+     * @type {string}
+     */
+    appUrl: string;
+    /**
+     * Weaverse project key to access project data via API
+     * @type {string}
+     */
+    projectKey: string;
+    /**
+     * Weaverse project data, by default, user can provide project data via React Component:
+     * <WeaverseRoot defaultData={projectData} /> it will be used to server-side rendering
+     */
+    projectData: ProjectDataType;
+    /**
+     * storing subscribe callback function for any component that want to listen to the change of WeaverseRoot
+     * @type {Map<string, (data: any) => void>}
+     */
+    listeners: Set<any>;
+    /**
+     * check whether the sdk is isDesignMode or not
+     * if isDesignMode is true, it means the sdk is isDesignMode mode, render the editor UI
+     * else render the preview UI, plain HTML + CSS + React hydrate
+     * @type {boolean}
+     */
+    isDesignMode: boolean;
+    /**
+     * Use in element to optionally render special HTML for hydration
+     * @type {boolean}
+     */
+    ssrMode: boolean;
+    /**
+     * stitches instance for handling CSS stylesheet, media, theme for Weaverse project
+     */
+    stitchesInstance: Stitches$1 | any;
+    studioBridge?: any;
+    static WeaverseItemStore: typeof WeaverseItemStore;
+    mediaBreakPoints: BreakPoints;
+    /**
+     * constructor
+     * @param appUrl {string} Weaverse base URL that can provide by user/developer. for local development, use localhost:3000
+     * @param projectKey {string} Weaverse project key to access project data via API
+     * @param projectData {ProjectDataType} Weaverse project data, by default, user can provide project data via React Component.
+     * @param mediaBreakPoints {object} Pass down custom media query breakpoints or just use the default.
+     * @param isDesignMode {boolean} check whether the sdk is isDesignMode or not
+     * @param ssrMode {boolean} Use in element to optionally render special HTML for hydration
+     */
+    constructor({ appUrl, projectKey, projectData, mediaBreakPoints, isDesignMode, ssrMode }?: WeaverseType);
+    init({ appUrl, projectKey, projectData, mediaBreakPoints, isDesignMode, ssrMode }?: WeaverseType): void;
+    initialized: boolean;
+    initializeData: (data: InitializeData) => void;
+    loadStudio(): void;
+    /**
+     * register the custom React Component to Weaverse, store it into Weaverse.elementInstances
+     * @param element {WeaverseElement} custom React Component
+     */
+    registerElement(element: WeaverseElement): void;
+    initStitches: () => void;
+    subscribe(fn: any): void;
+    unsubscribe(fn: any): void;
+    triggerUpdate(): void;
+    /**
+     * fetch data from Weaverse API (https://weaverse.io/api/v1/project/:projectKey)
+     * @param fetch {fetch} custom fetch function, pass in custom fetch function if you want to use your own fetch function
+     * @param appUrl
+     * @param projectKey
+     */
+    static fetchProjectData({ fetch, appUrl, projectKey, }: {
+        fetch?: any;
+        appUrl?: string;
+        projectKey?: string;
+    }): any;
+    setProjectData(projectData: ProjectDataType): void;
+    initProjectItemData(): void;
+}
+
+export { AdditionalInputConfigs, AdvancedGroup, AdvancedGroupType, BasicGroup, BasicInput, BreakPoints, CatalogGroup, ChildElement, ChildElementCSS, ChildElementSelector, ElementCSS, ElementCatalog, ElementData, ElementDataInCatalog, ElementFlags, ElementInspector, ElementSchema, FlagType, GridSize, InitializeData, InputType, ParentType, PositionInputConfigs, ProjectDataType, RangeInputConfigs, SelectInputConfigs, SortableInputConfigs, SortableItemAction, ToggleGroupConfigs, ToolbarAction, Weaverse, WeaverseCSSProperties, WeaverseElement, WeaverseItemStore, WeaverseType, createGlobalStyles, isBrowser, isIframe, isReactNative, merge, stichesUtils };

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.7.48",
+  "version": "0.7.50",
   "license": "MIT",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",