@superblocksteam/library 2.0.12-next.2 → 2.0.12-next.21

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a0 as clientExports } from "./index-CCewmzC_.js";
-import { a1, a2, B, h, C, c, g, i, Y, D, O, Q, E, a3, L, a4, a5, a6, a7, l, n, d, a8, a9, v, aa, ab, M, ac, ad, ae, $, P, af, W, ag, ah, ai, aj, Z, u, R, v as v2, ak, al, S, am, e, q, A, an, ao, k, f, T, N, s, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, X, w, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, K, aZ, a_, a$, b0, b1, b2, z, b3, b4, b5, b6, b7, G, b8, b9, x, ba, bb, bc, r, J, H, bd, be, bf, y, F, bg, bh, bi, bj, bk, bl, bm, bn, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, bM, V, U, bN } from "./index-CCewmzC_.js";
+import { a0 as clientExports } from "./index-CH4jAtWn.js";
+import { a1, a2, B, h, C, c, g, i, Y, D, O, Q, E, a3, L, a4, a5, a6, a7, l, n, d, a8, a9, v, aa, ab, M, ac, ad, ae, $, P, af, W, ag, ah, ai, aj, Z, u, R, v as v2, ak, al, S, am, e, q, A, an, ao, k, f, T, N, s, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, X, w, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, K, aZ, a_, a$, b0, b1, b2, z, b3, b4, b5, b6, b7, G, b8, b9, x, ba, bb, bc, r, J, H, bd, be, bf, y, F, bg, bh, bi, bj, bk, bl, bm, bn, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, bM, V, U, bN } from "./index-CH4jAtWn.js";
 const createRoot = clientExports.createRoot;
 export {
   a1 as Await,

package/dist/{splitPathsBySizeLoader-BM6L8m2i.js → splitPathsBySizeLoader-2oYHBTYy.js}

@@ -1,4 +1,4 @@
-import { _ as __awaiter, a as __generator, p as pascalCase, b as IconSize } from "./index-CCewmzC_.js";
+import { _ as __awaiter, a as __generator, p as pascalCase, b as IconSize } from "./index-CH4jAtWn.js";
 var splitPathsBySizeLoader = function(name, size) {
   return __awaiter(void 0, void 0, void 0, function() {
     var key, pathsRecord;
@@ -31,4 +31,4 @@ var splitPathsBySizeLoader = function(name, size) {
 export {
   splitPathsBySizeLoader
 };
-//# sourceMappingURL=splitPathsBySizeLoader-BM6L8m2i.js.map
+//# sourceMappingURL=splitPathsBySizeLoader-2oYHBTYy.js.map

package/dist/{splitPathsBySizeLoader-BM6L8m2i.js.map → splitPathsBySizeLoader-2oYHBTYy.js.map}

@@ -1 +1 @@
-{"version":3,"file":"splitPathsBySizeLoader-BM6L8m2i.js","sources":["../../../node_modules/.pnpm/@blueprintjs+icons@5.20.0_@types+react@18.3.18_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@blueprintjs/icons/lib/esm/paths-loaders/splitPathsBySizeLoader.js"],"sourcesContent":["/*\n * Copyright 2023 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { __awaiter, __generator } from \"tslib\";\nimport { pascalCase } from \"change-case\";\nimport { IconSize } from \"../iconTypes\";\n/**\n * A dynamic loader for icon paths that generates separate chunks for the two size variants.\n */\nexport var splitPathsBySizeLoader = function (name, size) { return __awaiter(void 0, void 0, void 0, function () {\n    var key, pathsRecord;\n    return __generator(this, function (_a) {\n        switch (_a.label) {\n            case 0:\n                key = pascalCase(name);\n                if (!(size === IconSize.STANDARD)) return [3 /*break*/, 2];\n                return [4 /*yield*/, import(\n                    /* webpackChunkName: \"blueprint-icons-16px-paths\" */\n                    \"../generated/16px/paths\")];\n            case 1:\n                pathsRecord = _a.sent();\n                return [3 /*break*/, 4];\n            case 2: return [4 /*yield*/, import(\n                /* webpackChunkName: \"blueprint-icons-20px-paths\" */\n                \"../generated/20px/paths\")];\n            case 3:\n                pathsRecord = _a.sent();\n                _a.label = 4;\n            case 4: return [2 /*return*/, pathsRecord[key]];\n        }\n    });\n}); };\n//# sourceMappingURL=splitPathsBySizeLoader.js.map"],"names":[],"mappings":";AAqBU,IAAC,yBAAyB,SAAU,MAAM,MAAM;AAAE,SAAO,UAAU,QAAQ,QAAQ,QAAQ,WAAY;AAC7G,QAAI,KAAK;AACT,WAAO,YAAY,MAAM,SAAU,IAAI;AACnC,cAAQ,GAAG,OAAK;AAAA,QACZ,KAAK;AACD,gBAAM,WAAW,IAAI;AACrB,cAAI,EAAE,SAAS,SAAS,UAAW,QAAO,CAAC,GAAa,CAAC;AACzD,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEjB;AAAA,UAAyB,kBAAC;AAAA,QAClC,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,iBAAO,CAAC,GAAa,CAAC;AAAA,QAC1B,KAAK;AAAG,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEzB;AAAA,UAAyB,kBAAC;AAAA,QAC9B,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,aAAG,QAAQ;AAAA,QACf,KAAK;AAAG,iBAAO,CAAC,GAAc,YAAY,GAAG,CAAC;AAAA,MAC1D;AAAA,IACA,CAAK;AAAA,EACL,CAAC;AAAE;","x_google_ignoreList":[0]}
+{"version":3,"file":"splitPathsBySizeLoader-2oYHBTYy.js","sources":["../../../node_modules/.pnpm/@blueprintjs+icons@5.20.0_@types+react@18.3.18_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@blueprintjs/icons/lib/esm/paths-loaders/splitPathsBySizeLoader.js"],"sourcesContent":["/*\n * Copyright 2023 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { __awaiter, __generator } from \"tslib\";\nimport { pascalCase } from \"change-case\";\nimport { IconSize } from \"../iconTypes\";\n/**\n * A dynamic loader for icon paths that generates separate chunks for the two size variants.\n */\nexport var splitPathsBySizeLoader = function (name, size) { return __awaiter(void 0, void 0, void 0, function () {\n    var key, pathsRecord;\n    return __generator(this, function (_a) {\n        switch (_a.label) {\n            case 0:\n                key = pascalCase(name);\n                if (!(size === IconSize.STANDARD)) return [3 /*break*/, 2];\n                return [4 /*yield*/, import(\n                    /* webpackChunkName: \"blueprint-icons-16px-paths\" */\n                    \"../generated/16px/paths\")];\n            case 1:\n                pathsRecord = _a.sent();\n                return [3 /*break*/, 4];\n            case 2: return [4 /*yield*/, import(\n                /* webpackChunkName: \"blueprint-icons-20px-paths\" */\n                \"../generated/20px/paths\")];\n            case 3:\n                pathsRecord = _a.sent();\n                _a.label = 4;\n            case 4: return [2 /*return*/, pathsRecord[key]];\n        }\n    });\n}); };\n//# sourceMappingURL=splitPathsBySizeLoader.js.map"],"names":[],"mappings":";AAqBU,IAAC,yBAAyB,SAAU,MAAM,MAAM;AAAE,SAAO,UAAU,QAAQ,QAAQ,QAAQ,WAAY;AAC7G,QAAI,KAAK;AACT,WAAO,YAAY,MAAM,SAAU,IAAI;AACnC,cAAQ,GAAG,OAAK;AAAA,QACZ,KAAK;AACD,gBAAM,WAAW,IAAI;AACrB,cAAI,EAAE,SAAS,SAAS,UAAW,QAAO,CAAC,GAAa,CAAC;AACzD,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEjB;AAAA,UAAyB,kBAAC;AAAA,QAClC,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,iBAAO,CAAC,GAAa,CAAC;AAAA,QAC1B,KAAK;AAAG,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEzB;AAAA,UAAyB,kBAAC;AAAA,QAC9B,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,aAAG,QAAQ;AAAA,QACf,KAAK;AAAG,iBAAO,CAAC,GAAc,YAAY,GAAG,CAAC;AAAA,MAC1D;AAAA,IACA,CAAK;AAAA,EACL,CAAC;AAAE;","x_google_ignoreList":[0]}

package/dist/{splitPathsBySizeLoader-C3MBiqmb.js → splitPathsBySizeLoader-go6FZrRw.js}

@@ -1,4 +1,4 @@
-import { _ as __awaiter, a as __generator, p as pascalCase, I as IconSize } from "./index-CCewmzC_.js";
+import { _ as __awaiter, a as __generator, p as pascalCase, I as IconSize } from "./index-CH4jAtWn.js";
 var splitPathsBySizeLoader = function(name, size) {
   return __awaiter(void 0, void 0, void 0, function() {
     var key, pathsRecord;
@@ -31,4 +31,4 @@ var splitPathsBySizeLoader = function(name, size) {
 export {
   splitPathsBySizeLoader
 };
-//# sourceMappingURL=splitPathsBySizeLoader-C3MBiqmb.js.map
+//# sourceMappingURL=splitPathsBySizeLoader-go6FZrRw.js.map

package/dist/{splitPathsBySizeLoader-C3MBiqmb.js.map → splitPathsBySizeLoader-go6FZrRw.js.map}

@@ -1 +1 @@
-{"version":3,"file":"splitPathsBySizeLoader-C3MBiqmb.js","sources":["../../../node_modules/.pnpm/@blueprintjs+icons@5.18.1_@types+react@18.3.18_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@blueprintjs/icons/lib/esm/paths-loaders/splitPathsBySizeLoader.js"],"sourcesContent":["/*\n * Copyright 2023 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { __awaiter, __generator } from \"tslib\";\nimport { pascalCase } from \"change-case\";\nimport { IconSize } from \"../iconTypes\";\n/**\n * A dynamic loader for icon paths that generates separate chunks for the two size variants.\n */\nexport var splitPathsBySizeLoader = function (name, size) { return __awaiter(void 0, void 0, void 0, function () {\n    var key, pathsRecord;\n    return __generator(this, function (_a) {\n        switch (_a.label) {\n            case 0:\n                key = pascalCase(name);\n                if (!(size === IconSize.STANDARD)) return [3 /*break*/, 2];\n                return [4 /*yield*/, import(\n                    /* webpackChunkName: \"blueprint-icons-16px-paths\" */\n                    \"../generated/16px/paths\")];\n            case 1:\n                pathsRecord = _a.sent();\n                return [3 /*break*/, 4];\n            case 2: return [4 /*yield*/, import(\n                /* webpackChunkName: \"blueprint-icons-20px-paths\" */\n                \"../generated/20px/paths\")];\n            case 3:\n                pathsRecord = _a.sent();\n                _a.label = 4;\n            case 4: return [2 /*return*/, pathsRecord[key]];\n        }\n    });\n}); };\n//# sourceMappingURL=splitPathsBySizeLoader.js.map"],"names":[],"mappings":";AAqBU,IAAC,yBAAyB,SAAU,MAAM,MAAM;AAAE,SAAO,UAAU,QAAQ,QAAQ,QAAQ,WAAY;AAC7G,QAAI,KAAK;AACT,WAAO,YAAY,MAAM,SAAU,IAAI;AACnC,cAAQ,GAAG,OAAK;AAAA,QACZ,KAAK;AACD,gBAAM,WAAW,IAAI;AACrB,cAAI,EAAE,SAAS,SAAS,UAAW,QAAO,CAAC,GAAa,CAAC;AACzD,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEjB;AAAA,UAAyB,kBAAC;AAAA,QAClC,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,iBAAO,CAAC,GAAa,CAAC;AAAA,QAC1B,KAAK;AAAG,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEzB;AAAA,UAAyB,kBAAC;AAAA,QAC9B,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,aAAG,QAAQ;AAAA,QACf,KAAK;AAAG,iBAAO,CAAC,GAAc,YAAY,GAAG,CAAC;AAAA,MAC1D;AAAA,IACA,CAAK;AAAA,EACL,CAAC;AAAE;","x_google_ignoreList":[0]}
+{"version":3,"file":"splitPathsBySizeLoader-go6FZrRw.js","sources":["../../../node_modules/.pnpm/@blueprintjs+icons@5.18.1_@types+react@18.3.18_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@blueprintjs/icons/lib/esm/paths-loaders/splitPathsBySizeLoader.js"],"sourcesContent":["/*\n * Copyright 2023 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { __awaiter, __generator } from \"tslib\";\nimport { pascalCase } from \"change-case\";\nimport { IconSize } from \"../iconTypes\";\n/**\n * A dynamic loader for icon paths that generates separate chunks for the two size variants.\n */\nexport var splitPathsBySizeLoader = function (name, size) { return __awaiter(void 0, void 0, void 0, function () {\n    var key, pathsRecord;\n    return __generator(this, function (_a) {\n        switch (_a.label) {\n            case 0:\n                key = pascalCase(name);\n                if (!(size === IconSize.STANDARD)) return [3 /*break*/, 2];\n                return [4 /*yield*/, import(\n                    /* webpackChunkName: \"blueprint-icons-16px-paths\" */\n                    \"../generated/16px/paths\")];\n            case 1:\n                pathsRecord = _a.sent();\n                return [3 /*break*/, 4];\n            case 2: return [4 /*yield*/, import(\n                /* webpackChunkName: \"blueprint-icons-20px-paths\" */\n                \"../generated/20px/paths\")];\n            case 3:\n                pathsRecord = _a.sent();\n                _a.label = 4;\n            case 4: return [2 /*return*/, pathsRecord[key]];\n        }\n    });\n}); };\n//# sourceMappingURL=splitPathsBySizeLoader.js.map"],"names":[],"mappings":";AAqBU,IAAC,yBAAyB,SAAU,MAAM,MAAM;AAAE,SAAO,UAAU,QAAQ,QAAQ,QAAQ,WAAY;AAC7G,QAAI,KAAK;AACT,WAAO,YAAY,MAAM,SAAU,IAAI;AACnC,cAAQ,GAAG,OAAK;AAAA,QACZ,KAAK;AACD,gBAAM,WAAW,IAAI;AACrB,cAAI,EAAE,SAAS,SAAS,UAAW,QAAO,CAAC,GAAa,CAAC;AACzD,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEjB;AAAA,UAAyB,kBAAC;AAAA,QAClC,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,iBAAO,CAAC,GAAa,CAAC;AAAA,QAC1B,KAAK;AAAG,iBAAO,CAAC,GAAa;AAAA;AAAA,YAEzB;AAAA,UAAyB,kBAAC;AAAA,QAC9B,KAAK;AACD,wBAAc,GAAG,KAAM;AACvB,aAAG,QAAQ;AAAA,QACf,KAAK;AAAG,iBAAO,CAAC,GAAc,YAAY,GAAG,CAAC;AAAA,MAC1D;AAAA,IACA,CAAK;AAAA,EACL,CAAC;AAAE;","x_google_ignoreList":[0]}

package/dist-types/edit-mode/create-component.d.ts

@@ -1,10 +1,11 @@
-import { type PropertyInfo, type SbElement, type SourceLocation } from "@superblocksteam/library-shared/types";
-export declare const getUniqueName: (componentType: string) => string;
-export default function createComponent({ componentType, parent, scopeName, baseProperties, skipTriggerCreation, otherComponentsUpdates, }: {
+import type { PropertyInfo, SbElement, SourceLocation } from "@superblocksteam/library-shared/types";
+export declare const generateUniqueName: (componentType: string) => string;
+export default function createComponent({ componentType, parent, scopeName, baseProperties, skipSecondaryComponentsCreation, // will only create the primary component. Secondary components are usually trigger components (e.g: Button that triggers the modal)
+otherComponentsUpdates, }: {
     componentType: string;
     parent: SourceLocation;
     scopeName: string;
     baseProperties?: Record<string, PropertyInfo>;
-    skipTriggerCreation?: boolean;
+    skipSecondaryComponentsCreation?: boolean;
     otherComponentsUpdates?: Record<SbElement, Record<string, PropertyInfo>>;
 }): Promise<SbElement | undefined>;

package/dist-types/lib/internal-details/lib/evaluator/to-executables-or-values.d.ts

@@ -3,12 +3,15 @@ import type { SingleInputProp, InputProp, EntityFunction } from "./base-entity-m
 import type { LazyFunction } from "./lazy-function.js";
 import type { DataTypeString } from "@superblocksteam/library-shared/props";
 import type { EntityDerivedProp, EntityOutputProp } from "@superblocksteam/library-shared/types";
-type ExecutableType = "normal" | "mustache-bindings" | "external-function" | "event" | "lazy-function";
+type ExecutableType = "normal" | "function" | "mustache-bindings" | "external-function" | "event" | "lazy-function";
 export type ExecutableOrValue = {
     type: ExecutableType;
 } & ({
     type: "normal";
-    value: EntityDerivedProp | EntityOutputProp;
+    value: EntityOutputProp;
+} | {
+    type: "function";
+    value: EntityDerivedProp;
 } | {
     type: "mustache-bindings";
     value: EntityDerivedProp | EntityOutputProp;

package/dist-types/lib/internal-details/lib/features/api-store.d.ts

@@ -6,7 +6,7 @@ export type ApiResult<T = any> = {
 };
 declare class ApiManager {
     readonly rootStore: RootStore;
-    baseUrl: string | undefined;
+    agentUrls: string[];
     private token;
     private accessToken;
     private apisByName;

package/dist-types/lib/internal-details/lib/types.d.ts

@@ -102,10 +102,15 @@ export type FromParentToChildMessageTypesMap = {
         appId: string;
         token: string;
         accessToken: string;
-        agentUrl: string;
+        /** @deprecated Use agentUrls instead */
+        agentUrl?: string;
+        agentUrls: string[];
         logContext: Record<string, unknown>;
     };
     "sb-editor-request-bootstrap": void;
+    "sb-update-active-agents": {
+        agentUrls: string[];
+    };
     "sb-update-property-with-effects": {
         sourceId: string;
         callbackId: string;
@@ -159,7 +164,7 @@ export type FromParentToChildMessageTypesMap = {
         parent: SourceLocation;
         scopeName: string;
         baseProperties?: Record<string, PropertyInfo>;
-        skipTriggerCreation?: boolean;
+        skipSecondaryComponentsCreation?: boolean;
         otherComponentsUpdates?: Record<SbElement, Record<string, PropertyInfo>>;
     };
     /**

package/dist-types/lib/internal-details/sb-wrapper.d.ts

@@ -1,11 +1,16 @@
 import React from "react";
 import type { ExternalProps, InternalProps, PropertiesDefinition, RawPropsToExternal } from "../user-facing/properties-panel/props-builder.js";
-import type { AnonymousSbEntity, PropertyInfo } from "@superblocksteam/library-shared/types";
+import type { AnonymousSbEntity, CreateChild, PropertyInfo } from "@superblocksteam/library-shared/types";
 export type DropTargetProps = {
     dropTargetRef?: React.RefObject<HTMLDivElement>;
 };
+export type ParentInfo = {
+    isGridLike: boolean;
+    type?: string;
+};
 export interface CreationContext {
     generateUniqueName: (baseName: string) => string;
+    parentInfo: ParentInfo;
 }
 export type PropertyValues<Def extends PropertiesDefinition> = {
     [K in keyof GetAllPropsFromDefinition<Def>]?: PropertyInfo | PropertyValues<Def>;
@@ -22,13 +27,43 @@ export interface EditorTemplate<Def extends PropertiesDefinition> {
         icon: string;
         description?: string;
     };
+    /***
+     * Config for the newly created component when added to the canvas from the Editor.
+     * @returns a single CreateRequest or an array of CreateRequests.
+     *
+     * When returning Array<CreateRequests>:
+     *  - The 1st CreateRequest's type must match the componentType passed to createComponent.
+     *  - The last CreateRequest's will be the selected component after drag & drop.
+     *
+     *  Example: [Modal, Button]
+     *  A modal that when drag & dropped on the page will add a trigger button.
+     *  The modal is closed by default, so the selected component after drop will be the trigger button.
+     */
     create?: (context: CreationContext) => CreateRequest<Def> | Array<CreateRequest<Def>>;
 }
 export interface CreateRequest<Def extends PropertiesDefinition> {
     type: string;
-    bind?: string;
+    /**
+     * Should it automatically generate a binding?
+     * e.g: <Input bind={Input1}>
+     *
+     * Default is false (no binding)
+     *
+     * `generateBinding` can also receive a string. e.g: "Input1".
+     *  This is useful if you need to create children components that rely on the parent's binding (e.g: a button inside a modal to close the modal).
+     *  To generate these unique names, you can use `context.generateUniqueName` and pass the component type (e.g: "Modal")
+     *
+     * A good rule of thumb:
+     * - Components that expose a user's input should have an automatically generated binding (e.g: Input, Checkbox, Table, etc)
+     * - Components that don't expose a user's input should not have an automatically generated binding (e.g: Button, Text, etc)
+     *
+     * Note:
+     * Apps builders can always manually set a binding on the editor or source code.
+     */
+    generateBinding?: boolean | string;
     properties?: PropertyValues<Def>;
     createAt?: "root" | "dropLocation";
+    children?: CreateChild[];
 }
 export interface ChainableComponent<PD extends PropertiesDefinition, EP extends ExternalProps<PD>> extends React.FC<EP> {
     addEditorTemplate: (config: EditorTemplate<PD>) => ChainableComponent<PD, EP>;

package/dist-types/lib/triggers/implementations/components/control-modal.d.ts

@@ -4,7 +4,9 @@ import type { WithBindingIdentifier } from "@superblocksteam/library-shared/type
 export declare const ControlModalTrigger: {
     type: "controlModal";
     execute(context: ExecutionContext, step: ControlModalStep): Promise<void>;
-    create(modal: WithBindingIdentifier, action: "open" | "close"): {
+    create(modal: WithBindingIdentifier, opts: {
+        action: "open" | "close";
+    }): {
         type: "controlModal";
         name: string | undefined;
         action: "close" | "open";

package/dist-types/lib/triggers/implementations/components/control-slideout.d.ts

@@ -4,7 +4,9 @@ import type { WithBindingIdentifier } from "@superblocksteam/library-shared/type
 export declare const ControlSlideoutTrigger: {
     type: "controlSlideout";
     execute(context: ExecutionContext, step: ControlSlideoutStep): Promise<void>;
-    create(slideout: WithBindingIdentifier, action: "open" | "close"): {
+    create(slideout: WithBindingIdentifier, opts: {
+        action: "open" | "close";
+    }): {
         type: "controlSlideout";
         name: string | undefined;
         action: "close" | "open";

package/dist-types/lib/triggers/implementations/navigate/navigate-to.d.ts

@@ -3,8 +3,7 @@ import type { NavigateToStep } from "@superblocksteam/library-shared/types";
 export declare const NavigateToTrigger: {
     type: "navigateTo";
     execute(_context: ExecutionContext, step: NavigateToStep): Promise<void>;
-    create(props: {
-        url: string;
+    create(url: string, opts?: {
         newWindow?: boolean;
         replaceHistory?: boolean;
         arguments?: string;

package/dist-types/lib/triggers/implementations/navigate/set-query-params.d.ts

@@ -4,9 +4,11 @@ import type { SetQueryParamsStep } from "@superblocksteam/library-shared/types";
 export declare const SetQueryParamsTrigger: {
     type: "setQueryParams";
     execute(_context: ExecutionContext, step: SetQueryParamsStep): Promise<void>;
-    create(queryParams: Record<string, ValueInputProp<string>>, keepQueryParams?: any): {
+    create(queryParams: Record<string, ValueInputProp<string>>, opts?: {
+        keep?: boolean;
+    }): {
         type: "setQueryParams";
         queryParams: Record<string, ValueInputProp<string>>;
-        keepQueryParams: any;
+        keepQueryParams: boolean;
     };
 };

package/dist-types/lib/triggers/implementations/navigate/utils.d.ts

@@ -0,0 +1 @@
+export declare const isValidUrlScheme: (url: string) => boolean;

package/dist-types/lib/triggers/implementations/set-profile.d.ts

@@ -3,7 +3,9 @@ import type { SetProfileStep } from "@superblocksteam/library-shared/types";
 export declare const SetProfileTrigger: {
     type: "setProfile";
     execute(_context: ExecutionContext, step: SetProfileStep): Promise<void>;
-    create(profileId: string, action: "set" | "unset"): {
+    create(profileId: string, opts: {
+        action: "set" | "unset";
+    }): {
         type: "setProfile";
         profileId: string;
         action: "unset" | "set";

package/dist-types/lib/triggers/implementations/show-alert.d.ts

@@ -4,7 +4,11 @@ import type { ShowAlertStep, NotificationType, ValueInputProp } from "@superbloc
 export declare const ShowAlertTrigger: {
     type: "showAlert";
     execute(context: ExecutionContext, step: ShowAlertStep): Promise<void>;
-    create(message: ValueInputProp<string>, alertType: NotificationType, alertDuration?: number, alertPosition?: NotificationPosition): {
+    create(message: ValueInputProp<string>, opts?: {
+        type?: NotificationType;
+        durationMs?: number;
+        position?: NotificationPosition;
+    }): {
         type: "showAlert";
         message: ValueInputProp<string>;
         style: NotificationType;

package/dist-types/lib/triggers/implementations/state/set-state-var.d.ts

@@ -4,9 +4,11 @@ import type { SetStateVarStep, WithBindingIdentifier } from "@superblocksteam/li
 export declare const SetStateVarTrigger: {
     type: "setStateVar";
     execute(context: ExecutionContext, step: SetStateVarStep): Promise<void>;
-    create(variable?: WithBindingIdentifier, value?: ValueInputProp): {
+    create(variable: WithBindingIdentifier, opts: {
+        value: ValueInputProp;
+    }): {
         type: "setStateVar";
-        variable: WithBindingIdentifier | undefined;
+        variable: WithBindingIdentifier;
         value: ValueInputProp;
     };
 };

package/dist-types/lib/triggers/implementations/timers/control-timer.d.ts

@@ -3,7 +3,9 @@ import type { ControlTimerStep, WithBindingIdentifier } from "@superblocksteam/l
 export declare const ControlTimerTrigger: {
     type: "controlTimer";
     execute(_context: ExecutionContext, step: ControlTimerStep): Promise<void>;
-    create(timer: WithBindingIdentifier, action: "start" | "stop" | "toggle"): {
+    create(timer: WithBindingIdentifier, opts: {
+        action: "start" | "stop" | "toggle";
+    }): {
         type: "controlTimer";
         timer: WithBindingIdentifier;
         action: "toggle" | "stop" | "start";

package/dist-types/lib/triggers/implementations/trigger-event.d.ts

@@ -3,9 +3,11 @@ import type { SelectedEventProps, TriggerEventStep } from "@superblocksteam/libr
 export declare const TriggerEventTrigger: {
     type: "triggerEvent";
     execute(_context: ExecutionContext, step: TriggerEventStep): Promise<void>;
-    create(eventName: string, eventPayload: Record<string, string>): {
+    create(eventName: string, opts?: {
+        data: Record<string, string>;
+    }): {
         type: "triggerEvent";
         event: SelectedEventProps;
-        eventPayload: Record<string, string>;
+        eventPayload: Record<string, string> | undefined;
     };
 };

package/dist-types/lib/user-facing/components/button/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/checkbox/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/column/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/container/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/date-picker/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/dropdown/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/icon/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/icon/index.d.ts

@@ -1,6 +1,6 @@
 export declare const Icon: import("../../../internal-details/sb-wrapper.jsx").ChainableComponent<{
     general: import("../../properties-panel/props-builder.js").Section<Record<string, import("../../properties-panel/props-builder.js").Prop<any, any, undefined>> & {
-        icon: import("../../properties-panel/props-builder.js").Prop<string, true, undefined>;
+        icon: import("../../properties-panel/props-builder.js").Prop<string, false, undefined>;
     }>;
     layout: import("../../properties-panel/props-builder.js").Section<Record<string, import("../../properties-panel/props-builder.js").Prop<any, any, undefined>> & {
         size: import("../../properties-panel/props-builder.js").Prop<import("@superblocksteam/library-shared").Dim<import("@superblocksteam/library-shared").DimModes>, true, undefined>;
@@ -23,7 +23,7 @@ export declare const Icon: import("../../../internal-details/sb-wrapper.jsx").Ch
     }>;
 }, import("../../properties-panel/props-builder.js").ExternalProps<{
     general: import("../../properties-panel/props-builder.js").Section<Record<string, import("../../properties-panel/props-builder.js").Prop<any, any, undefined>> & {
-        icon: import("../../properties-panel/props-builder.js").Prop<string, true, undefined>;
+        icon: import("../../properties-panel/props-builder.js").Prop<string, false, undefined>;
     }>;
     layout: import("../../properties-panel/props-builder.js").Section<Record<string, import("../../properties-panel/props-builder.js").Prop<any, any, undefined>> & {
         size: import("../../properties-panel/props-builder.js").Prop<import("@superblocksteam/library-shared").Dim<import("@superblocksteam/library-shared").DimModes>, true, undefined>;

package/dist-types/lib/user-facing/components/icon/props.d.ts

@@ -2,7 +2,7 @@ import { Dim } from "@superblocksteam/library-shared";
 import { Section, Prop } from "../../properties-panel/props-builder.js";
 export declare const propertiesDefinition: {
     general: Section<Record<string, Prop<any, any, undefined>> & {
-        icon: Prop<string, true, undefined>;
+        icon: Prop<string, false, undefined>;
     }>;
     layout: Section<Record<string, Prop<any, any, undefined>> & {
         size: Prop<Dim<import("@superblocksteam/library-shared").DimModes>, true, undefined>;

package/dist-types/lib/user-facing/components/image/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/key-value/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/modal/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/section/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/slideout/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/switch/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/table/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/components/text/editor-template.d.ts

@@ -0,0 +1,3 @@
+import type { propertiesDefinition } from "./props.js";
+import type { EditorTemplate } from "../../../internal-details/sb-wrapper.jsx";
+export declare const editorTemplate: EditorTemplate<typeof propertiesDefinition>;

package/dist-types/lib/user-facing/event-flow.d.ts

@@ -6,28 +6,52 @@ declare class EventFlow implements IEventFlow<StepDef, ScopedState, ValueInputPr
     static start(): EventFlow;
     static runJS(handler: (s: ScopedState | any, additionalProps?: Record<string, any>) => void): EventFlow;
     runJS(handler: (s: ScopedState | any, additionalProps?: Record<string, any>) => void): this;
-    static navigateTo(props: {
-        url: string;
+    static navigateTo(url: string, opts?: {
         newWindow?: boolean;
+        replaceHistory?: boolean;
+        arguments?: string;
     }): EventFlow;
-    navigateTo(props: {
-        url: string;
+    navigateTo(url: string, opts?: {
         newWindow?: boolean;
+        replaceHistory?: boolean;
+        arguments?: string;
     }): this;
     static navigateToApp(appId: string): EventFlow;
     navigateToApp(appId: string): this;
     static navigateToRoute(route: string): EventFlow;
     navigateToRoute(route: string): this;
-    static setQueryParams(params: Record<string, ValueInputProp<string>>, keepQueryParams?: boolean): EventFlow;
-    setQueryParams(params: Record<string, ValueInputProp<string>>, keepQueryParams?: boolean): this;
-    static controlSlideout(slideout: WithBindingIdentifier, action: "open" | "close"): EventFlow;
-    controlSlideout(slideout: WithBindingIdentifier, action: "open" | "close"): this;
-    static controlModal(modal: WithBindingIdentifier, action: "open" | "close"): EventFlow;
-    controlModal(modal: WithBindingIdentifier, action: "open" | "close"): this;
-    static controlTimer(stateTimer: WithBindingIdentifier, action: "start" | "stop" | "toggle"): EventFlow;
-    controlTimer(stateTimer: WithBindingIdentifier, action: "start" | "stop" | "toggle"): this;
-    static runApis(apis: any[], onSuccess?: EventFlow, onError?: EventFlow): EventFlow;
-    runApis(apis: any[], onSuccess?: EventFlow, onError?: EventFlow): this;
+    static setQueryParams(params: Record<string, ValueInputProp<string>>, opts?: {
+        keep?: boolean;
+    }): EventFlow;
+    setQueryParams(params: Record<string, ValueInputProp<string>>, opts?: {
+        keep?: boolean;
+    }): this;
+    static controlSlideout(slideout: WithBindingIdentifier, opts: {
+        action: "open" | "close";
+    }): EventFlow;
+    controlSlideout(slideout: WithBindingIdentifier, opts: {
+        action: "open" | "close";
+    }): this;
+    static controlModal(modal: WithBindingIdentifier, opts: {
+        action: "open" | "close";
+    }): EventFlow;
+    controlModal(modal: WithBindingIdentifier, opts: {
+        action: "open" | "close";
+    }): this;
+    static controlTimer(stateTimer: WithBindingIdentifier, opts: {
+        action: "start" | "stop" | "toggle";
+    }): EventFlow;
+    controlTimer(stateTimer: WithBindingIdentifier, opts: {
+        action: "start" | "stop" | "toggle";
+    }): this;
+    static runApis(apis: any[], opts?: {
+        onSuccess?: EventFlow;
+        onError?: EventFlow;
+    }): EventFlow;
+    runApis(apis: any[], opts?: {
+        onSuccess?: EventFlow;
+        onError?: EventFlow;
+    }): this;
     static cancelApis(apis: any[], onCancel?: EventFlow): EventFlow;
     cancelApis(apis: any[], onCancel?: EventFlow): this;
     static resetComponent(component: WithBindingIdentifier, opts?: {
@@ -38,8 +62,12 @@ declare class EventFlow implements IEventFlow<StepDef, ScopedState, ValueInputPr
     }): this;
     static resetStateVar(state: WithBindingIdentifier): EventFlow;
     resetStateVar(state: WithBindingIdentifier): this;
-    static setStateVar(stateVarName: WithBindingIdentifier, value: ValueInputProp): EventFlow;
-    setStateVar(stateVar: WithBindingIdentifier, value: ValueInputProp): this;
+    static setStateVar(stateVarName: WithBindingIdentifier, opts: {
+        value: ValueInputProp;
+    }): EventFlow;
+    setStateVar(stateVar: WithBindingIdentifier, opts: {
+        value: ValueInputProp;
+    }): this;
     static setComponentProperty(component: WithBindingIdentifier, opts: {
         property: string;
         value: ValueInputProp;
@@ -48,12 +76,28 @@ declare class EventFlow implements IEventFlow<StepDef, ScopedState, ValueInputPr
         property: string;
         value: ValueInputProp;
     }): this;
-    static showAlert(message: ValueInputProp<string>, alertType: NotificationType, alertDuration?: number, alertPosition?: NotificationPosition): EventFlow;
-    showAlert(message: ValueInputProp<string>, alertType: NotificationType, alertDuration?: number, alertPosition?: NotificationPosition): this;
-    static setProfile(profileId: string, action: "set" | "unset"): EventFlow;
-    setProfile(profileId: string, action: "set" | "unset"): this;
-    static triggerEvent(eventName: string, eventData: Record<string, string>): EventFlow;
-    triggerEvent(eventName: string, eventData: Record<string, string>): this;
+    static showAlert(message: ValueInputProp<string>, opts?: {
+        type?: NotificationType;
+        durationMs?: number;
+        position?: NotificationPosition;
+    }): EventFlow;
+    showAlert(message: ValueInputProp<string>, opts?: {
+        type?: NotificationType;
+        durationMs?: number;
+        position?: NotificationPosition;
+    }): this;
+    static setProfile(profileId: string, opts: {
+        action: "set" | "unset";
+    }): EventFlow;
+    setProfile(profileId: string, opts: {
+        action: "set" | "unset";
+    }): this;
+    static triggerEvent(eventName: string, opts?: {
+        data: Record<string, string>;
+    }): EventFlow;
+    triggerEvent(eventName: string, opts?: {
+        data: Record<string, string>;
+    }): this;
     static sequence(eventFlows: EventFlow[]): EventFlow;
     sequence(eventFlows: EventFlow[]): this;
     build(): StepDef[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/library",
-  "version": "2.0.12-next.2",
+  "version": "2.0.12-next.21",
   "type": "module",
   "exports": {
     ".": {
@@ -33,7 +33,7 @@
     "@react-hook/resize-observer": "1.2.6",
     "@superblocksteam/fast-deep-equal": "3.1.4",
     "@superblocksteam/iso-currency": "2.0.0",
-    "@superblocksteam/library-shared": "2.0.12-next.2",
+    "@superblocksteam/library-shared": "2.0.12-next.21",
     "@superblocksteam/shared": "0.9160.0",
     "antd": "4.24.15",
     "apca-w3": "^0.1.9",