@proteos/sdk 0.56.0 → 0.57.1

package/dist/{types-GIkv5spC.d.ts → types-mC4i_Wk3.d.ts}

@@ -1508,6 +1508,22 @@ declare const FilterGroupSchema: z.ZodType<FilterGroup>;
  *   - "fill"  — grow to fill remaining space
  */
 type SizeValue = number | `${number}/${number}` | `${number}px` | `${number}%` | 'auto' | 'fill';
+/**
+ * A fixed CSS length — the subset of SizeValue the server accepts for
+ * `min_height` ("Npx" / "N%"). Mirrors `minHeightStringRe` in the
+ * metadata-service layout validator.
+ */
+type LengthValue = `${number}px` | `${number}%`;
+declare function isLengthValue(text: string): text is LengthValue;
+declare const LengthValueSchema: z.ZodType<LengthValue>;
+/**
+ * A page-style dimension (`layout.style.max_width` / `padding_*`): a length,
+ * "auto" or "fill" — never a fraction. Mirrors `styleSizeValueStringRe` in the
+ * metadata-service layout validator.
+ */
+type StyleSizeValue = LengthValue | 'auto' | 'fill';
+declare function isStyleSizeValue(text: string): text is StyleSizeValue;
+declare const StyleSizeValueSchema: z.ZodType<StyleSizeValue>;
 declare const SizeValueSchema: z.ZodType<SizeValue>;
 
 /**
@@ -1524,6 +1540,9 @@ type LayoutGap = 'xs' | 'sm' | 'md' | 'lg';
 interface SizingProps {
     width?: SizeValue;
     height?: SizeValue;
+    /** Floor under `height` (px or %). Under `height: 'fill'` in a column it
+     *  replaces the default 320px floor. */
+    min_height?: LengthValue;
     grow?: number;
     shrink?: number;
     align?: LayoutAlign;
@@ -1557,7 +1576,12 @@ interface CommonProps {
     visible_when?: FilterGroup;
     read_only_when?: FilterGroup;
     width?: SizeValue;
+    /** `fill` takes the remaining space in the parent: along a column it grows
+     *  (floored by `min_height`, default 320px); in a row it stretches to the
+     *  row's height. */
     height?: SizeValue;
+    /** Floor under `height`, px or %. */
+    min_height?: LengthValue;
     grow?: number;
     shrink?: number;
     align?: LayoutAlign;
@@ -1617,6 +1641,7 @@ declare const LayoutElementType: {
     readonly List: "list";
     readonly WorkflowTrigger: "workflow_trigger";
     readonly SchedulingPicker: "scheduling_picker";
+    readonly Calendar: "calendar";
 };
 type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType];
 type RowElement = CommonProps & {
@@ -1853,13 +1878,54 @@ type SchedulingPickerElement = CommonProps & {
     contact_id?: string;
     is_header_hidden?: boolean;
 };
+/** The grid views a `calendar` element can show; mirrors `metamodel.CalendarViewKinds`. */
+declare const CALENDAR_VIEW_KINDS: readonly ["day", "week", "month", "agenda"];
+type CalendarViewKind = (typeof CALENDAR_VIEW_KINDS)[number];
+/**
+ * Cap on `overlay_user_ids` (one team colour per overlaid user); mirrors
+ * `metamodel.CalendarMaxOverlayUsers`.
+ */
+declare const CALENDAR_MAX_OVERLAY_USERS = 8;
+/**
+ * A user's calendar embedded in a page: the in-page counterpart of
+ * `/org/:orgId/calendar`. `user_id` is `$current_user`, a Liquid template over
+ * the page scope (`{{ record.owner.id }}`) or a literal user id; writes (new
+ * event, drag, edit) are offered only when it resolves to the viewer — unless
+ * `is_hosted_create_allowed` opens creation through the displayed user.
+ */
+type CalendarElement = CommonProps & {
+    type: 'calendar';
+    user_id: string;
+    /** Initial view; `day` when absent. */
+    default_view?: CalendarViewKind;
+    /** Views the switcher offers; only `default_view` when absent. Must contain it. */
+    views?: CalendarViewKind[];
+    /** Liquid template for the initial anchor day (day key or datetime); today when absent. */
+    date?: string;
+    /**
+     * Record pages only: show only events linked to the page record
+     * (`record_entity_slug` + `record_id`) instead of the user's whole calendar.
+     */
+    is_record_scoped?: boolean;
+    /**
+     * Up to `CALENDAR_MAX_OVERLAY_USERS` further users drawn on the same grid in
+     * team colours, read-only. Each resolves like `user_id`.
+     */
+    overlay_user_ids?: string[];
+    /**
+     * When the calendar shows someone else: "New event" and drag-select create
+     * THROUGH that user (the viewer hosts the request, the event lands on the
+     * displayed user's calendar). Edit and move stay owner-only.
+     */
+    is_hosted_create_allowed?: boolean;
+};
 type TextVariant = 'heading' | 'subheading' | 'body' | 'caption' | 'callout' | 'block-title';
 type TextElement = CommonProps & {
     type: 'text';
     variant: TextVariant;
     content: string;
 };
-type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement | WorkflowTriggerElement | SchedulingPickerElement;
+type LayoutElement = RowElement | ColumnElement | SectionElement | CardElement | TabsElement | FieldElement | RelatedListElement | RelatedRecordElement | ComponentElement | DividerElement | TextElement | RecordFilterElement | ListElement | WorkflowTriggerElement | SchedulingPickerElement | CalendarElement;
 declare const LayoutTabSchema: z.ZodType<LayoutTab>;
 declare const LayoutElementSchema: z.ZodType<LayoutElement>;
 
@@ -1892,6 +1958,16 @@ declare const PageLayoutSidePanelSchema: z.ZodObject<{
  */
 declare const PAGE_BACKGROUND_TOKENS: readonly ["bg", "bg-2", "bg-3", "ink", "ink-2", "ink-3", "ink-4", "rule", "rule-2", "accent", "accent-2", "accent-ink", "success", "warning", "danger", "info"];
 type PageBackgroundToken = (typeof PAGE_BACKGROUND_TOKENS)[number];
+/**
+ * A raw CSS color a page background may use instead of a token: a hex literal
+ * or one of a few color functions with a restricted argument charset (no `;{}`,
+ * no `url(`), so a background can never smuggle arbitrary CSS. Keep in sync
+ * with `pageBackgroundColorRe` in the metadata-service layout validator.
+ */
+declare const PAGE_BACKGROUND_COLOR_RE: RegExp;
+/** True when `text` is a background the server accepts: a token or a color
+ *  matching PAGE_BACKGROUND_COLOR_RE, at most 64 characters. */
+declare function isPageBackground(text: string): boolean;
 /**
  * Per-page presentation of a standalone page shell: background color plus the
  * content container's max-width and side / top padding. Every field is
@@ -1904,29 +1980,30 @@ type PageBackgroundToken = (typeof PAGE_BACKGROUND_TOKENS)[number];
  * area rather than a standalone shell.
  */
 interface PageStyle {
-    /** Design-token key (see PAGE_BACKGROUND_TOKENS) or a raw CSS color. */
+    /** Design-token key (see PAGE_BACKGROUND_TOKENS) or a raw CSS color
+     *  matching PAGE_BACKGROUND_COLOR_RE. */
     background?: string;
-    /** Content max-width; `"fill"` / `"auto"` removes the cap. */
-    max_width?: SizeValue;
+    /** Content max-width; `"fill"` / `"auto"` removes the cap. Never a fraction. */
+    max_width?: StyleSizeValue;
     /** Horizontal / vertical padding of the content container (Tailwind px/py). */
-    padding_x?: SizeValue;
-    padding_y?: SizeValue;
+    padding_x?: StyleSizeValue;
+    padding_y?: StyleSizeValue;
 }
 declare const PageStyleSchema: z.ZodObject<{
-    background: z.ZodOptional<z.ZodString>;
-    max_width: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
-    padding_x: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
-    padding_y: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
+    background: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    max_width: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
+    padding_x: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
+    padding_y: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
 }, "strip", z.ZodTypeAny, {
     background?: string | undefined;
-    max_width?: SizeValue | undefined;
-    padding_x?: SizeValue | undefined;
-    padding_y?: SizeValue | undefined;
+    max_width?: StyleSizeValue | undefined;
+    padding_x?: StyleSizeValue | undefined;
+    padding_y?: StyleSizeValue | undefined;
 }, {
     background?: string | undefined;
-    max_width?: SizeValue | undefined;
-    padding_x?: SizeValue | undefined;
-    padding_y?: SizeValue | undefined;
+    max_width?: StyleSizeValue | undefined;
+    padding_x?: StyleSizeValue | undefined;
+    padding_y?: StyleSizeValue | undefined;
 }>;
 /**
  * Top-level page layout. Replaces the legacy `mainContent` / `side_panel`
@@ -1955,20 +2032,20 @@ declare const PageLayoutSchema: z.ZodObject<{
         is_sticky?: boolean | undefined;
     }>>;
     style: z.ZodOptional<z.ZodObject<{
-        background: z.ZodOptional<z.ZodString>;
-        max_width: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
-        padding_x: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
-        padding_y: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
+        background: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        max_width: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
+        padding_x: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
+        padding_y: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
     }, "strip", z.ZodTypeAny, {
         background?: string | undefined;
-        max_width?: SizeValue | undefined;
-        padding_x?: SizeValue | undefined;
-        padding_y?: SizeValue | undefined;
+        max_width?: StyleSizeValue | undefined;
+        padding_x?: StyleSizeValue | undefined;
+        padding_y?: StyleSizeValue | undefined;
     }, {
         background?: string | undefined;
-        max_width?: SizeValue | undefined;
-        padding_x?: SizeValue | undefined;
-        padding_y?: SizeValue | undefined;
+        max_width?: StyleSizeValue | undefined;
+        padding_x?: StyleSizeValue | undefined;
+        padding_y?: StyleSizeValue | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     version: 1;
@@ -1980,9 +2057,9 @@ declare const PageLayoutSchema: z.ZodObject<{
     } | undefined;
     style?: {
         background?: string | undefined;
-        max_width?: SizeValue | undefined;
-        padding_x?: SizeValue | undefined;
-        padding_y?: SizeValue | undefined;
+        max_width?: StyleSizeValue | undefined;
+        padding_x?: StyleSizeValue | undefined;
+        padding_y?: StyleSizeValue | undefined;
     } | undefined;
 }, {
     version: 1;
@@ -1994,9 +2071,9 @@ declare const PageLayoutSchema: z.ZodObject<{
     } | undefined;
     style?: {
         background?: string | undefined;
-        max_width?: SizeValue | undefined;
-        padding_x?: SizeValue | undefined;
-        padding_y?: SizeValue | undefined;
+        max_width?: StyleSizeValue | undefined;
+        padding_x?: StyleSizeValue | undefined;
+        padding_y?: StyleSizeValue | undefined;
     } | undefined;
 }>;
 
@@ -4152,20 +4229,20 @@ declare const PageSchema: z.ZodObject<{
             is_sticky?: boolean | undefined;
         }>>;
         style: z.ZodOptional<z.ZodObject<{
-            background: z.ZodOptional<z.ZodString>;
-            max_width: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
-            padding_x: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
-            padding_y: z.ZodOptional<z.ZodType<SizeValue, z.ZodTypeDef, SizeValue>>;
+            background: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            max_width: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
+            padding_x: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
+            padding_y: z.ZodOptional<z.ZodType<StyleSizeValue, z.ZodTypeDef, StyleSizeValue>>;
         }, "strip", z.ZodTypeAny, {
             background?: string | undefined;
-            max_width?: SizeValue | undefined;
-            padding_x?: SizeValue | undefined;
-            padding_y?: SizeValue | undefined;
+            max_width?: StyleSizeValue | undefined;
+            padding_x?: StyleSizeValue | undefined;
+            padding_y?: StyleSizeValue | undefined;
         }, {
             background?: string | undefined;
-            max_width?: SizeValue | undefined;
-            padding_x?: SizeValue | undefined;
-            padding_y?: SizeValue | undefined;
+            max_width?: StyleSizeValue | undefined;
+            padding_x?: StyleSizeValue | undefined;
+            padding_y?: StyleSizeValue | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         version: 1;
@@ -4177,9 +4254,9 @@ declare const PageSchema: z.ZodObject<{
         } | undefined;
         style?: {
             background?: string | undefined;
-            max_width?: SizeValue | undefined;
-            padding_x?: SizeValue | undefined;
-            padding_y?: SizeValue | undefined;
+            max_width?: StyleSizeValue | undefined;
+            padding_x?: StyleSizeValue | undefined;
+            padding_y?: StyleSizeValue | undefined;
         } | undefined;
     }, {
         version: 1;
@@ -4191,9 +4268,9 @@ declare const PageSchema: z.ZodObject<{
         } | undefined;
         style?: {
             background?: string | undefined;
-            max_width?: SizeValue | undefined;
-            padding_x?: SizeValue | undefined;
-            padding_y?: SizeValue | undefined;
+            max_width?: StyleSizeValue | undefined;
+            padding_x?: StyleSizeValue | undefined;
+            padding_y?: StyleSizeValue | undefined;
         } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
@@ -4232,9 +4309,9 @@ declare const PageSchema: z.ZodObject<{
         } | undefined;
         style?: {
             background?: string | undefined;
-            max_width?: SizeValue | undefined;
-            padding_x?: SizeValue | undefined;
-            padding_y?: SizeValue | undefined;
+            max_width?: StyleSizeValue | undefined;
+            padding_x?: StyleSizeValue | undefined;
+            padding_y?: StyleSizeValue | undefined;
         } | undefined;
     };
     entity_slug?: string | undefined;
@@ -4274,9 +4351,9 @@ declare const PageSchema: z.ZodObject<{
         } | undefined;
         style?: {
             background?: string | undefined;
-            max_width?: SizeValue | undefined;
-            padding_x?: SizeValue | undefined;
-            padding_y?: SizeValue | undefined;
+            max_width?: StyleSizeValue | undefined;
+            padding_x?: StyleSizeValue | undefined;
+            padding_y?: StyleSizeValue | undefined;
         } | undefined;
     };
     entity_slug?: string | undefined;
@@ -5757,6 +5834,18 @@ interface DesignReferenceContent {
  * hook. An object rather than a bare string because a bare string IS a valid
  * user value (clients send bare ids). Mirrors `metamodel.CurrentUserDefault`.
  */
+/**
+ * The signed-in user as a VALUE: a `FilterElement.value` (any field —
+ * data-service and the page renderer substitute the caller's id), a component
+ * prop, a `calendar` element's `user_id` / `overlay_user_ids`, a string
+ * literal in the records SQL dialect. The `$` prefix keeps it apart from every
+ * id, slug or text, so no slot has to know the attribute type. The Liquid
+ * scope exposes the same person as the object `{{ current_user.id }}`.
+ * Mirrors `common.CurrentUser`.
+ */
+declare const CURRENT_USER = "$current_user";
+/** True when a string slot carries the current-user sentinel. */
+declare function isCurrentUser(value: unknown): value is typeof CURRENT_USER;
 declare const CURRENT_USER_DEFAULT: {
     readonly type: "current_user";
 };
@@ -5768,4 +5857,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 { CurrencyAttributeMetaSchema as $, type AuditFields as A, type ComponentService as B, CURRENT_USER_DEFAULT as C, type ContactAddressAttributeKind as D, type ContactAddressAttributeMeta as E, type FileRef as F, ContactAddressAttributeMetaSchema as G, type ContactBindingDuplicatePolicy as H, type CreateAppConfigurationRequest as I, type CreateAppRequest as J, type CreateComponentRequest as K, type ListOptions as L, type CreateDesignReferenceRequest as M, type CreateEntityExtensionRequest as N, type CreateEntityRequest as O, PageIterator as P, type CreateListExtensionRequest as Q, type ResponseMeta as R, type CreateListRequest as S, type CreateListViewRequest as T, type UserRef as U, type CreateMenuConfigurationExtensionRequest as V, type CreateMenuConfigurationRequest as W, type CreatePageExtensionRequest as X, type CreatePageRequest as Y, type CreateVariableRequest as Z, type CurrencyAttributeMeta as _, type Attribute as a, type MenuConfigurationExtensionPlacement as a$, type CurrencySymbolSide as a0, type CurrencyValue as a1, type CurrentUserDefault as a2, DEFAULT_OPTIONS as a3, DEFAULT_PAGE_SIZE as a4, DONE as a5, type DeployModuleRequest as a6, type DesignReference as a7, type DesignReferenceContent as a8, DesignReferenceSchema as a9, type ListDesignReferencesOptions as aA, type ListEntitiesOptions as aB, type ListEntityExtensionsOptions as aC, type ListExtension as aD, type ListExtensionColumnPlacement as aE, ListExtensionColumnPlacementSchema as aF, ListExtensionSchema as aG, type ListExtensionService as aH, type ListFn as aI, type ListListExtensionsOptions as aJ, type ListListViewsOptions as aK, type ListListsOptions as aL, type ListMenuConfigurationExtensionsOptions as aM, type ListMenuConfigurationsOptions as aN, type ListModulesOptions as aO, type ListPageExtensionsOptions as aP, type ListPagesOptions as aQ, ListSchema as aR, type ListService as aS, type ListVariablesOptions as aT, type ListView as aU, ListViewSchema as aV, type ListViewService as aW, type LogicalOperator as aX, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aY, type MenuConfiguration as aZ, type MenuConfigurationExtension as a_, type DesignReferenceService as aa, type Done as ab, type Entity as ac, type EntityContactBinding as ad, EntityContactBindingSchema as ae, type EntityExtension as af, EntityExtensionSchema as ag, type EntityExtensionService as ah, EntitySchema as ai, type EntityService as aj, type EntityWithSchema as ak, EntityWithSchemaSchema as al, type EnumAttributeMeta as am, type EnumValue as an, type ExtensionPosition as ao, ExtensionPositionSchema as ap, type FileAttributeMeta as aq, FileRefSchema as ar, type FilterElement as as, FilterElementSchema as at, type FilterGroup as au, FilterGroupSchema as av, type List as aw, type ListAppConfigurationsOptions as ax, type ListAppsOptions as ay, type ListComponentsOptions as az, type ListResult as b, type UserType as b$, MenuConfigurationExtensionPlacementSchema as b0, type MenuConfigurationExtensionPosition as b1, MenuConfigurationExtensionPositionSchema as b2, MenuConfigurationExtensionSchema as b3, type MenuConfigurationExtensionService as b4, MenuConfigurationSchema as b5, type MenuConfigurationService as b6, type MenuItem as b7, MenuItemSchema as b8, MenuItemType as b9, type PublicPageComponent as bA, type PublicPageResponse as bB, type RelationAttributeMeta as bC, RelationAttributeMetaSchema as bD, type RequestOptions as bE, type ResolvedClientOptions as bF, ResponseMetaSchema as bG, type SortConfig as bH, SortConfigSchema as bI, type SortDirection as bJ, type Timestamps as bK, type TokenProvider as bL, type UpdateAppConfigurationRequest as bM, type UpdateAppRequest as bN, type UpdateComponentRequest as bO, type UpdateDesignReferenceRequest as bP, type UpdateEntityExtensionRequest as bQ, type UpdateEntityRequest as bR, type UpdateListExtensionRequest as bS, type UpdateListRequest as bT, type UpdateListViewRequest as bU, type UpdateMenuConfigurationExtensionRequest as bV, type UpdateMenuConfigurationRequest as bW, type UpdatePageExtensionRequest as bX, type UpdatePageRequest as bY, type UpdateVariableRequest as bZ, UserRefSchema as b_, MetaClient as ba, type MetaListOptions as bb, type Module as bc, ModuleSchema as bd, type ModuleService as be, type ModuleStatus as bf, type OnDeleteAction as bg, OnDeleteActionSchema as bh, PAGE_EXTENSION_ANCHOR_MAIN as bi, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bj, PLATFORM_ATTRIBUTE_NAMES as bk, PLATFORM_USER_ID as bl, type Page as bm, type PageAction as bn, type PageActionKind as bo, PageActionSchema as bp, type PageExtension as bq, type PageExtensionPlacement as br, PageExtensionPlacementSchema as bs, PageExtensionSchema as bt, type PageExtensionService as bu, type PageLayout as bv, PageLayoutSchema as bw, PageSchema as bx, type PageService as by, type PageType as bz, ProteosClient as c, type SizeValue as c$, type Variable as c0, VariableSchema as c1, type VariableService as c2, acceptsCurrentUserDefault as c3, allCurrencyCodes as c4, createIterator as c5, createListResultSchema as c6, currencyLabel as c7, currencySymbol as c8, currencySymbolSide as c9, type LayoutAlign as cA, type LayoutElement as cB, LayoutElementSchema as cC, LayoutElementType as cD, type LayoutGap as cE, type LayoutJustify as cF, type LayoutTab as cG, LayoutTabSchema as cH, type ListElement as cI, type NumberAttributeMeta as cJ, type ObjectAttributeMeta as cK, PAGE_BACKGROUND_TOKENS as cL, type PageBackgroundToken as cM, type PageLayoutSidePanel as cN, PageLayoutSidePanelSchema as cO, type PageStyle as cP, PageStyleSchema as cQ, type PrincipalAttributeMeta as cR, type PrincipalType as cS, RECORD_TITLE_FIELD as cT, type RecordFilterElement as cU, type RelatedListElement as cV, type RelatedRecordElement as cW, type ResponsiveSizing as cX, type RowElement as cY, type SchedulingPickerElement as cZ, type SectionElement as c_, formatAmount as ca, formatMoney as cb, isCurrentUserDefault as cc, isPlatformAttributeName as cd, localeNumberSeparators as ce, parseAmount as cf, parseContactAddressMeta as cg, parseCurrencyMeta as ch, parseFileMeta as ci, parseRelationMeta as cj, platformAttributes as ck, resolveOptions as cl, type AttributeForLookup as cm, type AttributeMeta as cn, BUILT_IN_CONTROLS as co, type BuiltInControlSlug as cp, type CardElement as cq, type ColumnElement as cr, type CommonProps as cs, type ComponentElement as ct, type ControlBucket as cu, type DatetimeAttributeMeta as cv, type DatetimeFormat as cw, type DividerElement as cx, type FieldElement as cy, FileAttributeMetaSchema as cz, type PrincipalRef as d, SizeValueSchema as d0, type SizingProps as d1, type StringAttributeMeta as d2, type StringFormat as d3, type TabsElement as d4, type TextElement as d5, type TextVariant as d6, type UserAttributeMeta as d7, UserAttributeMetaSchema as d8, type WorkflowTriggerElement as d9, isBuiltInControl as da, isReservedAttributeName as db, isTitleQueryable as dc, lookupCompatibleControls as dd, lookupControls as de, lookupPrimaryControl as df, parsePrincipalMeta as dg, parseUserMeta as dh, titleTemplateVariables as di, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, type ClientOptions as u, type Column as v, ColumnSchema as w, type ComparisonOperator as x, type Component as y, ComponentSchema as z };
+export { type CurrencyAttributeMeta as $, type AuditFields as A, ComponentSchema as B, CURRENT_USER as C, type ComponentService as D, type ContactAddressAttributeKind as E, type FileRef as F, type ContactAddressAttributeMeta as G, ContactAddressAttributeMetaSchema as H, type ContactBindingDuplicatePolicy as I, type CreateAppConfigurationRequest as J, type CreateAppRequest as K, type ListOptions as L, type CreateComponentRequest as M, type CreateDesignReferenceRequest as N, type CreateEntityExtensionRequest as O, PageIterator as P, type CreateEntityRequest as Q, type ResponseMeta as R, type CreateListExtensionRequest as S, type CreateListRequest as T, type UserRef as U, type CreateListViewRequest as V, type CreateMenuConfigurationExtensionRequest as W, type CreateMenuConfigurationRequest as X, type CreatePageExtensionRequest as Y, type CreatePageRequest as Z, type CreateVariableRequest as _, type Attribute as a, type MenuConfigurationExtension as a$, CurrencyAttributeMetaSchema as a0, type CurrencySymbolSide as a1, type CurrencyValue as a2, type CurrentUserDefault as a3, DEFAULT_OPTIONS as a4, DEFAULT_PAGE_SIZE as a5, DONE as a6, type DeployModuleRequest as a7, type DesignReference as a8, type DesignReferenceContent as a9, type ListComponentsOptions as aA, type ListDesignReferencesOptions as aB, type ListEntitiesOptions as aC, type ListEntityExtensionsOptions as aD, type ListExtension as aE, type ListExtensionColumnPlacement as aF, ListExtensionColumnPlacementSchema as aG, ListExtensionSchema as aH, type ListExtensionService as aI, type ListFn as aJ, type ListListExtensionsOptions as aK, type ListListViewsOptions as aL, type ListListsOptions as aM, type ListMenuConfigurationExtensionsOptions as aN, type ListMenuConfigurationsOptions as aO, type ListModulesOptions as aP, type ListPageExtensionsOptions as aQ, type ListPagesOptions as aR, ListSchema as aS, type ListService as aT, type ListVariablesOptions as aU, type ListView as aV, ListViewSchema as aW, type ListViewService as aX, type LogicalOperator as aY, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS as aZ, type MenuConfiguration as a_, DesignReferenceSchema as aa, type DesignReferenceService as ab, type Done as ac, type Entity as ad, type EntityContactBinding as ae, EntityContactBindingSchema as af, type EntityExtension as ag, EntityExtensionSchema as ah, type EntityExtensionService as ai, EntitySchema as aj, type EntityService as ak, type EntityWithSchema as al, EntityWithSchemaSchema as am, type EnumAttributeMeta as an, type EnumValue as ao, type ExtensionPosition as ap, ExtensionPositionSchema as aq, type FileAttributeMeta as ar, FileRefSchema as as, type FilterElement as at, FilterElementSchema as au, type FilterGroup as av, FilterGroupSchema as aw, type List as ax, type ListAppConfigurationsOptions as ay, type ListAppsOptions as az, type ListResult as b, UserRefSchema as b$, type MenuConfigurationExtensionPlacement as b0, MenuConfigurationExtensionPlacementSchema as b1, type MenuConfigurationExtensionPosition as b2, MenuConfigurationExtensionPositionSchema as b3, MenuConfigurationExtensionSchema as b4, type MenuConfigurationExtensionService as b5, MenuConfigurationSchema as b6, type MenuConfigurationService as b7, type MenuItem as b8, MenuItemSchema as b9, type PageType as bA, type PublicPageComponent as bB, type PublicPageResponse as bC, type RelationAttributeMeta as bD, RelationAttributeMetaSchema as bE, type RequestOptions as bF, type ResolvedClientOptions as bG, ResponseMetaSchema as bH, type SortConfig as bI, SortConfigSchema as bJ, type SortDirection as bK, type Timestamps as bL, type TokenProvider as bM, type UpdateAppConfigurationRequest as bN, type UpdateAppRequest as bO, type UpdateComponentRequest as bP, type UpdateDesignReferenceRequest as bQ, type UpdateEntityExtensionRequest as bR, type UpdateEntityRequest as bS, type UpdateListExtensionRequest as bT, type UpdateListRequest as bU, type UpdateListViewRequest as bV, type UpdateMenuConfigurationExtensionRequest as bW, type UpdateMenuConfigurationRequest as bX, type UpdatePageExtensionRequest as bY, type UpdatePageRequest as bZ, type UpdateVariableRequest as b_, MenuItemType as ba, MetaClient as bb, type MetaListOptions as bc, type Module as bd, ModuleSchema as be, type ModuleService as bf, type ModuleStatus as bg, type OnDeleteAction as bh, OnDeleteActionSchema as bi, PAGE_EXTENSION_ANCHOR_MAIN as bj, PAGE_EXTENSION_ANCHOR_SIDE_PANEL as bk, PLATFORM_ATTRIBUTE_NAMES as bl, PLATFORM_USER_ID as bm, type Page as bn, type PageAction as bo, type PageActionKind as bp, PageActionSchema as bq, type PageExtension as br, type PageExtensionPlacement as bs, PageExtensionPlacementSchema as bt, PageExtensionSchema as bu, type PageExtensionService as bv, type PageLayout as bw, PageLayoutSchema as bx, PageSchema as by, type PageService as bz, ProteosClient as c, type PrincipalType as c$, type UserType as c0, type Variable as c1, VariableSchema as c2, type VariableService as c3, acceptsCurrentUserDefault as c4, allCurrencyCodes as c5, createIterator as c6, createListResultSchema as c7, currencyLabel as c8, currencySymbol as c9, type ControlBucket as cA, type DatetimeAttributeMeta as cB, type DatetimeFormat as cC, type DividerElement as cD, type FieldElement as cE, FileAttributeMetaSchema as cF, type LayoutAlign as cG, type LayoutElement as cH, LayoutElementSchema as cI, LayoutElementType as cJ, type LayoutGap as cK, type LayoutJustify as cL, type LayoutTab as cM, LayoutTabSchema as cN, type LengthValue as cO, LengthValueSchema as cP, type ListElement as cQ, type NumberAttributeMeta as cR, type ObjectAttributeMeta as cS, PAGE_BACKGROUND_COLOR_RE as cT, PAGE_BACKGROUND_TOKENS as cU, type PageBackgroundToken as cV, type PageLayoutSidePanel as cW, PageLayoutSidePanelSchema as cX, type PageStyle as cY, PageStyleSchema as cZ, type PrincipalAttributeMeta as c_, currencySymbolSide as ca, formatAmount as cb, formatMoney as cc, isCurrentUser as cd, isCurrentUserDefault as ce, isPlatformAttributeName as cf, localeNumberSeparators as cg, parseAmount as ch, parseContactAddressMeta as ci, parseCurrencyMeta as cj, parseFileMeta as ck, parseRelationMeta as cl, platformAttributes as cm, resolveOptions as cn, type AttributeForLookup as co, type AttributeMeta as cp, BUILT_IN_CONTROLS as cq, type BuiltInControlSlug as cr, CALENDAR_MAX_OVERLAY_USERS as cs, CALENDAR_VIEW_KINDS as ct, type CalendarElement as cu, type CalendarViewKind as cv, type CardElement as cw, type ColumnElement as cx, type CommonProps as cy, type ComponentElement as cz, type PrincipalRef as d, RECORD_TITLE_FIELD as d0, type RecordFilterElement as d1, type RelatedListElement as d2, type RelatedRecordElement as d3, type ResponsiveSizing as d4, type RowElement as d5, type SchedulingPickerElement as d6, type SectionElement as d7, type SizeValue as d8, SizeValueSchema as d9, type SizingProps as da, type StringAttributeMeta as db, type StringFormat as dc, type StyleSizeValue as dd, StyleSizeValueSchema as de, type TabsElement as df, type TextElement as dg, type TextVariant as dh, type UserAttributeMeta as di, UserAttributeMetaSchema as dj, type WorkflowTriggerElement as dk, isBuiltInControl as dl, isLengthValue as dm, isPageBackground as dn, isReservedAttributeName as dp, isStyleSizeValue as dq, isTitleQueryable as dr, lookupCompatibleControls as ds, lookupControls as dt, lookupPrimaryControl as du, parsePrincipalMeta as dv, parseUserMeta as dw, titleTemplateVariables as dx, type PublicAccessOperation as e, type App as f, type AppConfiguration as g, AppConfigurationSchema as h, type AppConfigurationService as i, type AppHome as j, AppHomeSchema as k, type AppHomeType as l, AppSchema as m, type AppService as n, type ArrayAttributeMeta as o, type AttributeAccessRule as p, type AttributeRestrictions as q, AttributeSchema as r, type AttributeType as s, AuditFieldsSchema as t, CURRENT_USER_DEFAULT as u, type ClientOptions as v, type Column as w, ColumnSchema as x, type ComparisonOperator as y, type Component as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.56.0",
+  "version": "0.57.1",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {
@@ -66,8 +66,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@proteos/tsconfig": "0.0.0",
-    "@proteos/biome-config": "0.0.0"
+    "@proteos/biome-config": "0.0.0",
+    "@proteos/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/index.ts

@@ -761,6 +761,7 @@ export {
   ColumnSchema,
   ComponentSchema,
   ContactAddressAttributeMetaSchema,
+  CURRENT_USER,
   CURRENT_USER_DEFAULT,
   CurrencyAttributeMetaSchema,
   currencyLabel,
@@ -776,6 +777,7 @@ export {
   FilterGroupSchema,
   formatAmount,
   formatMoney,
+  isCurrentUser,
   isCurrentUserDefault,
   isPlatformAttributeName,
   ListExtensionColumnPlacementSchema,
@@ -829,19 +831,19 @@ export type {
   CalendarConnectionStatus,
   CalendarEvent,
   CalendarEventService,
+  CalendarEventsResponse,
   CalendarEventType,
   CalendarEventTypeService,
-  CalendarEventsResponse,
   CalendarProvider,
   CalendarService,
   CalendarSync,
   CalendarSyncStatus,
   CalendarVisibility,
   CalendarWatch,
+  CancelPublicCalendarEventRequest,
   ConferencingProvider,
   CreateAvailabilityConstraintRequest,
   CreateCalendarConnectionRequest,
-  CancelPublicCalendarEventRequest,
   CreateCalendarEventRequest,
   CreateSchedulingLinkRequest,
   EventLocation,
@@ -856,13 +858,13 @@ export type {
   HostsRequest,
   ListAvailabilityConstraintsQuery,
   ListCalendarConnectionsQuery,
-  ListCalendarEventTypesQuery,
   ListCalendarEventsQuery,
+  ListCalendarEventTypesQuery,
   ListCalendarsQuery,
-  ListSchedulingLinksQuery,
-  LocationKind,
   // Aliased: the conversation module already exports its own ListResponse.
   ListResponse as SchedulingListResponse,
+  ListSchedulingLinksQuery,
+  LocationKind,
   NotifyMode,
   ParticipationStatus,
   PublicBookSchedulingLinkResponse,
@@ -876,8 +878,8 @@ export type {
   PutSchedulingProfileRequest,
   RecordRef,
   RecurrenceScope,
-  ReschedulePublicCalendarEventRequest,
   RescheduleHost,
+  ReschedulePublicCalendarEventRequest,
   RespondCalendarEventRequest,
   SchedulingLink,
   SchedulingLinkService,
@@ -888,12 +890,12 @@ export type {
   SlotService,
   SlotUnavailability,
   SlotUnavailabilityReason,
-  UpdateCalendarSyncRequest,
   UpdateAvailabilityConstraintRequest,
   UpdateCalendarConnectionRequest,
   UpdateCalendarEventRequest,
   UpdateCalendarEventTypeRequest,
   UpdateCalendarRequest,
+  UpdateCalendarSyncRequest,
   UpdateSchedulingLinkRequest,
 } from './scheduling/index.js'
 // Scheduling client (scheduling-service)

package/src/meta/index.ts

@@ -316,6 +316,7 @@ export {
   ColumnSchema,
   ComponentSchema,
   ContactAddressAttributeMetaSchema,
+  CURRENT_USER,
   CURRENT_USER_DEFAULT,
   CurrencyAttributeMetaSchema,
   DesignReferenceSchema,
@@ -327,6 +328,7 @@ export {
   FileAttributeMetaSchema,
   FilterElementSchema,
   FilterGroupSchema,
+  isCurrentUser,
   isCurrentUserDefault,
   isPlatformAttributeName,
   ListExtensionColumnPlacementSchema,

package/src/meta/layout/common-props.ts

@@ -1,6 +1,11 @@
 import { z } from 'zod'
 import { type FilterGroup, FilterGroupSchema } from '../filters.js'
-import { type SizeValue, SizeValueSchema } from './size-value.js'
+import {
+  type LengthValue,
+  LengthValueSchema,
+  type SizeValue,
+  SizeValueSchema,
+} from './size-value.js'
 
 /**
  * Cross-axis alignment values. On Row / Column the same string also drives
@@ -23,6 +28,9 @@ const GapSchema = z.enum(['xs', 'sm', 'md', 'lg'])
 export interface SizingProps {
   width?: SizeValue
   height?: SizeValue
+  /** Floor under `height` (px or %). Under `height: 'fill'` in a column it
+   *  replaces the default 320px floor. */
+  min_height?: LengthValue
   grow?: number
   shrink?: number
   align?: LayoutAlign
@@ -31,6 +39,7 @@ export interface SizingProps {
 const SizingPropsSchema = z.object({
   width: SizeValueSchema.optional(),
   height: SizeValueSchema.optional(),
+  min_height: LengthValueSchema.optional(),
   grow: z.number().optional(),
   shrink: z.number().optional(),
   align: AlignSchema.optional(),
@@ -72,7 +81,12 @@ export interface CommonProps {
   visible_when?: FilterGroup
   read_only_when?: FilterGroup
   width?: SizeValue
+  /** `fill` takes the remaining space in the parent: along a column it grows
+   *  (floored by `min_height`, default 320px); in a row it stretches to the
+   *  row's height. */
   height?: SizeValue
+  /** Floor under `height`, px or %. */
+  min_height?: LengthValue
   grow?: number
   shrink?: number
   align?: LayoutAlign
@@ -90,6 +104,7 @@ export const commonPropsShape = {
   read_only_when: FilterGroupSchema.optional(),
   width: SizeValueSchema.optional(),
   height: SizeValueSchema.optional(),
+  min_height: LengthValueSchema.optional(),
   grow: z.number().optional(),
   shrink: z.number().optional(),
   align: AlignSchema.optional(),

package/src/meta/layout/elements.ts

@@ -24,6 +24,7 @@ export const LayoutElementType = {
   List: 'list',
   WorkflowTrigger: 'workflow_trigger',
   SchedulingPicker: 'scheduling_picker',
+  Calendar: 'calendar',
 } as const
 export type LayoutElementType = (typeof LayoutElementType)[keyof typeof LayoutElementType]
 
@@ -276,6 +277,50 @@ export type SchedulingPickerElement = CommonProps & {
   is_header_hidden?: boolean
 }
 
+/** The grid views a `calendar` element can show; mirrors `metamodel.CalendarViewKinds`. */
+export const CALENDAR_VIEW_KINDS = ['day', 'week', 'month', 'agenda'] as const
+export type CalendarViewKind = (typeof CALENDAR_VIEW_KINDS)[number]
+
+/**
+ * Cap on `overlay_user_ids` (one team colour per overlaid user); mirrors
+ * `metamodel.CalendarMaxOverlayUsers`.
+ */
+export const CALENDAR_MAX_OVERLAY_USERS = 8
+
+/**
+ * A user's calendar embedded in a page: the in-page counterpart of
+ * `/org/:orgId/calendar`. `user_id` is `$current_user`, a Liquid template over
+ * the page scope (`{{ record.owner.id }}`) or a literal user id; writes (new
+ * event, drag, edit) are offered only when it resolves to the viewer — unless
+ * `is_hosted_create_allowed` opens creation through the displayed user.
+ */
+export type CalendarElement = CommonProps & {
+  type: 'calendar'
+  user_id: string
+  /** Initial view; `day` when absent. */
+  default_view?: CalendarViewKind
+  /** Views the switcher offers; only `default_view` when absent. Must contain it. */
+  views?: CalendarViewKind[]
+  /** Liquid template for the initial anchor day (day key or datetime); today when absent. */
+  date?: string
+  /**
+   * Record pages only: show only events linked to the page record
+   * (`record_entity_slug` + `record_id`) instead of the user's whole calendar.
+   */
+  is_record_scoped?: boolean
+  /**
+   * Up to `CALENDAR_MAX_OVERLAY_USERS` further users drawn on the same grid in
+   * team colours, read-only. Each resolves like `user_id`.
+   */
+  overlay_user_ids?: string[]
+  /**
+   * When the calendar shows someone else: "New event" and drag-select create
+   * THROUGH that user (the viewer hosts the request, the event lands on the
+   * displayed user's calendar). Edit and move stay owner-only.
+   */
+  is_hosted_create_allowed?: boolean
+}
+
 export type TextVariant = 'heading' | 'subheading' | 'body' | 'caption' | 'callout' | 'block-title'
 
 export type TextElement = CommonProps & {
@@ -300,6 +345,7 @@ export type LayoutElement =
   | ListElement
   | WorkflowTriggerElement
   | SchedulingPickerElement
+  | CalendarElement
 
 // ──────────────────────────────────────────────────────────── Schemas ──
 
@@ -439,5 +485,16 @@ export const LayoutElementSchema: z.ZodType<LayoutElement> = z.lazy(() =>
       contact_id: z.string().optional(),
       is_header_hidden: z.boolean().optional(),
     }),
+    z.object({
+      type: z.literal('calendar'),
+      ...commonPropsShape,
+      user_id: z.string().min(1),
+      default_view: z.enum(CALENDAR_VIEW_KINDS).optional(),
+      views: z.array(z.enum(CALENDAR_VIEW_KINDS)).min(1).optional(),
+      date: z.string().optional(),
+      is_record_scoped: z.boolean().optional(),
+      overlay_user_ids: z.array(z.string().min(1)).max(CALENDAR_MAX_OVERLAY_USERS).optional(),
+      is_hosted_create_allowed: z.boolean().optional(),
+    }),
   ]),
 ) as unknown as z.ZodType<LayoutElement>