@stndrds/schema 0.1.0-alpha.18 → 0.1.0-alpha.20

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { A as Attribute, S as StatusAttribute, a as SelectAttribute, M as MultiselectAttribute, P as Phone, C as Currency, L as Location, b as SystemResource, c as SystemAction, O as ObjectAction, T as TextAttribute, d as TextAreaAttribute, N as NumberAttribute, e as CheckboxAttribute, D as DateAttribute, f as PhoneAttribute, g as CurrencyAttribute, h as Option, i as LocationAttribute, j as TimestampAttribute, F as FileAttribute, U as UserAttribute, k as SingleRelationAttribute, l as MultiRelationAttribute, R as RelationTarget, m as RatingAttribute, n as FlowDefinition, o as FlowPage, p as FlowRow, q as ObjectDefinition, r as Field, s as AttributeGroupField, G as Group, V as ViewDefinition, t as Tab } from './runtime-Dw2exb5q.mjs';
-export { b7 as ActivityTab, cw as AddAttributeInput, an as AdvancedFilterState, aZ as AssignRoleInput, c5 as AttributeChange, w as AttributeGroup, u as AttributeType, ce as AttributesRepository, X as AuditAction, Y as AuditActorType, Z as AuditChange, a0 as AuditListOptions, _ as AuditLogEntry, ck as AuditRepository, W as AuditResourceType, cn as AuditService, a1 as AuditServiceOptions, B as BaseAttribute, a9 as CheckboxFilterOperator, aN as CompletionStatus, $ as CreateAuditLogInput, cv as CreateCustomObjectInput, de as CreateDBAttribute, dt as CreateDBFlow, da as CreateDBObject, dp as CreateDBView, a5 as CreateFile, cq as CreateFlowInput, dh as CreateObjectRecord, aY as CreatePermissionInput, aW as CreateRoleInput, b1 as CreateUserProfile, cP as CreateViewInput, ag as CurrencyFilterValue, b6 as CustomTab, dd as DBAttribute, ds as DBFlow, d9 as DBObject, dn as DBView, d4 as DEFAULT_LABEL_FALLBACK, c4 as DatabaseAdapter, aa as DateFilterOperator, y as DateFormat, z as DateValue, I as DocumentFace, H as DocumentType, J as DocumentTypeConfig, aT as EffectivePermissions, a4 as File, cS as FileContent, dm as FileListOptions, cp as FileService, co as FileServiceOptions, K as FileVerificationConfig, a3 as FileVisibility, cg as FilesRepository, ak as FilterCombinator, am as FilterGroup, ae as FilterOperator, aj as FilterRule, al as FilterState, ai as FilterValue, aA as FlowRelation, az as FlowRowField, cs as FlowService, ay as FlowSlot, aB as FlowStatus, cj as FlowsRepository, b4 as FormTab, d2 as FullSyncOptions, d1 as FullSyncResult, aJ as GeocodingAdapter, aG as GeocodingAutocompleteParams, aI as GeocodingParams, ct as GeocodingService, aF as GeocodingSuggestion, cI as GetRelationOptionsParams, dk as GlobalSearchOptions, dl as GlobalSearchResultItem, cu as GlobalSearchService, c6 as HookContext, c7 as HookDefinition, c8 as HookHandler, cb as HookRegistry, c9 as HookType, di as ListOptions, E as LocationGranularity, ac as MultiselectFilterOperator, aw as NO_VALUE_OPERATORS, av as NoValueOperator, aK as NoopGeocodingAdapter, ca as NoopHookRegistry, a8 as NumberFilterOperator, x as NumberUnit, au as OPERATORS_BY_TYPE, aM as ObjectAttribute, aU as ObjectPermissions, aO as ObjectRecord, ch as ObjectRecordsRepository, cz as ObjectSchemaService, cy as ObjectSchemaServiceOptions, cd as ObjectsRepository, dv as OperationResult, aR as Permission, aP as PermissionScope, cB as PermissionService, cA as PermissionServiceOptions, cl as PermissionsRepository, ah as PhoneFilterValue, at as QueryState, cD as RecordService, cC as RecordServiceOptions, Q as RelationAttribute, ad as RelationFilterOperator, cG as RelationOption, cH as RelationOptionsResponse, cJ as RelationService, cF as RelationValidationError, cE as RelationValidationResult, af as RelativeDateValue, aH as ReverseGeocodingParams, aQ as Role, dj as SearchOptions, ab as SelectFilterOperator, cV as SignedUrlOptions, ar as SortDirection, as as SortRule, v as StatusGroup, cW as StorageAdapter, a2 as StorageProvider, cT as StorageUploadInput, cU as StorageUploadResult, cZ as SyncOptions, cY as SyncResult, aV as SystemPermissions, b3 as TabType, b5 as TableTab, bd as TenantId, a7 as TextFilterOperator, aL as Timestamps, df as UpdateDBAttribute, du as UpdateDBFlow, db as UpdateDBObject, dq as UpdateDBView, a6 as UpdateFile, cr as UpdateFlowInput, cx as UpdateObjectInput, aX as UpdateRoleInput, b2 as UpdateUserProfile, cQ as UpdateViewInput, cX as UploadFileInput, dg as UpsertDBAttribute, dc as UpsertDBObject, dr as UpsertDBView, b0 as UserProfile, cL as UserProfileService, cK as UserProfileServiceOptions, cf as UserProfilesRepository, a_ as UserRole, aS as UserRoleAssignment, cO as UserService, a$ as UserStatus, cN as UserValidationError, cM as UserValidationResult, bc as Uuid, bW as ValidationResult, cR as ViewService, dx as ViewSyncOptions, dw as ViewSyncResult, ci as ViewsRepository, by as attributeConfigSchemas, cm as buildAuditChanges, bl as checkboxConfigSchema, c3 as computeRecordStatus, bU as createAttributeValidator, bF as createCheckboxValidator, bI as createCurrencyValidator, bG as createDateValidator, b_ as createDraftValidator, bO as createFileValidator, bM as createLocationValidator, cc as createMockAdapter, bR as createMultiRelationValidator, bL as createMultiselectValidator, bE as createNumberValidator, bV as createObjectValidator, bH as createPhoneValidator, bT as createRatingValidator, bS as createRelationValidator, bK as createSelectValidator, bQ as createSingleRelationValidator, bJ as createStatusValidator, bD as createTextValidator, bN as createTimestampValidator, bP as createUserValidator, bo as currencyConfigSchema, bm as dateConfigSchema, d8 as enrichValuesWithSelectLabels, d7 as extractAttributeNames, bu as fileConfigSchema, be as generateId, bf as generatePrefixedId, bz as getAttributeConfigSchema, c1 as getMissingRequiredAttributes, d0 as getSyncPreview, dA as getViewSyncPreview, bb as isActivityTab, ao as isAdvancedFilterState, ba as isCustomTab, aC as isFlowDefinition, aD as isFlowPublished, b8 as isFormTab, d6 as isLabelExpression, ax as isNoValueOperator, c2 as isRecordComplete, aE as isSystemFlow, b9 as isTableTab, bq as locationConfigSchema, bt as multiselectConfigSchema, bk as numberConfigSchema, bB as parseAttributeConfig, bn as phoneConfigSchema, bx as ratingConfigSchema, bg as registry, bw as relationConfigSchema, d5 as renderLabelExpression, bC as safeParseAttributeConfig, bs as selectConfigSchema, bp as statusConfigSchema, d3 as syncAll, c_ as syncNativeObjects, dy as syncNativeViews, bi as textConfigSchema, bj as textareaConfigSchema, br as timestampConfigSchema, ap as toAdvancedFilterState, aq as toSimpleFilterState, bv as userConfigSchema, bX as validateAttribute, bA as validateAttributeConfig, b$ as validateDraft, c0 as validateDraftOrThrow, bY as validateObject, bZ as validateObjectOrThrow, c$ as verifyNativeObjectsSync, dz as verifyNativeViewsSync, bh as viewRegistry } from './runtime-Dw2exb5q.mjs';
+import { A as Attribute, S as StatusAttribute, a as SelectAttribute, M as MultiselectAttribute, P as Phone, C as Currency, L as Location, F as FormulaAttribute, R as RollupAttribute, b as SystemResource, c as SystemAction, O as ObjectAction, T as TextAttribute, d as TextAreaAttribute, N as NumberAttribute, e as CheckboxAttribute, D as DateAttribute, f as PhoneAttribute, g as CurrencyAttribute, h as Option, i as LocationAttribute, j as TimestampAttribute, k as FileAttribute, U as UserAttribute, l as SingleRelationAttribute, m as MultiRelationAttribute, n as RelationTarget, o as RatingAttribute, p as FormulaReturnType, q as RollupFunction, r as FlowDefinition, s as FlowPage, t as FlowRow, u as ObjectDefinition, v as Field, w as AttributeGroupField, G as Group, V as ViewDefinition, x as Tab } from './runtime-BpsaNQPs.mjs';
+export { bb as ActivityTab, d6 as AddAttributeInput, ar as AdvancedFilterState, b1 as AssignRoleInput, cH as AttributeChange, B as AttributeGroup, y as AttributeType, cQ as AttributesRepository, $ as AuditAction, a0 as AuditActorType, a1 as AuditChange, a4 as AuditListOptions, a2 as AuditLogEntry, cW as AuditRepository, _ as AuditResourceType, cZ as AuditService, a5 as AuditServiceOptions, E as BaseAttribute, ad as CheckboxFilterOperator, aR as CompletionStatus, a3 as CreateAuditLogInput, d5 as CreateCustomObjectInput, dX as CreateDBAttribute, e9 as CreateDBFlow, dT as CreateDBObject, e5 as CreateDBView, a9 as CreateFile, d0 as CreateFlowInput, d_ as CreateObjectRecord, b0 as CreatePermissionInput, a_ as CreateRoleInput, b5 as CreateUserProfile, dw as CreateViewInput, ak as CurrencyFilterValue, ba as CustomTab, dW as DBAttribute, e8 as DBFlow, dS as DBObject, e4 as DBView, dN as DEFAULT_LABEL_FALLBACK, cc as DatabaseAdapter, ae as DateFilterOperator, I as DateFormat, J as DateValue, W as DocumentFace, Q as DocumentType, X as DocumentTypeConfig, aX as EffectivePermissions, a8 as File, dz as FileContent, e3 as FileListOptions, c$ as FileService, c_ as FileServiceOptions, Y as FileVerificationConfig, a7 as FileVisibility, cS as FilesRepository, ao as FilterCombinator, aq as FilterGroup, ai as FilterOperator, an as FilterRule, ap as FilterState, am as FilterValue, aE as FlowRelation, aD as FlowRowField, d2 as FlowService, aC as FlowSlot, aF as FlowStatus, cV as FlowsRepository, b8 as FormTab, cp as FormulaResult, dL as FullSyncOptions, dK as FullSyncResult, aN as GeocodingAdapter, aK as GeocodingAutocompleteParams, aM as GeocodingParams, d3 as GeocodingService, aJ as GeocodingSuggestion, di as GetRelationOptionsParams, e1 as GlobalSearchOptions, e2 as GlobalSearchResultItem, d4 as GlobalSearchService, cI as HookContext, cJ as HookDefinition, cK as HookHandler, cN as HookRegistry, cL as HookType, ct as InvalidPathError, d$ as ListOptions, K as LocationGranularity, cu as MaxDepthExceededError, ag as MultiselectFilterOperator, aA as NO_VALUE_OPERATORS, az as NoValueOperator, aO as NoopGeocodingAdapter, cM as NoopHookRegistry, ac as NumberFilterOperator, H as NumberUnit, ay as OPERATORS_BY_TYPE, aQ as ObjectAttribute, aY as ObjectPermissions, aS as ObjectRecord, cT as ObjectRecordsRepository, d9 as ObjectSchemaService, d8 as ObjectSchemaServiceOptions, cP as ObjectsRepository, eb as OperationResult, cy as PathCardinality, cz as PathSegment, cA as PathSegmentType, aV as Permission, aT as PermissionScope, db as PermissionService, da as PermissionServiceOptions, cX as PermissionsRepository, al as PhoneFilterValue, ax as QueryState, dd as RecordService, dc as RecordServiceOptions, Z as RelationAttribute, ah as RelationFilterOperator, dg as RelationOption, dh as RelationOptionsResponse, dl as RelationResolverService, dj as RelationService, df as RelationValidationError, de as RelationValidationResult, aj as RelativeDateValue, dk as ResolvedRelations, aL as ReverseGeocodingParams, aU as Role, dm as RollupResult, dq as RollupScheduler, dp as RollupSchedulerOptions, dn as RollupService, cB as SchemaResolver, e0 as SearchOptions, af as SelectFilterOperator, dC as SignedUrlOptions, av as SortDirection, aw as SortRule, z as StatusGroup, dD as StorageAdapter, a6 as StorageProvider, dA as StorageUploadInput, dB as StorageUploadResult, dG as SyncOptions, dF as SyncResult, aZ as SystemPermissions, b7 as TabType, b9 as TableTab, bh as TenantId, ab as TextFilterOperator, aP as Timestamps, cF as TraversalOptions, cG as TraversalResult, dY as UpdateDBAttribute, ea as UpdateDBFlow, dU as UpdateDBObject, e6 as UpdateDBView, aa as UpdateFile, d1 as UpdateFlowInput, d7 as UpdateObjectInput, a$ as UpdateRoleInput, b6 as UpdateUserProfile, dx as UpdateViewInput, dE as UploadFileInput, dZ as UpsertDBAttribute, dV as UpsertDBObject, e7 as UpsertDBView, b4 as UserProfile, ds as UserProfileService, dr as UserProfileServiceOptions, cR as UserProfilesRepository, b2 as UserRole, aW as UserRoleAssignment, dv as UserService, b3 as UserStatus, du as UserValidationError, dt as UserValidationResult, bg as Uuid, c2 as ValidationResult, dy as ViewService, ed as ViewSyncOptions, ec as ViewSyncResult, cU as ViewsRepository, bE as attributeConfigSchemas, cY as buildAuditChanges, bp as checkboxConfigSchema, cb as computeRecordStatus, c0 as createAttributeValidator, bL as createCheckboxValidator, bO as createCurrencyValidator, bM as createDateValidator, c6 as createDraftValidator, bU as createFileValidator, b_ as createFormulaValidator, bS as createLocationValidator, cO as createMockAdapter, bX as createMultiRelationValidator, bR as createMultiselectValidator, bK as createNumberValidator, c1 as createObjectValidator, bN as createPhoneValidator, bZ as createRatingValidator, bY as createRelationValidator, b$ as createRollupValidator, bQ as createSelectValidator, bW as createSingleRelationValidator, bP as createStatusValidator, bJ as createTextValidator, bT as createTimestampValidator, bV as createUserValidator, bs as currencyConfigSchema, bq as dateConfigSchema, dR as enrichValuesWithSelectLabels, cd as evaluateFormula, ce as evaluateFormulaAttribute, cf as evaluateFormulaAttributeWithRelations, cg as evaluateFormulaWithRelations, ch as evaluateFormulaWithResult, dQ as extractAttributeNames, ci as extractFormulaVariables, cj as extractRelationNames, ck as extractRelationReferences, by as fileConfigSchema, cl as flattenRelationsForEval, cm as formatFormulaResult, bC as formulaConfigSchema, bi as generateId, bj as generatePrefixedId, bF as getAttributeConfigSchema, c9 as getMissingRequiredAttributes, cq as getPathDepth, cr as getRelationPath, dJ as getSyncPreview, cs as getTargetAttributeName, eg as getViewSyncPreview, cn as hasRelationReferences, bf as isActivityTab, as as isAdvancedFilterState, be as isCustomTab, aG as isFlowDefinition, aH as isFlowPublished, bc as isFormTab, dP as isLabelExpression, aB as isNoValueOperator, ca as isRecordComplete, aI as isSystemFlow, bd as isTableTab, bu as locationConfigSchema, bx as multiselectConfigSchema, bo as numberConfigSchema, bH as parseAttributeConfig, cv as parsePath, cw as pathHasManyCardinality, br as phoneConfigSchema, bB as ratingConfigSchema, bk as registry, bA as relationConfigSchema, dO as renderLabelExpression, cC as resolveMultiplePaths, cD as resolveSingleValue, bD as rollupConfigSchema, bI as safeParseAttributeConfig, bw as selectConfigSchema, bt as statusConfigSchema, dM as syncAll, dH as syncNativeObjects, ee as syncNativeViews, bm as textConfigSchema, bn as textareaConfigSchema, bv as timestampConfigSchema, at as toAdvancedFilterState, au as toSimpleFilterState, cE as traversePath, bz as userConfigSchema, c3 as validateAttribute, bG as validateAttributeConfig, c7 as validateDraft, c8 as validateDraftOrThrow, co as validateFormulaExpression, c4 as validateObject, c5 as validateObjectOrThrow, cx as validatePath, dI as verifyNativeObjectsSync, ef as verifyNativeViewsSync, bl as viewRegistry } from './runtime-BpsaNQPs.mjs';
 import { IconName, CountryIso3, CurrencyCode, MimeType, ColorId } from '@stndrds/constants';
 import 'zod';
 
@@ -214,8 +214,9 @@ type InferRecordUpdate<TMap extends AttributeMap> = Partial<InferRecordFromSchem
 /**
  * Base type for custom attribute values added via UI
  * Supports all possible attribute value types
+ * Formula and Rollup attributes don't have defaultValue, so we exclude them
  */
-type CustomAttributeValue = Attribute["defaultValue"] | undefined;
+type CustomAttributeValue = Exclude<Attribute, FormulaAttribute | RollupAttribute>["defaultValue"] | undefined;
 /**
  * Adds support for custom attributes (added via UI) to a record type
  * Preserves autocompletion for known attributes while allowing additional properties
@@ -609,7 +610,7 @@ declare abstract class BaseAttributeBuilder<TAttr extends Attribute> {
     description(value: string): this;
     icon(value: IconName): this;
     order(value: number): this;
-    defaultValue(value: TAttr["defaultValue"]): this;
+    defaultValue(value: "defaultValue" extends keyof TAttr ? TAttr["defaultValue"] : never): this;
     metadata(value: Record<string, unknown>): this;
     build(): TAttr;
 }
@@ -946,10 +947,122 @@ declare class RatingAttributeBuilder<TName extends string, TRequired extends boo
     optional(): RatingAttributeBuilder<TName, false>;
 }
 declare function rating<TName extends string>(config: TypedBuilderConfig<TName>): RatingAttributeBuilder<TName, false>;
+/**
+ * Builder for formula attributes (computed values)
+ *
+ * Formula attributes are always read-only and cannot be required.
+ */
+declare class FormulaAttributeBuilder<TName extends string> extends BaseAttributeBuilder<FormulaAttribute> {
+    readonly _types: {
+        name: TName;
+        attribute: FormulaAttribute;
+        required: false;
+    };
+    constructor(name: TName, label: string);
+    /**
+     * Set the formula expression
+     * @param expr - Expression to evaluate (e.g., "price * quantity")
+     */
+    expression(expr: string): this;
+    /**
+     * Set the expected return type for formatting
+     * @param type - Return type: "text", "number", "boolean", or "date"
+     */
+    returns(type: FormulaReturnType): this;
+    /**
+     * Set decimal places for number results
+     */
+    decimals(value: number): this;
+    required(): any;
+    optional(): any;
+}
+/**
+ * Create a formula attribute builder
+ *
+ * @example Simple calculation
+ * ```typescript
+ * formula({ name: "total", label: "Total" })
+ *   .expression("price * quantity")
+ *   .returns("number")
+ *   .decimals(2)
+ * ```
+ *
+ * @example With functions
+ * ```typescript
+ * formula({ name: "fullName", label: "Full Name" })
+ *   .expression("CONCAT(firstName, ' ', lastName)")
+ *   .returns("text")
+ * ```
+ */
+declare function formula<TName extends string>(config: TypedBuilderConfig<TName>): FormulaAttributeBuilder<TName>;
+/**
+ * Builder for rollup attributes (aggregations from related records)
+ *
+ * Rollup attributes are always read-only and cannot be required.
+ */
+declare class RollupAttributeBuilder<TName extends string> extends BaseAttributeBuilder<RollupAttribute> {
+    readonly _types: {
+        name: TName;
+        attribute: RollupAttribute;
+        required: false;
+    };
+    constructor(name: TName, label: string);
+    /**
+     * Set the relation attribute to aggregate from
+     * @param relationName - Name of the relation attribute on this object
+     */
+    from(relationName: string): this;
+    /**
+     * Set the target attribute to aggregate
+     * @param attrName - Name of the attribute on the related object
+     */
+    aggregate(attrName: string): this;
+    /**
+     * Set the aggregation function
+     */
+    using(fn: RollupFunction): this;
+    /**
+     * Set decimal places for numeric results
+     */
+    decimals(value: number): this;
+    /**
+     * Display the rollup value using the target attribute's type formatter
+     * instead of the default rollup-specific formatting
+     */
+    showAsOriginal(): this;
+    /**
+     * Set multi-level path for traversing nested relations (Phase 4+)
+     * @param path - Dot notation path (e.g., "orders.items")
+     */
+    path(relationPath: string): this;
+    required(): any;
+    optional(): any;
+}
+/**
+ * Create a rollup attribute builder
+ *
+ * @example Sum of related amounts
+ * ```typescript
+ * rollup({ name: "totalOrders", label: "Total Orders" })
+ *   .from("orders")           // relation attribute name
+ *   .aggregate("amount")      // target attribute to sum
+ *   .using("sum")
+ *   .decimals(2)
+ * ```
+ *
+ * @example Count of related records
+ * ```typescript
+ * rollup({ name: "orderCount", label: "Number of Orders" })
+ *   .from("orders")
+ *   .aggregate("id")          // any attribute works for count
+ *   .using("count")
+ * ```
+ */
+declare function rollup<TName extends string>(config: TypedBuilderConfig<TName>): RollupAttributeBuilder<TName>;
 /**
  * Union of all attribute builder types
  */
-type AnyAttributeBuilder = TextAttributeBuilder<string, boolean> | TextAreaAttributeBuilder<string, boolean> | NumberAttributeBuilder<string, boolean> | CheckboxAttributeBuilder<string, boolean> | DateAttributeBuilder<string, boolean> | PhoneAttributeBuilder<string, boolean> | CurrencyAttributeBuilder<string, boolean> | StatusAttributeBuilder<string, readonly Option[], boolean> | SelectAttributeBuilder<string, readonly Option[], boolean> | MultiselectAttributeBuilder<string, readonly Option[], boolean> | LocationAttributeBuilder<string, boolean> | TimestampAttributeBuilder<string, boolean> | FileAttributeBuilder<string, boolean> | UserAttributeBuilder<string, boolean> | SingleRelationAttributeBuilder<string, boolean> | MultiRelationAttributeBuilder<string, boolean> | RatingAttributeBuilder<string, boolean>;
+type AnyAttributeBuilder = TextAttributeBuilder<string, boolean> | TextAreaAttributeBuilder<string, boolean> | NumberAttributeBuilder<string, boolean> | CheckboxAttributeBuilder<string, boolean> | DateAttributeBuilder<string, boolean> | PhoneAttributeBuilder<string, boolean> | CurrencyAttributeBuilder<string, boolean> | StatusAttributeBuilder<string, readonly Option[], boolean> | SelectAttributeBuilder<string, readonly Option[], boolean> | MultiselectAttributeBuilder<string, readonly Option[], boolean> | LocationAttributeBuilder<string, boolean> | TimestampAttributeBuilder<string, boolean> | FileAttributeBuilder<string, boolean> | UserAttributeBuilder<string, boolean> | SingleRelationAttributeBuilder<string, boolean> | MultiRelationAttributeBuilder<string, boolean> | RatingAttributeBuilder<string, boolean> | FormulaAttributeBuilder<string> | RollupAttributeBuilder<string>;
 /**
  * Extract the attribute name from a builder
  */
@@ -1672,4 +1785,4 @@ declare function view(name: string, label: string): ViewBuilder;
  */
 declare function group(id: string, label: string): GroupBuilder;
 
-export { ALL_SYSTEM_RESOURCES, type AddAttribute$1 as AddAttribute, type AnyAttributeBuilder, Attribute, AttributeGroupField, AttributeInUseError, type AttributeMap, AttributeNotFoundError, type AttributeSchema, type AttributeUsage, type BuilderConfig, CheckboxAttribute, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DateAttribute, type DefaultRoleName, type DefaultRolePermissionConfig, DuplicateError, EMPTY_VALUE_PLACEHOLDER, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, FlowBuilder, FlowDefinition, FlowPage, FlowPageBuilder, FlowRow, FlowRowBuilder, ForbiddenError, Group, GroupBuilder, type InferAttributeValue, type InferRecord, type InferRecordFromSchema, type InferRecordInput, type InferRecordUpdate, type InferRecordWithRequirements, Location, LocationAttribute, MultiRelationAttribute, MultiselectAttribute, NotFoundError, NotSystemObjectError, NumberAttribute, ObjectAction, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, ObjectReferencedError, Option, Phone, PhoneAttribute, ProtectedResourceError, ProtectedRoleError, RatingAttribute, RecordNotFoundError, type RecordReference, RecordReferencedError, RelationTarget, RoleNotFoundError, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, SchemaError, SchemaErrorCode, SelectAttribute, SingleRelationAttribute, StatusAttribute, SyncError, SystemAction, SystemResource, Tab, TabBuilder, TableTabConfig, TextAreaAttribute, TextAttribute, TimestampAttribute, type TypedAttribute, type TypedBuilderConfig, UserAttribute, UserProfileNotFoundError, ValidationError, type ValidationErrorDetail, ViewBuilder, ViewDefinition, type WithCustomAttributes, checkbox, currency, date, file, flow, formatAttributeValue, group, isDefaultRole, isForbiddenError, isNotFoundError, isProtectedResourceError, isSchemaError, isValidationError, location, multiselect, number, object, phone, rating, relation, select, status, text, textarea, timestamp, user, view };
+export { ALL_SYSTEM_RESOURCES, type AddAttribute$1 as AddAttribute, type AnyAttributeBuilder, Attribute, AttributeGroupField, AttributeInUseError, type AttributeMap, AttributeNotFoundError, type AttributeSchema, type AttributeUsage, type BuilderConfig, CheckboxAttribute, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DateAttribute, type DefaultRoleName, type DefaultRolePermissionConfig, DuplicateError, EMPTY_VALUE_PLACEHOLDER, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, FlowBuilder, FlowDefinition, FlowPage, FlowPageBuilder, FlowRow, FlowRowBuilder, ForbiddenError, FormulaAttribute, FormulaReturnType, Group, GroupBuilder, type InferAttributeValue, type InferRecord, type InferRecordFromSchema, type InferRecordInput, type InferRecordUpdate, type InferRecordWithRequirements, Location, LocationAttribute, MultiRelationAttribute, MultiselectAttribute, NotFoundError, NotSystemObjectError, NumberAttribute, ObjectAction, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, ObjectReferencedError, Option, Phone, PhoneAttribute, ProtectedResourceError, ProtectedRoleError, RatingAttribute, RecordNotFoundError, type RecordReference, RecordReferencedError, RelationTarget, RoleNotFoundError, RollupAttribute, RollupFunction, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, SchemaError, SchemaErrorCode, SelectAttribute, SingleRelationAttribute, StatusAttribute, SyncError, SystemAction, SystemResource, Tab, TabBuilder, TableTabConfig, TextAreaAttribute, TextAttribute, TimestampAttribute, type TypedAttribute, type TypedBuilderConfig, UserAttribute, UserProfileNotFoundError, ValidationError, type ValidationErrorDetail, ViewBuilder, ViewDefinition, type WithCustomAttributes, checkbox, currency, date, file, flow, formatAttributeValue, formula, group, isDefaultRole, isForbiddenError, isNotFoundError, isProtectedResourceError, isSchemaError, isValidationError, location, multiselect, number, object, phone, rating, relation, rollup, select, status, text, textarea, timestamp, user, view };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as Attribute, S as StatusAttribute, a as SelectAttribute, M as MultiselectAttribute, P as Phone, C as Currency, L as Location, b as SystemResource, c as SystemAction, O as ObjectAction, T as TextAttribute, d as TextAreaAttribute, N as NumberAttribute, e as CheckboxAttribute, D as DateAttribute, f as PhoneAttribute, g as CurrencyAttribute, h as Option, i as LocationAttribute, j as TimestampAttribute, F as FileAttribute, U as UserAttribute, k as SingleRelationAttribute, l as MultiRelationAttribute, R as RelationTarget, m as RatingAttribute, n as FlowDefinition, o as FlowPage, p as FlowRow, q as ObjectDefinition, r as Field, s as AttributeGroupField, G as Group, V as ViewDefinition, t as Tab } from './runtime-Dw2exb5q.js';
-export { b7 as ActivityTab, cw as AddAttributeInput, an as AdvancedFilterState, aZ as AssignRoleInput, c5 as AttributeChange, w as AttributeGroup, u as AttributeType, ce as AttributesRepository, X as AuditAction, Y as AuditActorType, Z as AuditChange, a0 as AuditListOptions, _ as AuditLogEntry, ck as AuditRepository, W as AuditResourceType, cn as AuditService, a1 as AuditServiceOptions, B as BaseAttribute, a9 as CheckboxFilterOperator, aN as CompletionStatus, $ as CreateAuditLogInput, cv as CreateCustomObjectInput, de as CreateDBAttribute, dt as CreateDBFlow, da as CreateDBObject, dp as CreateDBView, a5 as CreateFile, cq as CreateFlowInput, dh as CreateObjectRecord, aY as CreatePermissionInput, aW as CreateRoleInput, b1 as CreateUserProfile, cP as CreateViewInput, ag as CurrencyFilterValue, b6 as CustomTab, dd as DBAttribute, ds as DBFlow, d9 as DBObject, dn as DBView, d4 as DEFAULT_LABEL_FALLBACK, c4 as DatabaseAdapter, aa as DateFilterOperator, y as DateFormat, z as DateValue, I as DocumentFace, H as DocumentType, J as DocumentTypeConfig, aT as EffectivePermissions, a4 as File, cS as FileContent, dm as FileListOptions, cp as FileService, co as FileServiceOptions, K as FileVerificationConfig, a3 as FileVisibility, cg as FilesRepository, ak as FilterCombinator, am as FilterGroup, ae as FilterOperator, aj as FilterRule, al as FilterState, ai as FilterValue, aA as FlowRelation, az as FlowRowField, cs as FlowService, ay as FlowSlot, aB as FlowStatus, cj as FlowsRepository, b4 as FormTab, d2 as FullSyncOptions, d1 as FullSyncResult, aJ as GeocodingAdapter, aG as GeocodingAutocompleteParams, aI as GeocodingParams, ct as GeocodingService, aF as GeocodingSuggestion, cI as GetRelationOptionsParams, dk as GlobalSearchOptions, dl as GlobalSearchResultItem, cu as GlobalSearchService, c6 as HookContext, c7 as HookDefinition, c8 as HookHandler, cb as HookRegistry, c9 as HookType, di as ListOptions, E as LocationGranularity, ac as MultiselectFilterOperator, aw as NO_VALUE_OPERATORS, av as NoValueOperator, aK as NoopGeocodingAdapter, ca as NoopHookRegistry, a8 as NumberFilterOperator, x as NumberUnit, au as OPERATORS_BY_TYPE, aM as ObjectAttribute, aU as ObjectPermissions, aO as ObjectRecord, ch as ObjectRecordsRepository, cz as ObjectSchemaService, cy as ObjectSchemaServiceOptions, cd as ObjectsRepository, dv as OperationResult, aR as Permission, aP as PermissionScope, cB as PermissionService, cA as PermissionServiceOptions, cl as PermissionsRepository, ah as PhoneFilterValue, at as QueryState, cD as RecordService, cC as RecordServiceOptions, Q as RelationAttribute, ad as RelationFilterOperator, cG as RelationOption, cH as RelationOptionsResponse, cJ as RelationService, cF as RelationValidationError, cE as RelationValidationResult, af as RelativeDateValue, aH as ReverseGeocodingParams, aQ as Role, dj as SearchOptions, ab as SelectFilterOperator, cV as SignedUrlOptions, ar as SortDirection, as as SortRule, v as StatusGroup, cW as StorageAdapter, a2 as StorageProvider, cT as StorageUploadInput, cU as StorageUploadResult, cZ as SyncOptions, cY as SyncResult, aV as SystemPermissions, b3 as TabType, b5 as TableTab, bd as TenantId, a7 as TextFilterOperator, aL as Timestamps, df as UpdateDBAttribute, du as UpdateDBFlow, db as UpdateDBObject, dq as UpdateDBView, a6 as UpdateFile, cr as UpdateFlowInput, cx as UpdateObjectInput, aX as UpdateRoleInput, b2 as UpdateUserProfile, cQ as UpdateViewInput, cX as UploadFileInput, dg as UpsertDBAttribute, dc as UpsertDBObject, dr as UpsertDBView, b0 as UserProfile, cL as UserProfileService, cK as UserProfileServiceOptions, cf as UserProfilesRepository, a_ as UserRole, aS as UserRoleAssignment, cO as UserService, a$ as UserStatus, cN as UserValidationError, cM as UserValidationResult, bc as Uuid, bW as ValidationResult, cR as ViewService, dx as ViewSyncOptions, dw as ViewSyncResult, ci as ViewsRepository, by as attributeConfigSchemas, cm as buildAuditChanges, bl as checkboxConfigSchema, c3 as computeRecordStatus, bU as createAttributeValidator, bF as createCheckboxValidator, bI as createCurrencyValidator, bG as createDateValidator, b_ as createDraftValidator, bO as createFileValidator, bM as createLocationValidator, cc as createMockAdapter, bR as createMultiRelationValidator, bL as createMultiselectValidator, bE as createNumberValidator, bV as createObjectValidator, bH as createPhoneValidator, bT as createRatingValidator, bS as createRelationValidator, bK as createSelectValidator, bQ as createSingleRelationValidator, bJ as createStatusValidator, bD as createTextValidator, bN as createTimestampValidator, bP as createUserValidator, bo as currencyConfigSchema, bm as dateConfigSchema, d8 as enrichValuesWithSelectLabels, d7 as extractAttributeNames, bu as fileConfigSchema, be as generateId, bf as generatePrefixedId, bz as getAttributeConfigSchema, c1 as getMissingRequiredAttributes, d0 as getSyncPreview, dA as getViewSyncPreview, bb as isActivityTab, ao as isAdvancedFilterState, ba as isCustomTab, aC as isFlowDefinition, aD as isFlowPublished, b8 as isFormTab, d6 as isLabelExpression, ax as isNoValueOperator, c2 as isRecordComplete, aE as isSystemFlow, b9 as isTableTab, bq as locationConfigSchema, bt as multiselectConfigSchema, bk as numberConfigSchema, bB as parseAttributeConfig, bn as phoneConfigSchema, bx as ratingConfigSchema, bg as registry, bw as relationConfigSchema, d5 as renderLabelExpression, bC as safeParseAttributeConfig, bs as selectConfigSchema, bp as statusConfigSchema, d3 as syncAll, c_ as syncNativeObjects, dy as syncNativeViews, bi as textConfigSchema, bj as textareaConfigSchema, br as timestampConfigSchema, ap as toAdvancedFilterState, aq as toSimpleFilterState, bv as userConfigSchema, bX as validateAttribute, bA as validateAttributeConfig, b$ as validateDraft, c0 as validateDraftOrThrow, bY as validateObject, bZ as validateObjectOrThrow, c$ as verifyNativeObjectsSync, dz as verifyNativeViewsSync, bh as viewRegistry } from './runtime-Dw2exb5q.js';
+import { A as Attribute, S as StatusAttribute, a as SelectAttribute, M as MultiselectAttribute, P as Phone, C as Currency, L as Location, F as FormulaAttribute, R as RollupAttribute, b as SystemResource, c as SystemAction, O as ObjectAction, T as TextAttribute, d as TextAreaAttribute, N as NumberAttribute, e as CheckboxAttribute, D as DateAttribute, f as PhoneAttribute, g as CurrencyAttribute, h as Option, i as LocationAttribute, j as TimestampAttribute, k as FileAttribute, U as UserAttribute, l as SingleRelationAttribute, m as MultiRelationAttribute, n as RelationTarget, o as RatingAttribute, p as FormulaReturnType, q as RollupFunction, r as FlowDefinition, s as FlowPage, t as FlowRow, u as ObjectDefinition, v as Field, w as AttributeGroupField, G as Group, V as ViewDefinition, x as Tab } from './runtime-BpsaNQPs.js';
+export { bb as ActivityTab, d6 as AddAttributeInput, ar as AdvancedFilterState, b1 as AssignRoleInput, cH as AttributeChange, B as AttributeGroup, y as AttributeType, cQ as AttributesRepository, $ as AuditAction, a0 as AuditActorType, a1 as AuditChange, a4 as AuditListOptions, a2 as AuditLogEntry, cW as AuditRepository, _ as AuditResourceType, cZ as AuditService, a5 as AuditServiceOptions, E as BaseAttribute, ad as CheckboxFilterOperator, aR as CompletionStatus, a3 as CreateAuditLogInput, d5 as CreateCustomObjectInput, dX as CreateDBAttribute, e9 as CreateDBFlow, dT as CreateDBObject, e5 as CreateDBView, a9 as CreateFile, d0 as CreateFlowInput, d_ as CreateObjectRecord, b0 as CreatePermissionInput, a_ as CreateRoleInput, b5 as CreateUserProfile, dw as CreateViewInput, ak as CurrencyFilterValue, ba as CustomTab, dW as DBAttribute, e8 as DBFlow, dS as DBObject, e4 as DBView, dN as DEFAULT_LABEL_FALLBACK, cc as DatabaseAdapter, ae as DateFilterOperator, I as DateFormat, J as DateValue, W as DocumentFace, Q as DocumentType, X as DocumentTypeConfig, aX as EffectivePermissions, a8 as File, dz as FileContent, e3 as FileListOptions, c$ as FileService, c_ as FileServiceOptions, Y as FileVerificationConfig, a7 as FileVisibility, cS as FilesRepository, ao as FilterCombinator, aq as FilterGroup, ai as FilterOperator, an as FilterRule, ap as FilterState, am as FilterValue, aE as FlowRelation, aD as FlowRowField, d2 as FlowService, aC as FlowSlot, aF as FlowStatus, cV as FlowsRepository, b8 as FormTab, cp as FormulaResult, dL as FullSyncOptions, dK as FullSyncResult, aN as GeocodingAdapter, aK as GeocodingAutocompleteParams, aM as GeocodingParams, d3 as GeocodingService, aJ as GeocodingSuggestion, di as GetRelationOptionsParams, e1 as GlobalSearchOptions, e2 as GlobalSearchResultItem, d4 as GlobalSearchService, cI as HookContext, cJ as HookDefinition, cK as HookHandler, cN as HookRegistry, cL as HookType, ct as InvalidPathError, d$ as ListOptions, K as LocationGranularity, cu as MaxDepthExceededError, ag as MultiselectFilterOperator, aA as NO_VALUE_OPERATORS, az as NoValueOperator, aO as NoopGeocodingAdapter, cM as NoopHookRegistry, ac as NumberFilterOperator, H as NumberUnit, ay as OPERATORS_BY_TYPE, aQ as ObjectAttribute, aY as ObjectPermissions, aS as ObjectRecord, cT as ObjectRecordsRepository, d9 as ObjectSchemaService, d8 as ObjectSchemaServiceOptions, cP as ObjectsRepository, eb as OperationResult, cy as PathCardinality, cz as PathSegment, cA as PathSegmentType, aV as Permission, aT as PermissionScope, db as PermissionService, da as PermissionServiceOptions, cX as PermissionsRepository, al as PhoneFilterValue, ax as QueryState, dd as RecordService, dc as RecordServiceOptions, Z as RelationAttribute, ah as RelationFilterOperator, dg as RelationOption, dh as RelationOptionsResponse, dl as RelationResolverService, dj as RelationService, df as RelationValidationError, de as RelationValidationResult, aj as RelativeDateValue, dk as ResolvedRelations, aL as ReverseGeocodingParams, aU as Role, dm as RollupResult, dq as RollupScheduler, dp as RollupSchedulerOptions, dn as RollupService, cB as SchemaResolver, e0 as SearchOptions, af as SelectFilterOperator, dC as SignedUrlOptions, av as SortDirection, aw as SortRule, z as StatusGroup, dD as StorageAdapter, a6 as StorageProvider, dA as StorageUploadInput, dB as StorageUploadResult, dG as SyncOptions, dF as SyncResult, aZ as SystemPermissions, b7 as TabType, b9 as TableTab, bh as TenantId, ab as TextFilterOperator, aP as Timestamps, cF as TraversalOptions, cG as TraversalResult, dY as UpdateDBAttribute, ea as UpdateDBFlow, dU as UpdateDBObject, e6 as UpdateDBView, aa as UpdateFile, d1 as UpdateFlowInput, d7 as UpdateObjectInput, a$ as UpdateRoleInput, b6 as UpdateUserProfile, dx as UpdateViewInput, dE as UploadFileInput, dZ as UpsertDBAttribute, dV as UpsertDBObject, e7 as UpsertDBView, b4 as UserProfile, ds as UserProfileService, dr as UserProfileServiceOptions, cR as UserProfilesRepository, b2 as UserRole, aW as UserRoleAssignment, dv as UserService, b3 as UserStatus, du as UserValidationError, dt as UserValidationResult, bg as Uuid, c2 as ValidationResult, dy as ViewService, ed as ViewSyncOptions, ec as ViewSyncResult, cU as ViewsRepository, bE as attributeConfigSchemas, cY as buildAuditChanges, bp as checkboxConfigSchema, cb as computeRecordStatus, c0 as createAttributeValidator, bL as createCheckboxValidator, bO as createCurrencyValidator, bM as createDateValidator, c6 as createDraftValidator, bU as createFileValidator, b_ as createFormulaValidator, bS as createLocationValidator, cO as createMockAdapter, bX as createMultiRelationValidator, bR as createMultiselectValidator, bK as createNumberValidator, c1 as createObjectValidator, bN as createPhoneValidator, bZ as createRatingValidator, bY as createRelationValidator, b$ as createRollupValidator, bQ as createSelectValidator, bW as createSingleRelationValidator, bP as createStatusValidator, bJ as createTextValidator, bT as createTimestampValidator, bV as createUserValidator, bs as currencyConfigSchema, bq as dateConfigSchema, dR as enrichValuesWithSelectLabels, cd as evaluateFormula, ce as evaluateFormulaAttribute, cf as evaluateFormulaAttributeWithRelations, cg as evaluateFormulaWithRelations, ch as evaluateFormulaWithResult, dQ as extractAttributeNames, ci as extractFormulaVariables, cj as extractRelationNames, ck as extractRelationReferences, by as fileConfigSchema, cl as flattenRelationsForEval, cm as formatFormulaResult, bC as formulaConfigSchema, bi as generateId, bj as generatePrefixedId, bF as getAttributeConfigSchema, c9 as getMissingRequiredAttributes, cq as getPathDepth, cr as getRelationPath, dJ as getSyncPreview, cs as getTargetAttributeName, eg as getViewSyncPreview, cn as hasRelationReferences, bf as isActivityTab, as as isAdvancedFilterState, be as isCustomTab, aG as isFlowDefinition, aH as isFlowPublished, bc as isFormTab, dP as isLabelExpression, aB as isNoValueOperator, ca as isRecordComplete, aI as isSystemFlow, bd as isTableTab, bu as locationConfigSchema, bx as multiselectConfigSchema, bo as numberConfigSchema, bH as parseAttributeConfig, cv as parsePath, cw as pathHasManyCardinality, br as phoneConfigSchema, bB as ratingConfigSchema, bk as registry, bA as relationConfigSchema, dO as renderLabelExpression, cC as resolveMultiplePaths, cD as resolveSingleValue, bD as rollupConfigSchema, bI as safeParseAttributeConfig, bw as selectConfigSchema, bt as statusConfigSchema, dM as syncAll, dH as syncNativeObjects, ee as syncNativeViews, bm as textConfigSchema, bn as textareaConfigSchema, bv as timestampConfigSchema, at as toAdvancedFilterState, au as toSimpleFilterState, cE as traversePath, bz as userConfigSchema, c3 as validateAttribute, bG as validateAttributeConfig, c7 as validateDraft, c8 as validateDraftOrThrow, co as validateFormulaExpression, c4 as validateObject, c5 as validateObjectOrThrow, cx as validatePath, dI as verifyNativeObjectsSync, ef as verifyNativeViewsSync, bl as viewRegistry } from './runtime-BpsaNQPs.js';
 import { IconName, CountryIso3, CurrencyCode, MimeType, ColorId } from '@stndrds/constants';
 import 'zod';
 
@@ -214,8 +214,9 @@ type InferRecordUpdate<TMap extends AttributeMap> = Partial<InferRecordFromSchem
 /**
  * Base type for custom attribute values added via UI
  * Supports all possible attribute value types
+ * Formula and Rollup attributes don't have defaultValue, so we exclude them
  */
-type CustomAttributeValue = Attribute["defaultValue"] | undefined;
+type CustomAttributeValue = Exclude<Attribute, FormulaAttribute | RollupAttribute>["defaultValue"] | undefined;
 /**
  * Adds support for custom attributes (added via UI) to a record type
  * Preserves autocompletion for known attributes while allowing additional properties
@@ -609,7 +610,7 @@ declare abstract class BaseAttributeBuilder<TAttr extends Attribute> {
     description(value: string): this;
     icon(value: IconName): this;
     order(value: number): this;
-    defaultValue(value: TAttr["defaultValue"]): this;
+    defaultValue(value: "defaultValue" extends keyof TAttr ? TAttr["defaultValue"] : never): this;
     metadata(value: Record<string, unknown>): this;
     build(): TAttr;
 }
@@ -946,10 +947,122 @@ declare class RatingAttributeBuilder<TName extends string, TRequired extends boo
     optional(): RatingAttributeBuilder<TName, false>;
 }
 declare function rating<TName extends string>(config: TypedBuilderConfig<TName>): RatingAttributeBuilder<TName, false>;
+/**
+ * Builder for formula attributes (computed values)
+ *
+ * Formula attributes are always read-only and cannot be required.
+ */
+declare class FormulaAttributeBuilder<TName extends string> extends BaseAttributeBuilder<FormulaAttribute> {
+    readonly _types: {
+        name: TName;
+        attribute: FormulaAttribute;
+        required: false;
+    };
+    constructor(name: TName, label: string);
+    /**
+     * Set the formula expression
+     * @param expr - Expression to evaluate (e.g., "price * quantity")
+     */
+    expression(expr: string): this;
+    /**
+     * Set the expected return type for formatting
+     * @param type - Return type: "text", "number", "boolean", or "date"
+     */
+    returns(type: FormulaReturnType): this;
+    /**
+     * Set decimal places for number results
+     */
+    decimals(value: number): this;
+    required(): any;
+    optional(): any;
+}
+/**
+ * Create a formula attribute builder
+ *
+ * @example Simple calculation
+ * ```typescript
+ * formula({ name: "total", label: "Total" })
+ *   .expression("price * quantity")
+ *   .returns("number")
+ *   .decimals(2)
+ * ```
+ *
+ * @example With functions
+ * ```typescript
+ * formula({ name: "fullName", label: "Full Name" })
+ *   .expression("CONCAT(firstName, ' ', lastName)")
+ *   .returns("text")
+ * ```
+ */
+declare function formula<TName extends string>(config: TypedBuilderConfig<TName>): FormulaAttributeBuilder<TName>;
+/**
+ * Builder for rollup attributes (aggregations from related records)
+ *
+ * Rollup attributes are always read-only and cannot be required.
+ */
+declare class RollupAttributeBuilder<TName extends string> extends BaseAttributeBuilder<RollupAttribute> {
+    readonly _types: {
+        name: TName;
+        attribute: RollupAttribute;
+        required: false;
+    };
+    constructor(name: TName, label: string);
+    /**
+     * Set the relation attribute to aggregate from
+     * @param relationName - Name of the relation attribute on this object
+     */
+    from(relationName: string): this;
+    /**
+     * Set the target attribute to aggregate
+     * @param attrName - Name of the attribute on the related object
+     */
+    aggregate(attrName: string): this;
+    /**
+     * Set the aggregation function
+     */
+    using(fn: RollupFunction): this;
+    /**
+     * Set decimal places for numeric results
+     */
+    decimals(value: number): this;
+    /**
+     * Display the rollup value using the target attribute's type formatter
+     * instead of the default rollup-specific formatting
+     */
+    showAsOriginal(): this;
+    /**
+     * Set multi-level path for traversing nested relations (Phase 4+)
+     * @param path - Dot notation path (e.g., "orders.items")
+     */
+    path(relationPath: string): this;
+    required(): any;
+    optional(): any;
+}
+/**
+ * Create a rollup attribute builder
+ *
+ * @example Sum of related amounts
+ * ```typescript
+ * rollup({ name: "totalOrders", label: "Total Orders" })
+ *   .from("orders")           // relation attribute name
+ *   .aggregate("amount")      // target attribute to sum
+ *   .using("sum")
+ *   .decimals(2)
+ * ```
+ *
+ * @example Count of related records
+ * ```typescript
+ * rollup({ name: "orderCount", label: "Number of Orders" })
+ *   .from("orders")
+ *   .aggregate("id")          // any attribute works for count
+ *   .using("count")
+ * ```
+ */
+declare function rollup<TName extends string>(config: TypedBuilderConfig<TName>): RollupAttributeBuilder<TName>;
 /**
  * Union of all attribute builder types
  */
-type AnyAttributeBuilder = TextAttributeBuilder<string, boolean> | TextAreaAttributeBuilder<string, boolean> | NumberAttributeBuilder<string, boolean> | CheckboxAttributeBuilder<string, boolean> | DateAttributeBuilder<string, boolean> | PhoneAttributeBuilder<string, boolean> | CurrencyAttributeBuilder<string, boolean> | StatusAttributeBuilder<string, readonly Option[], boolean> | SelectAttributeBuilder<string, readonly Option[], boolean> | MultiselectAttributeBuilder<string, readonly Option[], boolean> | LocationAttributeBuilder<string, boolean> | TimestampAttributeBuilder<string, boolean> | FileAttributeBuilder<string, boolean> | UserAttributeBuilder<string, boolean> | SingleRelationAttributeBuilder<string, boolean> | MultiRelationAttributeBuilder<string, boolean> | RatingAttributeBuilder<string, boolean>;
+type AnyAttributeBuilder = TextAttributeBuilder<string, boolean> | TextAreaAttributeBuilder<string, boolean> | NumberAttributeBuilder<string, boolean> | CheckboxAttributeBuilder<string, boolean> | DateAttributeBuilder<string, boolean> | PhoneAttributeBuilder<string, boolean> | CurrencyAttributeBuilder<string, boolean> | StatusAttributeBuilder<string, readonly Option[], boolean> | SelectAttributeBuilder<string, readonly Option[], boolean> | MultiselectAttributeBuilder<string, readonly Option[], boolean> | LocationAttributeBuilder<string, boolean> | TimestampAttributeBuilder<string, boolean> | FileAttributeBuilder<string, boolean> | UserAttributeBuilder<string, boolean> | SingleRelationAttributeBuilder<string, boolean> | MultiRelationAttributeBuilder<string, boolean> | RatingAttributeBuilder<string, boolean> | FormulaAttributeBuilder<string> | RollupAttributeBuilder<string>;
 /**
  * Extract the attribute name from a builder
  */
@@ -1672,4 +1785,4 @@ declare function view(name: string, label: string): ViewBuilder;
  */
 declare function group(id: string, label: string): GroupBuilder;
 
-export { ALL_SYSTEM_RESOURCES, type AddAttribute$1 as AddAttribute, type AnyAttributeBuilder, Attribute, AttributeGroupField, AttributeInUseError, type AttributeMap, AttributeNotFoundError, type AttributeSchema, type AttributeUsage, type BuilderConfig, CheckboxAttribute, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DateAttribute, type DefaultRoleName, type DefaultRolePermissionConfig, DuplicateError, EMPTY_VALUE_PLACEHOLDER, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, FlowBuilder, FlowDefinition, FlowPage, FlowPageBuilder, FlowRow, FlowRowBuilder, ForbiddenError, Group, GroupBuilder, type InferAttributeValue, type InferRecord, type InferRecordFromSchema, type InferRecordInput, type InferRecordUpdate, type InferRecordWithRequirements, Location, LocationAttribute, MultiRelationAttribute, MultiselectAttribute, NotFoundError, NotSystemObjectError, NumberAttribute, ObjectAction, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, ObjectReferencedError, Option, Phone, PhoneAttribute, ProtectedResourceError, ProtectedRoleError, RatingAttribute, RecordNotFoundError, type RecordReference, RecordReferencedError, RelationTarget, RoleNotFoundError, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, SchemaError, SchemaErrorCode, SelectAttribute, SingleRelationAttribute, StatusAttribute, SyncError, SystemAction, SystemResource, Tab, TabBuilder, TableTabConfig, TextAreaAttribute, TextAttribute, TimestampAttribute, type TypedAttribute, type TypedBuilderConfig, UserAttribute, UserProfileNotFoundError, ValidationError, type ValidationErrorDetail, ViewBuilder, ViewDefinition, type WithCustomAttributes, checkbox, currency, date, file, flow, formatAttributeValue, group, isDefaultRole, isForbiddenError, isNotFoundError, isProtectedResourceError, isSchemaError, isValidationError, location, multiselect, number, object, phone, rating, relation, select, status, text, textarea, timestamp, user, view };
+export { ALL_SYSTEM_RESOURCES, type AddAttribute$1 as AddAttribute, type AnyAttributeBuilder, Attribute, AttributeGroupField, AttributeInUseError, type AttributeMap, AttributeNotFoundError, type AttributeSchema, type AttributeUsage, type BuilderConfig, CheckboxAttribute, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DateAttribute, type DefaultRoleName, type DefaultRolePermissionConfig, DuplicateError, EMPTY_VALUE_PLACEHOLDER, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, FlowBuilder, FlowDefinition, FlowPage, FlowPageBuilder, FlowRow, FlowRowBuilder, ForbiddenError, FormulaAttribute, FormulaReturnType, Group, GroupBuilder, type InferAttributeValue, type InferRecord, type InferRecordFromSchema, type InferRecordInput, type InferRecordUpdate, type InferRecordWithRequirements, Location, LocationAttribute, MultiRelationAttribute, MultiselectAttribute, NotFoundError, NotSystemObjectError, NumberAttribute, ObjectAction, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, ObjectReferencedError, Option, Phone, PhoneAttribute, ProtectedResourceError, ProtectedRoleError, RatingAttribute, RecordNotFoundError, type RecordReference, RecordReferencedError, RelationTarget, RoleNotFoundError, RollupAttribute, RollupFunction, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, SchemaError, SchemaErrorCode, SelectAttribute, SingleRelationAttribute, StatusAttribute, SyncError, SystemAction, SystemResource, Tab, TabBuilder, TableTabConfig, TextAreaAttribute, TextAttribute, TimestampAttribute, type TypedAttribute, type TypedBuilderConfig, UserAttribute, UserProfileNotFoundError, ValidationError, type ValidationErrorDetail, ViewBuilder, ViewDefinition, type WithCustomAttributes, checkbox, currency, date, file, flow, formatAttributeValue, formula, group, isDefaultRole, isForbiddenError, isNotFoundError, isProtectedResourceError, isSchemaError, isValidationError, location, multiselect, number, object, phone, rating, relation, rollup, select, status, text, textarea, timestamp, user, view };