@superblocksteam/library 2.0.6-next.57 → 2.0.6-next.59

package/dist/index.js

@@ -1,5 +1,5 @@
-import { a0 as clientExports } from "./index-fmpMMpkS.js";
-import { a1, a2, Y, P, Q, a3, O, a4, a5, a6, a7, a8, a9, C, aa, ab, ac, ad, ae, $, af, W, ag, ah, ai, aj, Z, B, S, s, d, e, q, u, n, R, D, w, x, f, i, g, C as C2, c, k, v, l, h, z, y, A, ak, al, am, an, ao, T, 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, E, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, N, aZ, a_, a$, b0, b1, b2, H, b3, b4, b5, b6, b7, K, b8, b9, F, ba, bb, bc, r, M, L, bd, be, bf, X, G, J, 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-fmpMMpkS.js";
+import { a0 as clientExports } from "./index-1LMlc1Q6.js";
+import { a1, a2, Y, P, Q, a3, O, a4, a5, a6, a7, a8, a9, C, aa, ab, ac, ad, ae, $, af, W, ag, ah, ai, aj, Z, B, S, s, d, e, q, u, n, R, D, w, x, f, i, g, C as C2, c, k, v, l, h, z, y, A, ak, al, am, an, ao, T, 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, E, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, N, aZ, a_, a$, b0, b1, b2, H, b3, b4, b5, b6, b7, K, b8, b9, F, ba, bb, bc, r, M, L, bd, be, bf, X, G, J, 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-1LMlc1Q6.js";
 const createRoot = clientExports.createRoot;
 export {
   a1 as Await,

package/dist/{splitPathsBySizeLoader-Z2MNgkRA.js → splitPathsBySizeLoader-BtCO3mSJ.js}

@@ -1,4 +1,4 @@
-import { _ as __awaiter, a as __generator, p as pascalCase, I as IconSize } from "./index-fmpMMpkS.js";
+import { _ as __awaiter, a as __generator, p as pascalCase, I as IconSize } from "./index-1LMlc1Q6.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-Z2MNgkRA.js.map
+//# sourceMappingURL=splitPathsBySizeLoader-BtCO3mSJ.js.map

package/dist/{splitPathsBySizeLoader-Z2MNgkRA.js.map → splitPathsBySizeLoader-BtCO3mSJ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"splitPathsBySizeLoader-Z2MNgkRA.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-BtCO3mSJ.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/{splitPathsBySizeLoader-C-dfe3r6.js → splitPathsBySizeLoader-CyCuKl4N.js}

@@ -1,4 +1,4 @@
-import { _ as __awaiter, a as __generator, p as pascalCase, b as IconSize } from "./index-fmpMMpkS.js";
+import { _ as __awaiter, a as __generator, p as pascalCase, b as IconSize } from "./index-1LMlc1Q6.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-C-dfe3r6.js.map
+//# sourceMappingURL=splitPathsBySizeLoader-CyCuKl4N.js.map

package/dist/{splitPathsBySizeLoader-C-dfe3r6.js.map → splitPathsBySizeLoader-CyCuKl4N.js.map}

@@ -1 +1 @@
-{"version":3,"file":"splitPathsBySizeLoader-C-dfe3r6.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-CyCuKl4N.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-types/lib/internal-details/lib/evaluator/base-entity-manager.d.ts

@@ -1,9 +1,11 @@
-import type { ObserveListener } from "./deep-observe.js";
 import type { Name } from "./names.js";
 import type { ValidateFn } from "../../../user-facing/properties-panel/validators.js";
 import type { SbEventFlow } from "../../../user-facing/sb-event-flow.js";
 import type { BindingString, ComputedProperty } from "@superblocksteam/library-shared";
 import type { SbElement, SbInstance, ValidationState } from "@superblocksteam/library-shared/types";
+export type GetterOptions = {
+    useSuspense?: boolean;
+};
 export type EntityOutputProp = Exclude<null | undefined | string | number | boolean | object | bigint | any[], BindingString | EntityDerivedProp<any[]>>;
 export type EntityDerivedProp<ARGS extends any[] = any[]> = (this: Readonly<Entity>, state?: Readonly<ScopedState>, ...args: ARGS) => EntityOutputProp;
 export type Executable<ARGS extends any[] = any[]> = (this: Entity, state?: ScopedState, ...args: ARGS) => void;
@@ -30,8 +32,8 @@ export type InternalScope = {
     entityMeta: Record<string, Entity>;
     childScopes: Record<ScopeId, InternalScope>;
     idToName: Record<string, Name>;
-    getEntity(name: Name): Entity;
-    getEntityMeta(name: Name): Entity;
+    getEntity(name: Name, options?: GetterOptions): Entity;
+    getEntityMeta(name: Name, options?: GetterOptions): Entity;
     getEntityName(id: string): Name;
     setEntityName(id: string, name: Name, currentName?: Name): void;
 };
@@ -39,9 +41,9 @@ export interface IEntityManager {
     getFullState: Record<string, Entity>;
     getValidationState: Record<string, ValidationState>;
     getScopeName(scopeId: string): string;
-    getState(scopeId: string): ScopedState;
-    getEntity(scopeId: string, name: Name): Entity;
-    getEntityById(scopeId: string, id: SbInstance): Entity;
+    getState(scopeId: string, options?: GetterOptions): ScopedState;
+    getEntity(scopeId: string, name: Name, options?: GetterOptions): Entity;
+    getEntityById(scopeId: string, id: SbInstance, options?: GetterOptions): Entity;
     createScope(params: {
         name?: string;
         parentScopeId?: ScopeId;
@@ -96,5 +98,4 @@ export interface IEntityManager {
         value: SingleInputProp<T>;
         validator?: ValidateFn<T>;
     }): T;
-    observeScope(scopeId: string, listener: ObserveListener<InternalScope>): () => void;
 }

package/dist-types/lib/internal-details/lib/evaluator/create-scope-proxy.d.ts

@@ -1,2 +1,2 @@
 import type { ScopedState, InternalScope } from "./base-entity-manager.js";
-export declare function createScopeProxy(scopes: InternalScope[]): ScopedState;
+export declare function createScopeProxy(scopes: InternalScope[], useSuspense?: boolean): ScopedState;

package/dist-types/lib/internal-details/lib/evaluator/entity-manager.d.ts

@@ -1,7 +1,6 @@
 import { type ValidationState, type SbElement, type SbInstance } from "@superblocksteam/library-shared/types";
 import { type Name } from "./names.js";
-import type { IEntityManager, Executable, SingleInputProp, InternalScope, ScopedState, ScopeId, Entity, InputProp } from "./base-entity-manager.js";
-import type { ObserveListener } from "./deep-observe.js";
+import type { IEntityManager, Executable, SingleInputProp, InternalScope, ScopedState, ScopeId, Entity, InputProp, GetterOptions } from "./base-entity-manager.js";
 import type { ValidateFn } from "../../../user-facing/properties-panel/validators.js";
 import type { ComponentRegistry } from "../features/component-registry.js";
 export declare const GLOBAL_SCOPE_ID = "Global";
@@ -15,9 +14,9 @@ export declare class EntityManager implements IEntityManager {
     constructor(componentRegistry: ComponentRegistry, options?: {
         devtools?: boolean;
     });
-    getEntity(ScopeId: string, name: Name): Entity;
-    getEntityById(scopeId: string, id: SbInstance): Entity;
-    getState(scopeId: string): ScopedState;
+    getEntity(scopeId: string, name: Name, options?: GetterOptions): Entity;
+    getEntityById(scopeId: string, id: SbInstance, options?: GetterOptions): Entity;
+    getState(scopeId: string, options?: GetterOptions): ScopedState;
     getScopeName(scopeId: string): string;
     setValidationState(entityId: string, property: string, state: ValidationState): void;
     get getValidationState(): Record<string, ValidationState>;
@@ -42,6 +41,7 @@ export declare class EntityManager implements IEntityManager {
         sourceId?: SbElement;
     }): Name;
     private createEntityStructure;
+    private addInternalProperty;
     private addProperty;
     deleteEntity(params: {
         name: Name;
@@ -90,5 +90,4 @@ export declare class EntityManager implements IEntityManager {
         validator?: ValidateFn<T>;
     }): T;
     private getOrCreateAtom;
-    observeScope(scopeId: string, listener: ObserveListener<InternalScope>): () => void;
 }

package/dist-types/lib/internal-details/lib/evaluator/pretty-print-function.d.ts

@@ -1,2 +1,2 @@
 import type { EntityDerivedProp } from "./base-entity-manager.js";
-export declare const prettyPrintFunction: (func: EntityDerivedProp, args: any[]) => string;
+export declare const prettyPrintFunction: (func: EntityDerivedProp, args: any[], fnName: string) => string;

package/dist-types/lib/internal-details/lib/evaluator/sanitize-object.d.ts

@@ -0,0 +1,6 @@
+import type { Entity, ScopedState } from "./base-entity-manager";
+declare function sanitizeObject<T extends object>(obj: T): T;
+declare function sanitizeEntity<T extends Entity>(entity: T): T;
+declare function sanitizeScopedState(state: ScopedState): ScopedState;
+declare function sanitizedToJS<T>(value: T): T;
+export { sanitizeObject, sanitizeEntity, sanitizeScopedState, sanitizedToJS };

package/dist-types/lib/internal-details/lib/evaluator/suspense-helpers.d.ts

@@ -0,0 +1,8 @@
+declare const SuspenseSymbol: unique symbol;
+type SuspenseResult = {
+    __isSuspenseResult: typeof SuspenseSymbol;
+};
+declare function toJsOrSuspense<T extends Record<string, unknown>>(obj: T, key?: string): T | SuspenseResult;
+declare function removeSuspense<T extends Record<string, unknown>>(keys: string[], result: T | SuspenseResult, prevSafeResult: T | undefined): T;
+export { SuspenseSymbol, toJsOrSuspense, removeSuspense };
+export type { SuspenseResult };

package/dist-types/lib/internal-details/lib/evaluator/use-shallow-mobx-observer.d.ts

@@ -1 +1 @@
-export declare const useShallowMobxObserver: <T extends Record<string, unknown>>(obj: T) => T;
+export declare const useShallowMobxObserver: <T extends Record<string, unknown>>(obj: T, useSuspense?: boolean) => T;

package/dist-types/lib/internal-details/lib/features/component-registry.d.ts

@@ -14,6 +14,7 @@ export declare class ComponentRegistry implements ComponentRegistryShareState {
     private _typeRegistry;
     private _customComponentRegistry;
     private _managedPropsRegistry;
+    private _internalPropsRegistry;
     constructor(rootStore: RootStore);
     addType(type: string, component: Type): void;
     addCustomComponent(type: string, component: Type): void;
@@ -21,6 +22,14 @@ export declare class ComponentRegistry implements ComponentRegistryShareState {
     renameCustomComponent(oldName: string, newName: string): void;
     addManagedProps(type: string, props: ManagedPropsList): void;
     deleteManagedProps(type: string): void;
+    addInternalProps(type: string, props: Array<{
+        path: string;
+        factory: () => any;
+    }>): void;
+    getInternalProps(type: string): Array<{
+        path: string;
+        factory: () => any;
+    }>;
     get libraryComponentList(): string[];
     get customComponentList(): string[];
     get managedPropsRegistry(): Map<string, ManagedPropsList>;

package/dist-types/lib/user-facing/component-base/sb-component.d.ts

@@ -10,8 +10,12 @@ export type SbComponentProps<El = HTMLElement> = {
     maxWidth?: Dim;
     maxHeight?: Dim;
     sourceId?: SbElement;
-    reportInstanceId?: (instanceId: SbInstance) => void;
     marginLeft?: Dim<"columns">;
     marginTop?: Dim<"rows">;
     constraintTop?: string | string[];
+    /**
+     * undefined means auto, true means always loading, false means never loading
+     */
+    loading?: boolean;
+    reportInstanceId?: (instanceId: SbInstance) => void;
 } & Omit<React.HTMLAttributes<El>, "height" | "width" | "marginLeft" | "marginTop">;

package/dist-types/lib/user-facing/components/custom/register-custom-component.d.ts

@@ -2,7 +2,10 @@ import { Section } from "../../properties-panel/props-builder.js";
 import type { Prop, InternalProps } from "../../properties-panel/props-builder.js";
 import type { SbEventFlow } from "../../sb-event-flow.js";
 import type { ReactNode } from "react";
-declare const layoutPropDef: {
+declare const defaultSections: {
+    appearance: Section<Record<string, Prop<any, any, undefined>> & {
+        loading: Prop<boolean, true, undefined>;
+    }>;
     layout: Section<Record<string, Prop<any, any, undefined>> & {
         maxHeight?: Prop<import("@superblocksteam/library-shared").Dim<import("@superblocksteam/library-shared").DimModes>, false, undefined> | undefined;
         minHeight?: Prop<import("@superblocksteam/library-shared").Dim<import("@superblocksteam/library-shared").DimModes>, false, undefined> | undefined;
@@ -24,7 +27,7 @@ declare const layoutPropDef: {
 type WrappedEventProps<IP extends InternalProps<any>> = {
     [K in keyof IP]: IP[K] extends SbEventFlow | undefined ? () => Promise<void> : IP[K];
 };
-type SectionProps<PD extends Record<string, Prop<any>>> = Record<string, Section<PD>> & typeof layoutPropDef;
+type SectionProps<PD extends Record<string, Prop<any>>> = Record<string, Section<PD>> & typeof defaultSections;
 export type CustomComponentProps<PD extends Record<string, Prop<any>>, SP extends SectionProps<PD> = SectionProps<PD>, IP extends InternalProps<SP> = InternalProps<SP>> = WrappedEventProps<IP>;
 export declare function registerComponent<PD extends Record<string, Prop<any>>>(name: string, propertiesDefinition: PD, component: React.FC<CustomComponentProps<PD>>): import("react").FC<any>;
 export declare function isCustomComponent(child: ReactNode): boolean;

package/dist-types/lib/user-facing/components/input/input-component.d.ts

@@ -11,6 +11,7 @@ declare class InputComponent extends React.Component<InputComponentProps, InputC
     componentDidUpdate(prevProps: Readonly<InputComponentProps>): void;
     componentWillUnmount(): void;
     shouldComponentUpdate(prevProps: Readonly<InputComponentProps>, prevState: Readonly<InputComponentState>): boolean;
+    private processAndSetValue;
     onDebouncedValueChange: import("lodash").DebouncedFunc<(value: any) => void>;
     getInputDomElement: () => HTMLInputElement | null | undefined;
     ensureFocus: () => void;

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

@@ -324,7 +324,6 @@ export declare const SbTable: import("react").FC<import("../../properties-panel/
         maxLinesPerRow: import("../../properties-panel/props-builder.js").Prop<number, true, undefined>;
         loading: import("../../properties-panel/props-builder.js").Prop<boolean, true, undefined>;
         isVisible: import("../../properties-panel/props-builder.js").Prop<boolean, false, undefined>;
-        collapseWhenHidden: import("../../properties-panel/props-builder.js").Prop<boolean, false, undefined>;
         "searchProps.textStyle": import("../../properties-panel/props-builder.js").Prop<import("@superblocksteam/library-shared/types").TextStyleWithVariant, true, undefined>;
         "searchProps.backgroundColor": import("../../properties-panel/props-builder.js").Prop<string, true, undefined>;
         "searchProps.border": import("../../properties-panel/props-builder.js").Prop<import("@superblocksteam/library-shared/types").PerSideBorder, false, undefined>;

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

@@ -327,7 +327,6 @@ export declare const propertiesDefinition: {
         maxLinesPerRow: Prop<number, true, undefined>;
         loading: Prop<boolean, true, undefined>;
         isVisible: Prop<boolean, false, undefined>;
-        collapseWhenHidden: Prop<boolean, false, undefined>;
         "searchProps.textStyle": Prop<import("@superblocksteam/library-shared/types").TextStyleWithVariant, true, undefined>;
         "searchProps.backgroundColor": Prop<string, true, undefined>;
         "searchProps.border": Prop<import("@superblocksteam/library-shared/types").PerSideBorder, false, undefined>;

package/dist-types/lib/user-facing/entities/api/props.d.ts

@@ -1,7 +1,9 @@
 import { Section, Prop, type InternalProps } from "../../properties-panel/props-builder.js";
-export type ApiEntity = InternalProps<typeof propertiesDefinition> & {
+import { SuspensibleAPI } from "./suspensible-api.js";
+export type ApiEntity = Omit<InternalProps<typeof propertiesDefinition>, "_suspensibleApi"> & {
     run: () => Promise<any>;
     cancel: () => Promise<any>;
+    _suspensibleApi: SuspensibleAPI<any, any[]>;
 };
 export declare const propertiesDefinition: {
     events: Section<Record<string, Prop<any, any, undefined>> & {
@@ -11,10 +13,17 @@ export declare const propertiesDefinition: {
     metadata: Section<Record<string, Prop<any, any, undefined>> & {
         response: Prop<any, true, undefined>;
         error: Prop<any, true, undefined>;
-        isRunning: Prop<boolean, true, undefined>;
+        isLoading: Prop<boolean, true, undefined>;
     }>;
     functions: Section<Record<string, Prop<any, any, undefined>> & {
         run: Prop<import("../../../internal-details/lib/evaluator/base-entity-manager.js").EntityFunction<[], Promise<any>>, true, undefined>;
         cancel: Prop<import("../../../internal-details/lib/evaluator/base-entity-manager.js").EntityFunction<[], Promise<void>>, true, undefined>;
     }>;
+    internal: Section<Record<string, Prop<any, any, undefined>> & {
+        /**
+         * Internal SuspensibleAPI instance that manages loading states and React Suspense integration.
+         * This property is hidden from the public interface but accessible to other properties.
+         */
+        _suspensibleApi: Prop<SuspensibleAPI<any, []>, true, undefined>;
+    }>;
 };

package/dist-types/lib/user-facing/entities/api/suspensible-api.d.ts

@@ -0,0 +1,20 @@
+export declare class SuspensibleAPI<TData = any, TArgs extends any[] = any[]> {
+    private _response;
+    private _error;
+    private _promise;
+    private _isLoading;
+    private _runFn;
+    private _cancelFn;
+    constructor({ runFn, cancelFn, }: {
+        runFn: (...args: TArgs) => Promise<TData>;
+        cancelFn: (...args: TArgs) => Promise<void>;
+    });
+    /**
+     * Context-aware response getter that either returns data or throws promises to trigger React Suspense.
+     */
+    get response(): TData | undefined;
+    get isLoading(): boolean;
+    get error(): Error | undefined;
+    run(...args: TArgs): Promise<TData>;
+    cancel(...args: TArgs): Promise<void>;
+}

package/dist-types/lib/user-facing/properties-panel/create-managed-props-list.d.ts

@@ -1,5 +1,9 @@
 import { Section } from "./props-builder.js";
 import type { ManagedPropsList } from "./props-builder.js";
 export declare const RECORD_PATH_IDENTIFIER = "*";
+export declare function createInternalPropsList(sections: Record<string, Section>, parentPath?: string): Array<{
+    path: string;
+    factory: () => any;
+}>;
 declare function createManagedPropsList(sections: Record<string, Section>, parentPath?: string): ManagedPropsList;
 export { createManagedPropsList };

package/dist-types/lib/user-facing/properties-panel/props-builder.d.ts

@@ -162,6 +162,13 @@ declare class Prop<Type extends DataType, _HasDefault extends boolean = false, _
     static literal<T extends Readonly<string | number | boolean>>(value: T): Prop<T, true>;
     static event(): Prop<SbEventFlow>;
     static function<ARGS extends any[] = any[], RETURN = any>(implementation: EntityFunction<ARGS, RETURN>): Prop<EntityFunction<ARGS, RETURN>, true>;
+    /**
+     * Creates an internal property that is not exposed in the entity's public interface,
+     * not tracked for reactivity/syncing, and not serialized. This is useful for
+     * storing implementation details like SuspensibleAPI instances that other
+     * properties can reference via `this._propertyName`.
+     */
+    static internal<T = any>(factory: () => T): Prop<T, true>;
     /**
      * Creates a composite property, which is a property that contains nested properties. For example,
      * the following composite property:
@@ -212,6 +219,7 @@ declare class Prop<Type extends DataType, _HasDefault extends boolean = false, _
     writable(): this;
     readAndWrite(): this;
     default(de: SingleInputProp<DataType>): Prop<Type, true>;
+    computed(computeFn: SingleInputProp<DataType>): Prop<Type, true>;
     allowNestedBindings(): Prop<Type, true>;
     contextual<TContext extends any[] | undefined = any[]>(computedArgs?: EvaluateOrValueComputedArgs): Prop<Type, _HasDefault, TContext>;
     validate(validateFn: ((value: any) => ValidationResult<Type>) | ValidateFn<any>): this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/library",
-  "version": "2.0.6-next.57",
+  "version": "2.0.6-next.59",
   "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.6-next.57",
+    "@superblocksteam/library-shared": "2.0.6-next.59",
     "@superblocksteam/shared": "0.9160.0",
     "antd": "4.24.15",
     "apca-w3": "^0.1.9",