@proteos/sdk 0.46.0 → 0.47.0

package/dist/{types-D1PRIsSO.d.ts → types-oECz4xTQ.d.ts}

@@ -1428,6 +1428,8 @@ declare const LayoutElementType: {
     readonly Component: "component";
     readonly Divider: "divider";
     readonly Text: "text";
+    readonly RecordFilter: "record_filter";
+    readonly List: "list";
 };
 type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType];
 type RowElement = CommonProps & {
@@ -1548,6 +1550,70 @@ type ComponentElement = CommonProps & {
      *  to the host's 80px fallback when unset. */
     reserved_height?: number;
 };
+/**
+ * A filter builder placed directly on a page. It owns no data of its own: it
+ * publishes the filter (and the chosen subject entity) under its element id,
+ * and every `list` element naming that id in `filter_element_id` renders the
+ * filtered rows.
+ *
+ * `subject_entity` pins which entity the filter is authored against. When it is
+ * absent the element renders a subject picker over the entities its bound lists
+ * offer — one entry per bound list, since a list carries exactly one entity.
+ *
+ * The filter is in-memory: it resets on reload rather than persisting per user.
+ */
+type RecordFilterElement = CommonProps & {
+    type: 'record_filter';
+    subject_entity?: string;
+    /** `toolbar` (default) is the Filter button + active chips, matching every
+     *  list view. `panel` is the always-open AND/OR editor, for a page whose
+     *  point IS the filter. */
+    variant?: 'toolbar' | 'panel';
+    /** Nested AND/OR groups. Defaults to true — the records query carries the
+     *  whole tree, so there is no reason to hide the affordance. */
+    is_complex_enabled?: boolean;
+};
+/**
+ * Renders records of a configured List — the record-agnostic sibling of
+ * `related_list`, and the only way to show records on a page that has no
+ * record of its own.
+ *
+ * The List supplies everything about presentation and behaviour: columns,
+ * sorting, base filters, toolbar actions, selection mode, and which page a row
+ * opens. Naming more than one list makes the element switchable; the active one
+ * is chosen by the bound filter's subject picker, or by the element's own
+ * switcher when it is unbound.
+ *
+ * `filter_element_id` binds the element to a `record_filter` on the same page.
+ * The bound filter is ANDed with the list's own saved filters — it narrows the
+ * list, it never replaces what the list declared.
+ */
+type ListElement = CommonProps & {
+    type: 'list';
+    /** Slugs of the lists this element can render. At least one. */
+    list_slugs: string[];
+    /** Element id of the `record_filter` driving this list. Unbound renders the
+     *  list with its own filters only. */
+    filter_element_id?: string;
+    /**
+     * Record-page alternative to `filter_element_id`: the attribute on THIS
+     * page's record holding a saved filter (as written by the `record-filter`
+     * control). The list then renders what the record's own filter selects —
+     * a saved-segment record showing its matches.
+     *
+     * Mutually exclusive with `filter_element_id`: two filters driving one list
+     * has no defined precedence, so the layout validator rejects both at once.
+     * Record pages only — a standalone page has no record to read.
+     */
+    filter_attribute?: string;
+    /**
+     * Attribute on this page's record naming the subject entity slug. The
+     * element renders whichever of `list_slugs` targets that entity. Without
+     * it the first configured list wins. Pairs with `filter_attribute`.
+     */
+    subject_entity_attribute?: string;
+    page_size?: number;
+};
 type DividerElement = CommonProps & {
     type: 'divider';
 };
@@ -1557,7 +1623,7 @@ type TextElement = CommonProps & {
     variant: TextVariant;
     content: string;
 };
-type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement;
+type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement;
 declare const LayoutElementSchema: z.ZodType<LayoutElement>;
 
 /**
@@ -3051,6 +3117,19 @@ interface UpdateComponentRequest {
 }
 /**
  * List column definition.
+ *
+ * `attribute` is an attribute name or a dot path, told apart by the type of
+ * the first segment:
+ *
+ *   - `name` — an attribute on the list's own entity.
+ *   - `address.city` — a leaf inside one of its `object` attributes.
+ *   - `company_id.name` — a field of the RELATED record, reached through a
+ *     relation attribute (the first segment is the FK).
+ *
+ * A bare `object` attribute is not a valid column — it carries no value of
+ * its own, only leaves. Sorting follows the same grammar minus the relation
+ * hop: an attribute or an object path can be ordered by, a related field
+ * cannot (it would need a join).
  */
 interface Column {
     attribute: string;
@@ -3062,13 +3141,77 @@ interface Column {
  */
 type SortDirection = 'asc' | 'desc';
 /**
- * Sort configuration.
+ * Sort configuration. `attribute` is an attribute name or an object path
+ * (`address.city`); relation paths are not sortable — ordering by a related
+ * field would need a join the records query doesn't do.
  */
 interface SortConfig {
     attribute: string;
     direction: SortDirection;
 }
 
+/**
+ * What a page toolbar button invokes. Absent normalizes to `action` (pages
+ * persisted before `kind` existed).
+ */
+type PageActionKind = 'action' | 'workflow';
+/**
+ * Page action definition — one toolbar button. `kind: action` invokes a
+ * function-service Action by slug (`action`) and may prefill its params;
+ * `kind: workflow` starts a manual run of a workflow by key (`workflow`) and
+ * may prefill its manual-trigger inputs. `params` / `inputs` map target field
+ * names to Liquid templates rendered against the page scope
+ * `{ record, entity, params, user }`; a resolved field is locked in the invoke
+ * dialog. `skip_confirmation` fires the target immediately when every required
+ * field resolved from the templates.
+ */
+interface PageAction {
+    label: string;
+    icon: string;
+    kind?: PageActionKind;
+    action?: string;
+    workflow?: string;
+    params?: Record<string, string>;
+    inputs?: Record<string, string>;
+    skip_confirmation?: boolean;
+}
+declare const PageActionSchema: z.ZodObject<{
+    label: z.ZodString;
+    icon: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<["action", "workflow"]>>;
+    action: z.ZodOptional<z.ZodString>;
+    workflow: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    skip_confirmation: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    icon: string;
+    params?: Record<string, string> | undefined;
+    action?: string | undefined;
+    workflow?: string | undefined;
+    kind?: "action" | "workflow" | undefined;
+    inputs?: Record<string, string> | undefined;
+    skip_confirmation?: boolean | undefined;
+}, {
+    label: string;
+    icon: string;
+    params?: Record<string, string> | undefined;
+    action?: string | undefined;
+    workflow?: string | undefined;
+    kind?: "action" | "workflow" | undefined;
+    inputs?: Record<string, string> | undefined;
+    skip_confirmation?: boolean | undefined;
+}>;
+/**
+ * Whether a list's rows can be checked, and whether the checkboxes show from
+ * the start:
+ *
+ * - `on_demand` (default) — a Select toggle in the toolbar reveals them.
+ * - `always` — checkboxes are showing from the start.
+ * - `off` — rows can never be checked, even when the list carries actions.
+ */
+type SelectionMode = 'on_demand' | 'always' | 'off';
 /**
  * List configuration.
  * Note: List uses `slug` as its primary identifier, not `id`.
@@ -3080,6 +3223,15 @@ interface List extends AuditFields {
     name: string;
     entity_slug: string;
     columns: Column[];
+    /**
+     * Toolbar buttons on the list, same shape a page carries. They act on the
+     * rows SELECTED in the list, so an `action` button names an `entity_batch`
+     * action (invoked once with every selected record id) and prefill templates
+     * resolve against the list scope `{ selection, entity, user }`.
+     */
+    actions?: PageAction[];
+    /** Row-selection affordance; absent normalizes to `on_demand`. */
+    selection_mode?: SelectionMode;
     /** Record page to open from this list; empty/absent = org default for the entity. */
     default_page_slug?: string;
     sorting: SortConfig[];
@@ -3149,6 +3301,35 @@ declare const ListSchema: z.ZodObject<{
         label: string;
         attribute: string;
     }>, "many">;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        icon: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<["action", "workflow"]>>;
+        action: z.ZodOptional<z.ZodString>;
+        workflow: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        skip_confirmation: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }, {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }>, "many">>;
+    selection_mode: z.ZodOptional<z.ZodEnum<["on_demand", "always", "off"]>>;
     default_page_slug: z.ZodOptional<z.ZodString>;
     sorting: z.ZodArray<z.ZodObject<{
         attribute: z.ZodString;
@@ -3186,6 +3367,17 @@ declare const ListSchema: z.ZodObject<{
         direction: "asc" | "desc";
     }[];
     filters: FilterGroup[];
+    actions?: {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }[] | undefined;
+    selection_mode?: "on_demand" | "always" | "off" | undefined;
     default_page_slug?: string | undefined;
 }, {
     name: string;
@@ -3212,6 +3404,17 @@ declare const ListSchema: z.ZodObject<{
         direction: "asc" | "desc";
     }[];
     filters: FilterGroup[];
+    actions?: {
+        label: string;
+        icon: string;
+        params?: Record<string, string> | undefined;
+        action?: string | undefined;
+        workflow?: string | undefined;
+        kind?: "action" | "workflow" | undefined;
+        inputs?: Record<string, string> | undefined;
+        skip_confirmation?: boolean | undefined;
+    }[] | undefined;
+    selection_mode?: "on_demand" | "always" | "off" | undefined;
     default_page_slug?: string | undefined;
 }>;
 /**
@@ -3232,6 +3435,8 @@ interface CreateListRequest {
     entity_slug: string;
     name: string;
     columns: Column[];
+    actions?: PageAction[];
+    selection_mode?: SelectionMode;
     default_page_slug?: string;
     sorting: SortConfig[];
     filters: FilterGroup[];
@@ -3243,6 +3448,8 @@ interface UpdateListRequest {
     name?: string;
     module_slug?: string;
     columns?: Column[];
+    actions?: PageAction[];
+    selection_mode?: SelectionMode;
     /** Set to '' to clear back to the org default. */
     default_page_slug?: string;
     sorting?: SortConfig[];
@@ -3396,59 +3603,6 @@ interface UpdateListViewRequest {
     sorting?: SortConfig[];
     filters?: FilterGroup[];
 }
-/**
- * What a page toolbar button invokes. Absent normalizes to `action` (pages
- * persisted before `kind` existed).
- */
-type PageActionKind = 'action' | 'workflow';
-/**
- * Page action definition — one toolbar button. `kind: action` invokes a
- * function-service Action by slug (`action`) and may prefill its params;
- * `kind: workflow` starts a manual run of a workflow by key (`workflow`) and
- * may prefill its manual-trigger inputs. `params` / `inputs` map target field
- * names to Liquid templates rendered against the page scope
- * `{ record, entity, params, user }`; a resolved field is locked in the invoke
- * dialog. `skip_confirmation` fires the target immediately when every required
- * field resolved from the templates.
- */
-interface PageAction {
-    label: string;
-    icon: string;
-    kind?: PageActionKind;
-    action?: string;
-    workflow?: string;
-    params?: Record<string, string>;
-    inputs?: Record<string, string>;
-    skip_confirmation?: boolean;
-}
-declare const PageActionSchema: z.ZodObject<{
-    label: z.ZodString;
-    icon: z.ZodString;
-    kind: z.ZodOptional<z.ZodEnum<["action", "workflow"]>>;
-    action: z.ZodOptional<z.ZodString>;
-    workflow: z.ZodOptional<z.ZodString>;
-    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    skip_confirmation: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    label: string;
-    icon: string;
-    params?: Record<string, string> | undefined;
-    action?: string | undefined;
-    workflow?: string | undefined;
-    kind?: "action" | "workflow" | undefined;
-    inputs?: Record<string, string> | undefined;
-    skip_confirmation?: boolean | undefined;
-}, {
-    label: string;
-    icon: string;
-    params?: Record<string, string> | undefined;
-    action?: string | undefined;
-    workflow?: string | undefined;
-    kind?: "action" | "workflow" | undefined;
-    inputs?: Record<string, string> | undefined;
-    skip_confirmation?: boolean | undefined;
-}>;
 /**
  * Page type — encodes what the page binds to and how it is served (chrome +
  * auth posture both follow from it):
@@ -4101,4 +4255,4 @@ declare function isCurrentUserDefault(value: unknown): value is CurrentUserDefau
 /** Only the identity-valued attribute types can carry the sentinel. */
 declare function acceptsCurrentUserDefault(type: AttributeType): boolean;
 
-export { type EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalType as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type NumberAttributeMeta as bS, type ObjectAttributeMeta as bT, PAGE_BACKGROUND_TOKENS as bU, type PageBackgroundToken as bV, type PageLayoutSidePanel as bW, PageLayoutSidePanelSchema as bX, type PageStyle as bY, PageStyleSchema as bZ, type PrincipalAttributeMeta as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type RelatedListElement as c0, type RelatedRecordElement as c1, type ResponsiveSizing as c2, type RowElement as c3, type SectionElement as c4, type SizeValue as c5, SizeValueSchema as c6, type SizingProps as c7, type StringAttributeMeta as c8, type StringFormat as c9, type TabsElement as ca, type TextElement as cb, type TextVariant as cc, type UserAttributeMeta as cd, UserAttributeMetaSchema as ce, isBuiltInControl as cf, lookupCompatibleControls as cg, lookupControls as ch, lookupPrimaryControl as ci, parsePrincipalMeta as cj, parseUserMeta as ck, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };
+export { type EntityWithSchema as $, type AuditFields as A, type CreateListViewRequest as B, CURRENT_USER_DEFAULT as C, type CreateMenuConfigurationRequest as D, type CreatePageRequest as E, type FileRef as F, type CreateVariableRequest as G, type CurrencyAttributeMeta as H, CurrencyAttributeMetaSchema as I, type CurrencySymbolSide as J, type CurrencyValue as K, type ListOptions as L, type CurrentUserDefault as M, DEFAULT_OPTIONS as N, DEFAULT_PAGE_SIZE as O, PageIterator as P, DONE as Q, type DeployModuleRequest as R, type DesignReference as S, type DesignReferenceContent as T, type UserRef as U, DesignReferenceSchema as V, type DesignReferenceService as W, type Done as X, type Entity as Y, EntitySchema as Z, type EntityService as _, type Attribute as a, type Timestamps as a$, EntityWithSchemaSchema as a0, type EnumAttributeMeta as a1, type EnumValue as a2, type FileAttributeMeta as a3, FileRefSchema as a4, type FilterElement as a5, FilterElementSchema as a6, type FilterGroup as a7, FilterGroupSchema as a8, type List as a9, ModuleSchema as aA, type ModuleService as aB, type ModuleStatus as aC, type OnDeleteAction as aD, OnDeleteActionSchema as aE, PLATFORM_ATTRIBUTE_NAMES as aF, PLATFORM_USER_ID as aG, type Page as aH, type PageAction as aI, type PageActionKind as aJ, PageActionSchema as aK, type PageLayout as aL, PageLayoutSchema as aM, PageSchema as aN, type PageService as aO, type PageType as aP, type PublicPageComponent as aQ, type PublicPageResponse as aR, type RelationAttributeMeta as aS, RelationAttributeMetaSchema as aT, type RequestOptions as aU, type ResolvedClientOptions as aV, type ResponseMeta as aW, ResponseMetaSchema as aX, type SortConfig as aY, SortConfigSchema as aZ, type SortDirection as a_, type ListAppsOptions as aa, type ListComponentsOptions as ab, type ListDesignReferencesOptions as ac, type ListEntitiesOptions as ad, type ListFn as ae, type ListListViewsOptions as af, type ListListsOptions as ag, type ListMenuConfigurationsOptions as ah, type ListModulesOptions as ai, type ListPagesOptions as aj, ListSchema as ak, type ListService as al, type ListVariablesOptions as am, type ListView as an, ListViewSchema as ao, type ListViewService as ap, type LogicalOperator as aq, type MenuConfiguration as ar, MenuConfigurationSchema as as, type MenuConfigurationService as at, type MenuItem as au, MenuItemSchema as av, MenuItemType as aw, MetaClient as ax, type MetaListOptions as ay, type Module as az, type ListResult as b, type PrincipalAttributeMeta as b$, type TokenProvider as b0, type UpdateAppRequest as b1, type UpdateComponentRequest as b2, type UpdateDesignReferenceRequest as b3, type UpdateEntityRequest as b4, type UpdateListRequest as b5, type UpdateListViewRequest as b6, type UpdateMenuConfigurationRequest as b7, type UpdatePageRequest as b8, type UpdateVariableRequest as b9, type BuiltInControlSlug as bA, type CardElement as bB, type ColumnElement as bC, type CommonProps as bD, type ComponentElement as bE, type ControlBucket as bF, type DatetimeAttributeMeta as bG, type DatetimeFormat as bH, type DividerElement as bI, type FieldElement as bJ, FileAttributeMetaSchema as bK, type LayoutAlign as bL, type LayoutElement as bM, LayoutElementSchema as bN, LayoutElementType as bO, type LayoutGap as bP, type LayoutJustify as bQ, type LayoutTab as bR, type ListElement as bS, type NumberAttributeMeta as bT, type ObjectAttributeMeta as bU, PAGE_BACKGROUND_TOKENS as bV, type PageBackgroundToken as bW, type PageLayoutSidePanel as bX, PageLayoutSidePanelSchema as bY, type PageStyle as bZ, PageStyleSchema as b_, UserRefSchema as ba, type UserType as bb, type Variable as bc, VariableSchema as bd, type VariableService as be, acceptsCurrentUserDefault as bf, allCurrencyCodes as bg, createIterator as bh, createListResultSchema as bi, currencyLabel as bj, currencySymbol as bk, currencySymbolSide as bl, formatAmount as bm, formatMoney as bn, isCurrentUserDefault as bo, isPlatformAttributeName as bp, localeNumberSeparators as bq, parseAmount as br, parseCurrencyMeta as bs, parseFileMeta as bt, parseRelationMeta as bu, platformAttributes as bv, resolveOptions as bw, type AttributeForLookup as bx, type AttributeMeta as by, BUILT_IN_CONTROLS as bz, ProteosClient as c, type PrincipalType as c0, type RecordFilterElement as c1, type RelatedListElement as c2, type RelatedRecordElement as c3, type ResponsiveSizing as c4, type RowElement as c5, type SectionElement as c6, type SizeValue as c7, SizeValueSchema as c8, type SizingProps as c9, type StringAttributeMeta as ca, type StringFormat as cb, type TabsElement as cc, type TextElement as cd, type TextVariant as ce, type UserAttributeMeta as cf, UserAttributeMetaSchema as cg, isBuiltInControl as ch, lookupCompatibleControls as ci, lookupControls as cj, lookupPrimaryControl as ck, parsePrincipalMeta as cl, parseUserMeta as cm, type PrincipalRef as d, type PublicAccessOperation as e, type App as f, AppSchema as g, type AppService as h, type ArrayAttributeMeta as i, type AttributeAccessRule as j, type AttributeRestrictions as k, AttributeSchema as l, type AttributeType as m, AuditFieldsSchema as n, type ClientOptions as o, type Column as p, ColumnSchema as q, type ComparisonOperator as r, type Component as s, ComponentSchema as t, type ComponentService as u, type CreateAppRequest as v, type CreateComponentRequest as w, type CreateDesignReferenceRequest as x, type CreateEntityRequest as y, type CreateListRequest as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {

package/src/functions/actions.ts

@@ -61,6 +61,19 @@ export interface ActionService {
     slug: string,
     params: Record<string, unknown>,
   ): Promise<unknown>
+
+  /**
+   * Invokes an `entity_batch` action against a SET of records. The whole id
+   * array reaches the action in ONE invocation, so the result is a single
+   * aggregate payload, not one per record. `recordIds` must be non-empty;
+   * the server dedupes it, preserving order. Returns the unwrapped `result`.
+   */
+  invokeBatch(
+    entitySlug: string,
+    slug: string,
+    recordIds: string[],
+    params: Record<string, unknown>,
+  ): Promise<unknown>
 }
 
 /**
@@ -117,4 +130,20 @@ export class ActionServiceImpl implements ActionService {
     )
     return response.result
   }
+
+  async invokeBatch(
+    entitySlug: string,
+    slug: string,
+    recordIds: string[],
+    params: Record<string, unknown>,
+  ): Promise<unknown> {
+    // The one invoke route whose body is an envelope rather than the params
+    // object itself — an id array has nowhere to live in the path.
+    const response = await this.client.request<InvokeActionResponse>(
+      'POST',
+      `/functions/v1/entities/${entitySlug}/actions/${slug}/invoke`,
+      { record_ids: recordIds, params },
+    )
+    return response.result
+  }
 }

package/src/functions/types.ts

@@ -5,11 +5,13 @@ import { type AuditFields, AuditFieldsSchema } from '../types/common.js'
 
 /**
  * Scope of an action. `entity`-scoped actions are invoked against a
- * specific record; `global` actions take no record context.
+ * specific record; `entity_batch` actions against a SET of records of one
+ * entity (one invocation carrying every id, never one per record — they back
+ * a list's toolbar buttons); `global` actions take no record context.
  */
-export type ActionScope = 'entity' | 'global'
+export type ActionScope = 'entity' | 'entity_batch' | 'global'
 
-export const ActionScopeSchema = z.enum(['entity', 'global'])
+export const ActionScopeSchema = z.enum(['entity', 'entity_batch', 'global'])
 
 /**
  * Deployable, user-invokable operation. Mirrors `functionsmodel.Action`
@@ -21,7 +23,7 @@ export interface Action extends AuditFields {
   org_id: string
   module_slug: string
   scope: ActionScope
-  /** Present only when `scope === 'entity'`. */
+  /** Present only when `scope` is `entity` or `entity_batch`. */
   entity?: string
   name: string
   is_active: boolean

package/src/meta/layout/control-registry.json

@@ -25,7 +25,8 @@
     "currency",
     "knowledge-text",
     "file",
-    "file-viewer"
+    "file-viewer",
+    "record-filter"
   ],
   "controls": {
     "string": {
@@ -33,7 +34,8 @@
       "compatible": [
         "text",
         "textarea",
-        "password"
+        "password",
+        "record-filter"
       ],
       "byFormat": {
         "email": {

package/src/meta/layout/elements.ts

@@ -20,6 +20,8 @@ export const LayoutElementType = {
   Component: 'component',
   Divider: 'divider',
   Text: 'text',
+  RecordFilter: 'record_filter',
+  List: 'list',
 } as const
 export type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType]
 
@@ -151,6 +153,72 @@ export type ComponentElement = CommonProps & {
   reserved_height?: number
 }
 
+/**
+ * A filter builder placed directly on a page. It owns no data of its own: it
+ * publishes the filter (and the chosen subject entity) under its element id,
+ * and every `list` element naming that id in `filter_element_id` renders the
+ * filtered rows.
+ *
+ * `subject_entity` pins which entity the filter is authored against. When it is
+ * absent the element renders a subject picker over the entities its bound lists
+ * offer — one entry per bound list, since a list carries exactly one entity.
+ *
+ * The filter is in-memory: it resets on reload rather than persisting per user.
+ */
+export type RecordFilterElement = CommonProps & {
+  type: 'record_filter'
+  subject_entity?: string
+  /** `toolbar` (default) is the Filter button + active chips, matching every
+   *  list view. `panel` is the always-open AND/OR editor, for a page whose
+   *  point IS the filter. */
+  variant?: 'toolbar' | 'panel'
+  /** Nested AND/OR groups. Defaults to true — the records query carries the
+   *  whole tree, so there is no reason to hide the affordance. */
+  is_complex_enabled?: boolean
+}
+
+/**
+ * Renders records of a configured List — the record-agnostic sibling of
+ * `related_list`, and the only way to show records on a page that has no
+ * record of its own.
+ *
+ * The List supplies everything about presentation and behaviour: columns,
+ * sorting, base filters, toolbar actions, selection mode, and which page a row
+ * opens. Naming more than one list makes the element switchable; the active one
+ * is chosen by the bound filter's subject picker, or by the element's own
+ * switcher when it is unbound.
+ *
+ * `filter_element_id` binds the element to a `record_filter` on the same page.
+ * The bound filter is ANDed with the list's own saved filters — it narrows the
+ * list, it never replaces what the list declared.
+ */
+export type ListElement = CommonProps & {
+  type: 'list'
+  /** Slugs of the lists this element can render. At least one. */
+  list_slugs: string[]
+  /** Element id of the `record_filter` driving this list. Unbound renders the
+   *  list with its own filters only. */
+  filter_element_id?: string
+  /**
+   * Record-page alternative to `filter_element_id`: the attribute on THIS
+   * page's record holding a saved filter (as written by the `record-filter`
+   * control). The list then renders what the record's own filter selects —
+   * a saved-segment record showing its matches.
+   *
+   * Mutually exclusive with `filter_element_id`: two filters driving one list
+   * has no defined precedence, so the layout validator rejects both at once.
+   * Record pages only — a standalone page has no record to read.
+   */
+  filter_attribute?: string
+  /**
+   * Attribute on this page's record naming the subject entity slug. The
+   * element renders whichever of `list_slugs` targets that entity. Without
+   * it the first configured list wins. Pairs with `filter_attribute`.
+   */
+  subject_entity_attribute?: string
+  page_size?: number
+}
+
 export type DividerElement = CommonProps & {
   type: 'divider'
 }
@@ -175,6 +243,8 @@ export type LayoutElement =
   | ComponentElement
   | DividerElement
   | TextElement
+  | RecordFilterElement
+  | ListElement
 
 // ──────────────────────────────────────────────────────────── Schemas ──
 
@@ -265,6 +335,22 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
       props: z.record(z.unknown()).optional(),
       reserved_height: z.number().positive().optional(),
     }),
+    z.object({
+      type: z.literal('record_filter'),
+      ...commonPropsShape,
+      subject_entity: z.string().min(1).optional(),
+      variant: z.enum(['toolbar', 'panel']).optional(),
+      is_complex_enabled: z.boolean().optional(),
+    }),
+    z.object({
+      type: z.literal('list'),
+      ...commonPropsShape,
+      list_slugs: z.array(z.string().min(1)).min(1),
+      filter_element_id: z.string().min(1).optional(),
+      filter_attribute: z.string().min(1).optional(),
+      subject_entity_attribute: z.string().min(1).optional(),
+      page_size: z.number().int().positive().optional(),
+    }),
     z.object({
       type: z.literal('divider'),
       ...commonPropsShape,

package/src/meta/layout/index.ts

@@ -26,6 +26,8 @@ export {
   LayoutElementSchema,
   LayoutElementType,
   type LayoutTab,
+  type ListElement,
+  type RecordFilterElement,
   type RelatedListElement,
   type RelatedRecordElement,
   type RowElement,