@flexkit/studio 0.0.28 → 0.0.30

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { Dispatch, JSX, SetStateAction, UIEvent, ReactElement } from 'react';
-import { A as AppContextType, a as ActionSetRelationship, b as ActionSetScope, C as Config, c as AppOptions, E as Entity, P as PluginOptions, d as ProjectOptions, O as OrderedAssetValue, e as SearchRequestProps, f as SearchResultItem, U as UseEntityQueryParams, M as MappedEntityItem, F as FormEntityItem, I as ImageValue, g as Schema, h as AttributeValue, i as Attribute, j as MultipleRelationshipConnection, k as SingleRelationshipConnection } from './types.d-DiQPwK_q.js';
-export { D as DataType, l as DefaultValue, m as DefaultValueByDataType, n as EntityData, o as FormFieldParams, p as FormFieldProps, q as FormFieldValue, L as LogoProps, r as ScopeType, S as SingleProject } from './types.d-DiQPwK_q.js';
+import { A as AppContextType, a as ActionSetRelationship, b as ActionSetScope, C as Config, c as AppOptions, E as Entity, P as PluginOptions, d as ProjectOptions, O as OrderedAssetValue, S as SearchRequestProps, e as SearchResultItem, f as Attribute, U as UseEntityQueryParams, M as MappedEntityItem, F as FormEntityItem, I as ImageValue, g as Schema, h as AttributeValue, i as MultipleRelationshipConnection, j as SingleRelationshipConnection } from './types.d-CX3kDxFZ.js';
+export { D as DataType, k as DefaultValue, l as DefaultValueByDataType, m as EntityData, n as FormFieldParams, o as FormFieldProps, p as FormFieldValue, L as LogoProps, q as ScopeType, r as SingleProject } from './types.d-CX3kDxFZ.js';
 export { Outlet, useLocation, useParams } from 'react-router-dom';
 import { OperationVariables, DocumentNode, ErrorLike } from '@apollo/client';
 export { gql } from '@apollo/client';
@@ -92,12 +92,39 @@ declare function defineConfig<T extends Config>(config: T): T;
 
 declare function defineEntity<T extends Entity>(entity: T): Entity;
 
+/**
+ * Space bindings use OR semantics: a resource bound to ['finance', 'mkt'] is
+ * accessible to members of either space. Unbound resources are accessible to
+ * everyone. This is a UI convenience only — the server enforces the same
+ * rules through generated @authorization directives.
+ *
+ * `userSpaces === undefined` means membership is not known yet (auth still
+ * loading). Treat that as allowed so space-bound entities/attributes do not
+ * flicker out of the Desk sidebar, grids, and forms. Once auth resolves,
+ * `spaces` is always an array — possibly empty for users with no memberships.
+ */
+declare function canAccessSpaces(userSpaces: string[] | undefined, resourceSpaces: string[] | undefined): boolean;
+declare function filterAttributesForSpaces(attributes: Attribute[], userSpaces: string[] | undefined): Attribute[];
+declare function filterEntitiesForSpaces(schema: Entity[], userSpaces: string[] | undefined): Entity[];
+
+/**
+ * Viewers are read-only: the GraphQL route and the automations API reject
+ * their mutations server-side. This helper only mirrors that rule in the UI
+ * so restricted actions render as disabled instead of failing on submit.
+ * While the role is still unknown (auth loading) actions stay enabled and
+ * the server remains the source of truth.
+ */
+declare function canMutateData(role: string | null | undefined): boolean;
+declare function useCanMutate(): boolean;
+
 type User = {
   id: string;
   email: string;
   display_name: string;
   avatar_url: string;
   role: string;
+  /** Space codes the user belongs to (owners receive every project space). */
+  spaces: string[];
 };
 
 type Auth = {
@@ -130,7 +157,9 @@ declare function useEntityQuery({ entityNamePlural, schema, scope, variables, is
     isLoadingMore: boolean;
     isProjectDisabled: boolean;
     isProjectReadOnly: boolean;
-    reload: () => void;
+    reload: (options?: {
+        preserve?: boolean;
+    }) => Promise<void>;
     schemaErrorMessage: string | null;
 };
 
@@ -173,6 +202,12 @@ type EntityQuery = {
 };
 declare function getEntityQuery(entityNamePlural: string, scope: string, schema: Schema, options?: {
     selection?: 'list' | 'full';
+    /**
+     * The top-level aggregate count is a filtered label scan on the server.
+     * Pagination pages (fetchMore) skip it — the total from the first page
+     * still stands.
+     */
+    includeCount?: boolean;
 }): EntityQuery;
 /**
  * Returns a string with the GraphQl query needed to mutate the dataToMutate object for the given entity and scope.
@@ -354,4 +389,4 @@ declare const assetSchema: Entity;
 
 declare const tagSchema: Entity;
 
-export { AppOptions, Attribute, AttributeValue, type ConfigContext, DataTable, DataTableColumnHeader, DataTableFacetedFilter, DataTableRowActions, DataTableSortedBy, DataTableToolbar, DataTableViewOptions, DefaultValueSwitch, Entity, type EntityListRowPatch, FlexkitStudio, FormEntityItem, IMAGES_BASE_URL, MappedEntityItem, PluginOptions, ProjectDisabled, Schema, SchemaError, SearchRequestProps, SearchResultItem, type UploadedFileResult, assetSchema, defineConfig, defineEntity, getEntityCreateMutation, getEntityDeleteMutation, getEntityDeleteWhere, getEntityQuery, getEntitySchema, getEntityUpdateMutation, tagSchema, useAppContext, useAppDispatch, useAuth, useConfig, useDispatch, useEntityMutation, useEntityQuery, useGraphQLError, useGridColumnsDefinition, usePatchEntityList, useRefreshEntityList, useSearch, useUploadAssets };
+export { AppOptions, Attribute, AttributeValue, type ConfigContext, DataTable, DataTableColumnHeader, DataTableFacetedFilter, DataTableRowActions, DataTableSortedBy, DataTableToolbar, DataTableViewOptions, DefaultValueSwitch, Entity, type EntityListRowPatch, FlexkitStudio, FormEntityItem, IMAGES_BASE_URL, MappedEntityItem, PluginOptions, ProjectDisabled, Schema, SchemaError, SearchRequestProps, SearchResultItem, type UploadedFileResult, assetSchema, canAccessSpaces, canMutateData, defineConfig, defineEntity, filterAttributesForSpaces, filterEntitiesForSpaces, getEntityCreateMutation, getEntityDeleteMutation, getEntityDeleteWhere, getEntityQuery, getEntitySchema, getEntityUpdateMutation, tagSchema, useAppContext, useAppDispatch, useAuth, useCanMutate, useConfig, useDispatch, useEntityMutation, useEntityQuery, useGraphQLError, useGridColumnsDefinition, usePatchEntityList, useRefreshEntityList, useSearch, useUploadAssets };