@stndrds/schema 0.1.0-alpha.15 → 0.1.0-alpha.17

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-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 ObjectDefinition, o as Field, p as AttributeGroupField, G as Group, V as ViewDefinition, q as Tab } from './runtime-DUxWyRcq.mjs';
-export { cf as AddAttributeInput, ak as AdvancedFilterState, aP as AssignRoleInput, bV as AttributeChange, t as AttributeGroup, r as AttributeType, c2 as AttributesRepository, K as AuditAction, Q as AuditActorType, W as AuditChange, Z as AuditListOptions, X as AuditLogEntry, c7 as AuditRepository, J as AuditResourceType, ca as AuditService, _ as AuditServiceOptions, B as BaseAttribute, a6 as CheckboxFilterOperator, aD as CompletionStatus, Y as CreateAuditLogInput, ce as CreateCustomObjectInput, cP as CreateDBAttribute, cL as CreateDBObject, cZ as CreateDBView, a2 as CreateFile, cS as CreateObjectRecord, aO as CreatePermissionInput, aM as CreateRoleInput, aT as CreateUserProfile, cv as CreateViewInput, ad as CurrencyFilterValue, aY as CustomTab, cO as DBAttribute, cK as DBObject, cY as DBView, cG as DEFAULT_LABEL_FALLBACK, bU as DatabaseAdapter, a7 as DateFilterOperator, v as DateFormat, w as DateValue, z as DocumentFace, y as DocumentType, E as DocumentTypeConfig, aJ as EffectivePermissions, a1 as File, cX as FileListOptions, cb as FileService, H as FileVerificationConfig, a0 as FileVisibility, c4 as FilesRepository, ah as FilterCombinator, aj as FilterGroup, ab as FilterOperator, ag as FilterRule, ai as FilterState, af as FilterValue, aW as FormTab, cE as FullSyncOptions, cD as FullSyncResult, az as GeocodingAdapter, aw as GeocodingAutocompleteParams, ay as GeocodingParams, cc as GeocodingService, av as GeocodingSuggestion, cr as GetRelationOptionsParams, cV as GlobalSearchOptions, cW as GlobalSearchResultItem, cd as GlobalSearchService, bW as HookContext, bX as HookDefinition, bY as HookHandler, b$ as HookRegistry, bZ as HookType, cT as ListOptions, x as LocationGranularity, a9 as MultiselectFilterOperator, at as NO_VALUE_OPERATORS, as as NoValueOperator, aA as NoopGeocodingAdapter, b_ as NoopHookRegistry, a5 as NumberFilterOperator, u as NumberUnit, ar as OPERATORS_BY_TYPE, aC as ObjectAttribute, aK as ObjectPermissions, aE as ObjectRecord, c5 as ObjectRecordsRepository, ci as ObjectSchemaService, ch as ObjectSchemaServiceOptions, c1 as ObjectsRepository, d0 as OperationResult, aH as Permission, aF as PermissionScope, ck as PermissionService, cj as PermissionServiceOptions, c8 as PermissionsRepository, ae as PhoneFilterValue, aq as QueryState, cm as RecordService, cl as RecordServiceOptions, I as RelationAttribute, aa as RelationFilterOperator, cp as RelationOption, cq as RelationOptionsResponse, cs as RelationService, co as RelationValidationError, cn as RelationValidationResult, ac as RelativeDateValue, ax as ReverseGeocodingParams, aG as Role, cU as SearchOptions, a8 as SelectFilterOperator, ao as SortDirection, ap as SortRule, s as StatusGroup, $ as StorageProvider, cz as SyncOptions, cy as SyncResult, aL as SystemPermissions, aV as TabType, aX as TableTab, b1 as TenantId, a4 as TextFilterOperator, aB as Timestamps, cQ as UpdateDBAttribute, cM as UpdateDBObject, c_ as UpdateDBView, a3 as UpdateFile, cg as UpdateObjectInput, aN as UpdateRoleInput, aU as UpdateUserProfile, cw as UpdateViewInput, cR as UpsertDBAttribute, cN as UpsertDBObject, c$ as UpsertDBView, aS as UserProfile, cu as UserProfileService, ct as UserProfileServiceOptions, c3 as UserProfilesRepository, aQ as UserRole, aI as UserRoleAssignment, aR as UserStatus, b0 as Uuid, bK as ValidationResult, cx as ViewService, d2 as ViewSyncOptions, d1 as ViewSyncResult, c6 as ViewsRepository, bm as attributeConfigSchemas, c9 as buildAuditChanges, b9 as checkboxConfigSchema, bT as computeRecordStatus, bI as createAttributeValidator, bt as createCheckboxValidator, bw as createCurrencyValidator, bu as createDateValidator, bO as createDraftValidator, bC as createFileValidator, bA as createLocationValidator, c0 as createMockAdapter, bF as createMultiRelationValidator, bz as createMultiselectValidator, bs as createNumberValidator, bJ as createObjectValidator, bv as createPhoneValidator, bH as createRatingValidator, bG as createRelationValidator, by as createSelectValidator, bE as createSingleRelationValidator, bx as createStatusValidator, br as createTextValidator, bB as createTimestampValidator, bD as createUserValidator, bc as currencyConfigSchema, ba as dateConfigSchema, cJ as extractAttributeNames, bi as fileConfigSchema, b2 as generateId, b3 as generatePrefixedId, bn as getAttributeConfigSchema, bR as getMissingRequiredAttributes, cC as getSyncPreview, d5 as getViewSyncPreview, al as isAdvancedFilterState, a$ as isCustomTab, aZ as isFormTab, cI as isLabelExpression, au as isNoValueOperator, bS as isRecordComplete, a_ as isTableTab, be as locationConfigSchema, bh as multiselectConfigSchema, b8 as numberConfigSchema, bp as parseAttributeConfig, bb as phoneConfigSchema, bl as ratingConfigSchema, b4 as registry, bk as relationConfigSchema, cH as renderLabelExpression, bq as safeParseAttributeConfig, bg as selectConfigSchema, bd as statusConfigSchema, cF as syncAll, cA as syncNativeObjects, d3 as syncNativeViews, b6 as textConfigSchema, b7 as textareaConfigSchema, bf as timestampConfigSchema, am as toAdvancedFilterState, an as toSimpleFilterState, bj as userConfigSchema, bL as validateAttribute, bo as validateAttributeConfig, bP as validateDraft, bQ as validateDraftOrThrow, bM as validateObject, bN as validateObjectOrThrow, cB as verifyNativeObjectsSync, d4 as verifyNativeViewsSync, b5 as viewRegistry } from './runtime-DUxWyRcq.mjs';
-import { IconName, CountryIso3, CurrencyCode, MimeType } from '@stndrds/constants';
+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--rp-TG-h.mjs';
+export { b7 as ActivityTab, cv 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, cu as CreateCustomObjectInput, d4 as CreateDBAttribute, di as CreateDBFlow, d0 as CreateDBObject, de as CreateDBView, a5 as CreateFile, cp as CreateFlowInput, d7 as CreateObjectRecord, aY as CreatePermissionInput, aW as CreateRoleInput, b1 as CreateUserProfile, cL as CreateViewInput, ag as CurrencyFilterValue, b6 as CustomTab, d3 as DBAttribute, dh as DBFlow, c$ as DBObject, dd as DBView, cW 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, dc as FileListOptions, co as FileService, 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, cr as FlowService, ay as FlowSlot, aB as FlowStatus, cj as FlowsRepository, b4 as FormTab, cU as FullSyncOptions, cT as FullSyncResult, aJ as GeocodingAdapter, aG as GeocodingAutocompleteParams, aI as GeocodingParams, cs as GeocodingService, aF as GeocodingSuggestion, cH as GetRelationOptionsParams, da as GlobalSearchOptions, db as GlobalSearchResultItem, ct as GlobalSearchService, c6 as HookContext, c7 as HookDefinition, c8 as HookHandler, cb as HookRegistry, c9 as HookType, d8 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, cy as ObjectSchemaService, cx as ObjectSchemaServiceOptions, cd as ObjectsRepository, dk as OperationResult, aR as Permission, aP as PermissionScope, cA as PermissionService, cz as PermissionServiceOptions, cl as PermissionsRepository, ah as PhoneFilterValue, at as QueryState, cC as RecordService, cB as RecordServiceOptions, Q as RelationAttribute, ad as RelationFilterOperator, cF as RelationOption, cG as RelationOptionsResponse, cI as RelationService, cE as RelationValidationError, cD as RelationValidationResult, af as RelativeDateValue, aH as ReverseGeocodingParams, aQ as Role, d9 as SearchOptions, ab as SelectFilterOperator, ar as SortDirection, as as SortRule, v as StatusGroup, a2 as StorageProvider, cP as SyncOptions, cO as SyncResult, aV as SystemPermissions, b3 as TabType, b5 as TableTab, bd as TenantId, a7 as TextFilterOperator, aL as Timestamps, d5 as UpdateDBAttribute, dj as UpdateDBFlow, d1 as UpdateDBObject, df as UpdateDBView, a6 as UpdateFile, cq as UpdateFlowInput, cw as UpdateObjectInput, aX as UpdateRoleInput, b2 as UpdateUserProfile, cM as UpdateViewInput, d6 as UpsertDBAttribute, d2 as UpsertDBObject, dg as UpsertDBView, b0 as UserProfile, cK as UserProfileService, cJ as UserProfileServiceOptions, cf as UserProfilesRepository, a_ as UserRole, aS as UserRoleAssignment, a$ as UserStatus, bc as Uuid, bW as ValidationResult, cN as ViewService, dm as ViewSyncOptions, dl 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, c_ as enrichValuesWithSelectLabels, cZ as extractAttributeNames, bu as fileConfigSchema, be as generateId, bf as generatePrefixedId, bz as getAttributeConfigSchema, c1 as getMissingRequiredAttributes, cS as getSyncPreview, dq as getViewSyncPreview, bb as isActivityTab, ao as isAdvancedFilterState, ba as isCustomTab, aC as isFlowDefinition, aD as isFlowPublished, b8 as isFormTab, cY 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, cX as renderLabelExpression, bC as safeParseAttributeConfig, bs as selectConfigSchema, bp as statusConfigSchema, cV as syncAll, cQ as syncNativeObjects, dn 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, cR as verifyNativeObjectsSync, dp as verifyNativeViewsSync, bh as viewRegistry } from './runtime--rp-TG-h.mjs';
+import { IconName, CountryIso3, CurrencyCode, MimeType, ColorId } from '@stndrds/constants';
 import 'zod';
 
 /**
@@ -300,6 +300,45 @@ type ExtractAttributes<TBuilder> = TBuilder extends {
     };
 } ? A : never;
 
+/**
+ * Default empty value placeholder
+ */
+declare const EMPTY_VALUE_PLACEHOLDER = "\u2014";
+/**
+ * Format an attribute value for display
+ *
+ * This function converts raw attribute values into human-readable strings
+ * based on the attribute type and configuration.
+ *
+ * @param value - The raw value to format
+ * @param attribute - The attribute definition
+ * @returns Formatted string representation
+ *
+ * @example
+ * ```typescript
+ * // Text attribute
+ * formatAttributeValue("Hello", textAttr);
+ * // → "Hello"
+ *
+ * // Currency attribute
+ * formatAttributeValue({ value: 1500, code: "EUR" }, currencyAttr);
+ * // → "1,500.00 EUR"
+ *
+ * // Select attribute with options
+ * formatAttributeValue("active", statusAttr);
+ * // → "Active" (label from options)
+ *
+ * // Location with city granularity
+ * formatAttributeValue({ city: "Paris", country: "FRA" }, locationAttr);
+ * // → "Paris, FRA"
+ *
+ * // Empty value
+ * formatAttributeValue(null, textAttr);
+ * // → "—"
+ * ```
+ */
+declare function formatAttributeValue(value: unknown, attribute: Attribute): string;
+
 /**
  * System resources that can be managed through permissions.
  */
@@ -917,6 +956,231 @@ type ExtractAttributeRequired<T> = T extends {
     };
 } ? R : false;
 
+/**
+ * Builder for creating flow rows with fields
+ */
+declare class FlowRowBuilder {
+    private pageBuilder;
+    private rowData;
+    /** @internal */
+    constructor(pageBuilder: FlowPageBuilder, id: string, order: number);
+    /**
+     * Add a field to the current row
+     *
+     * @param slotId - Reference to a slot defined with .slot()
+     * @param attribute - Attribute name on the object
+     * @param options - Optional field configuration
+     *
+     * @example
+     * ```typescript
+     * .row("row-1")
+     *   .field("mr", "firstName")
+     *   .field("mr", "lastName")
+     * ```
+     */
+    field(slotId: string, attribute: string, options?: {
+        label?: string;
+        required?: boolean;
+    }): this;
+    /**
+     * Start a new row on the same page
+     */
+    row(id: string): FlowRowBuilder;
+    /**
+     * Start a new page
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build the final flow definition
+     */
+    build(): FlowDefinition;
+}
+/**
+ * Builder for creating flow pages with rows
+ */
+declare class FlowPageBuilder {
+    private flow;
+    private pageData;
+    private rowOrder;
+    /** @internal */
+    constructor(flow: FlowBuilder, id: string, label: string, description?: string);
+    /**
+     * Add a row to the current page
+     *
+     * @param id - Unique row identifier
+     *
+     * @example
+     * ```typescript
+     * .page("identity", "Identité")
+     *   .row("name-row")
+     *     .field("mr", "firstName")
+     *     .field("mr", "lastName")
+     *   .row("email-row")
+     *     .field("mr", "email")
+     * ```
+     */
+    row(id: string): FlowRowBuilder;
+    /**
+     * Start a new page
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build the final flow definition
+     */
+    build(): FlowDefinition;
+    /** @internal */
+    _finalizeRow(row: FlowRow): this;
+    /** @internal */
+    _getFlow(): FlowBuilder;
+    /** @internal */
+    _getPageData(): FlowPage;
+}
+/**
+ * Fluent builder for creating FlowDefinition with validation
+ *
+ * @example
+ * ```typescript
+ * const COUPLE_FLOW = flow("couple-creation", "Création Couple")
+ *   .description("Create a couple with company")
+ *   .slot("mr", "contacts", "Monsieur", { color: "blue" })
+ *   .slot("mme", "contacts", "Madame", { color: "pink" })
+ *   .slot("company", "companies", "Entreprise", { color: "green" })
+ *   .relation("mr", "company", "company")
+ *   .relation("mme", "company", "company")
+ *   .page("identity", "Identité")
+ *     .row("mr-name")
+ *       .field("mr", "firstName")
+ *       .field("mr", "lastName")
+ *     .row("mme-name")
+ *       .field("mme", "firstName")
+ *       .field("mme", "lastName")
+ *   .page("company", "Entreprise")
+ *     .row("company-name")
+ *       .field("company", "name")
+ *     .row("company-siret")
+ *       .field("company", "siret")
+ *   .build();
+ * ```
+ */
+declare class FlowBuilder {
+    private data;
+    constructor(name: string, label: string);
+    /**
+     * Set flow description
+     */
+    description(value: string): this;
+    /**
+     * Set flow icon
+     */
+    icon(value: IconName): this;
+    /**
+     * Set extensible metadata
+     */
+    metadata(value: Record<string, unknown>): this;
+    /**
+     * Add a slot (object to create in the flow)
+     *
+     * @param id - Unique slot identifier (used to reference in fields and relations)
+     * @param objectName - Name of the object to create
+     * @param label - Display label for the slot
+     * @param options - Optional slot configuration
+     *
+     * @example
+     * ```typescript
+     * .slot("mr", "contacts", "Monsieur", { color: "blue", icon: "user" })
+     * .slot("company", "companies", "Entreprise", { color: "green" })
+     * ```
+     */
+    slot(id: string, objectName: string, label: string, options?: {
+        color?: ColorId;
+        icon?: IconName;
+    }): this;
+    /**
+     * Define a relation between two slots
+     * The source slot will be linked to the target slot via the specified attribute
+     *
+     * @param sourceSlotId - Slot that has the relation attribute
+     * @param sourceAttribute - Relation attribute name on the source
+     * @param targetSlotId - Target slot to link to
+     *
+     * @example
+     * ```typescript
+     * // mr.company → company (the contact's company field will be set to the created company)
+     * .relation("mr", "company", "company")
+     * ```
+     */
+    relation(sourceSlotId: string, sourceAttribute: string, targetSlotId: string): this;
+    /**
+     * Start a new page/step in the flow
+     *
+     * @param id - Unique page identifier
+     * @param label - Display label
+     * @param description - Optional description
+     *
+     * @example
+     * ```typescript
+     * .page("identity", "Identité", "Informations personnelles")
+     *   .row("name")
+     *     .field("mr", "firstName")
+     *     .field("mr", "lastName")
+     * ```
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build and validate the flow definition
+     *
+     * @throws Error if validation fails
+     */
+    build(): FlowDefinition;
+    /**
+     * Validate that required data is present
+     */
+    private validateRequiredData;
+    /**
+     * Validate that all field slotId references exist
+     */
+    private validateFieldReferences;
+    /**
+     * Validate that all relation references exist and are valid
+     */
+    private validateRelationReferences;
+    /**
+     * @internal Used by FlowPageBuilder to finalize a page
+     */
+    _finalizePage(page: FlowPage): this;
+    /**
+     * Validate flow name format (kebab-case)
+     */
+    private validateName;
+    /**
+     * Validate that there are no circular dependencies in relations
+     * Uses DFS to detect cycles in the dependency graph
+     */
+    private validateNoCircularDependencies;
+}
+/**
+ * Create a new flow builder
+ *
+ * @param name - Flow name (kebab-case)
+ * @param label - Display label
+ *
+ * @example
+ * ```typescript
+ * const COUPLE_FLOW = flow("couple-creation", "Création Couple")
+ *   .slot("mr", "contacts", "Monsieur")
+ *   .slot("mme", "contacts", "Madame")
+ *   .page("identity", "Identité")
+ *     .row("mr-name")
+ *       .field("mr", "firstName")
+ *       .field("mr", "lastName")
+ *     .row("mme-name")
+ *       .field("mme", "firstName")
+ *       .field("mme", "lastName")
+ *   .build();
+ * ```
+ */
+declare function flow(name: string, label: string): FlowBuilder;
+
 /**
  * Extract attribute info from a builder instance
  */
@@ -1397,4 +1661,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, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, 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, 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, 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 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-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 ObjectDefinition, o as Field, p as AttributeGroupField, G as Group, V as ViewDefinition, q as Tab } from './runtime-DUxWyRcq.js';
-export { cf as AddAttributeInput, ak as AdvancedFilterState, aP as AssignRoleInput, bV as AttributeChange, t as AttributeGroup, r as AttributeType, c2 as AttributesRepository, K as AuditAction, Q as AuditActorType, W as AuditChange, Z as AuditListOptions, X as AuditLogEntry, c7 as AuditRepository, J as AuditResourceType, ca as AuditService, _ as AuditServiceOptions, B as BaseAttribute, a6 as CheckboxFilterOperator, aD as CompletionStatus, Y as CreateAuditLogInput, ce as CreateCustomObjectInput, cP as CreateDBAttribute, cL as CreateDBObject, cZ as CreateDBView, a2 as CreateFile, cS as CreateObjectRecord, aO as CreatePermissionInput, aM as CreateRoleInput, aT as CreateUserProfile, cv as CreateViewInput, ad as CurrencyFilterValue, aY as CustomTab, cO as DBAttribute, cK as DBObject, cY as DBView, cG as DEFAULT_LABEL_FALLBACK, bU as DatabaseAdapter, a7 as DateFilterOperator, v as DateFormat, w as DateValue, z as DocumentFace, y as DocumentType, E as DocumentTypeConfig, aJ as EffectivePermissions, a1 as File, cX as FileListOptions, cb as FileService, H as FileVerificationConfig, a0 as FileVisibility, c4 as FilesRepository, ah as FilterCombinator, aj as FilterGroup, ab as FilterOperator, ag as FilterRule, ai as FilterState, af as FilterValue, aW as FormTab, cE as FullSyncOptions, cD as FullSyncResult, az as GeocodingAdapter, aw as GeocodingAutocompleteParams, ay as GeocodingParams, cc as GeocodingService, av as GeocodingSuggestion, cr as GetRelationOptionsParams, cV as GlobalSearchOptions, cW as GlobalSearchResultItem, cd as GlobalSearchService, bW as HookContext, bX as HookDefinition, bY as HookHandler, b$ as HookRegistry, bZ as HookType, cT as ListOptions, x as LocationGranularity, a9 as MultiselectFilterOperator, at as NO_VALUE_OPERATORS, as as NoValueOperator, aA as NoopGeocodingAdapter, b_ as NoopHookRegistry, a5 as NumberFilterOperator, u as NumberUnit, ar as OPERATORS_BY_TYPE, aC as ObjectAttribute, aK as ObjectPermissions, aE as ObjectRecord, c5 as ObjectRecordsRepository, ci as ObjectSchemaService, ch as ObjectSchemaServiceOptions, c1 as ObjectsRepository, d0 as OperationResult, aH as Permission, aF as PermissionScope, ck as PermissionService, cj as PermissionServiceOptions, c8 as PermissionsRepository, ae as PhoneFilterValue, aq as QueryState, cm as RecordService, cl as RecordServiceOptions, I as RelationAttribute, aa as RelationFilterOperator, cp as RelationOption, cq as RelationOptionsResponse, cs as RelationService, co as RelationValidationError, cn as RelationValidationResult, ac as RelativeDateValue, ax as ReverseGeocodingParams, aG as Role, cU as SearchOptions, a8 as SelectFilterOperator, ao as SortDirection, ap as SortRule, s as StatusGroup, $ as StorageProvider, cz as SyncOptions, cy as SyncResult, aL as SystemPermissions, aV as TabType, aX as TableTab, b1 as TenantId, a4 as TextFilterOperator, aB as Timestamps, cQ as UpdateDBAttribute, cM as UpdateDBObject, c_ as UpdateDBView, a3 as UpdateFile, cg as UpdateObjectInput, aN as UpdateRoleInput, aU as UpdateUserProfile, cw as UpdateViewInput, cR as UpsertDBAttribute, cN as UpsertDBObject, c$ as UpsertDBView, aS as UserProfile, cu as UserProfileService, ct as UserProfileServiceOptions, c3 as UserProfilesRepository, aQ as UserRole, aI as UserRoleAssignment, aR as UserStatus, b0 as Uuid, bK as ValidationResult, cx as ViewService, d2 as ViewSyncOptions, d1 as ViewSyncResult, c6 as ViewsRepository, bm as attributeConfigSchemas, c9 as buildAuditChanges, b9 as checkboxConfigSchema, bT as computeRecordStatus, bI as createAttributeValidator, bt as createCheckboxValidator, bw as createCurrencyValidator, bu as createDateValidator, bO as createDraftValidator, bC as createFileValidator, bA as createLocationValidator, c0 as createMockAdapter, bF as createMultiRelationValidator, bz as createMultiselectValidator, bs as createNumberValidator, bJ as createObjectValidator, bv as createPhoneValidator, bH as createRatingValidator, bG as createRelationValidator, by as createSelectValidator, bE as createSingleRelationValidator, bx as createStatusValidator, br as createTextValidator, bB as createTimestampValidator, bD as createUserValidator, bc as currencyConfigSchema, ba as dateConfigSchema, cJ as extractAttributeNames, bi as fileConfigSchema, b2 as generateId, b3 as generatePrefixedId, bn as getAttributeConfigSchema, bR as getMissingRequiredAttributes, cC as getSyncPreview, d5 as getViewSyncPreview, al as isAdvancedFilterState, a$ as isCustomTab, aZ as isFormTab, cI as isLabelExpression, au as isNoValueOperator, bS as isRecordComplete, a_ as isTableTab, be as locationConfigSchema, bh as multiselectConfigSchema, b8 as numberConfigSchema, bp as parseAttributeConfig, bb as phoneConfigSchema, bl as ratingConfigSchema, b4 as registry, bk as relationConfigSchema, cH as renderLabelExpression, bq as safeParseAttributeConfig, bg as selectConfigSchema, bd as statusConfigSchema, cF as syncAll, cA as syncNativeObjects, d3 as syncNativeViews, b6 as textConfigSchema, b7 as textareaConfigSchema, bf as timestampConfigSchema, am as toAdvancedFilterState, an as toSimpleFilterState, bj as userConfigSchema, bL as validateAttribute, bo as validateAttributeConfig, bP as validateDraft, bQ as validateDraftOrThrow, bM as validateObject, bN as validateObjectOrThrow, cB as verifyNativeObjectsSync, d4 as verifyNativeViewsSync, b5 as viewRegistry } from './runtime-DUxWyRcq.js';
-import { IconName, CountryIso3, CurrencyCode, MimeType } from '@stndrds/constants';
+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--rp-TG-h.js';
+export { b7 as ActivityTab, cv 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, cu as CreateCustomObjectInput, d4 as CreateDBAttribute, di as CreateDBFlow, d0 as CreateDBObject, de as CreateDBView, a5 as CreateFile, cp as CreateFlowInput, d7 as CreateObjectRecord, aY as CreatePermissionInput, aW as CreateRoleInput, b1 as CreateUserProfile, cL as CreateViewInput, ag as CurrencyFilterValue, b6 as CustomTab, d3 as DBAttribute, dh as DBFlow, c$ as DBObject, dd as DBView, cW 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, dc as FileListOptions, co as FileService, 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, cr as FlowService, ay as FlowSlot, aB as FlowStatus, cj as FlowsRepository, b4 as FormTab, cU as FullSyncOptions, cT as FullSyncResult, aJ as GeocodingAdapter, aG as GeocodingAutocompleteParams, aI as GeocodingParams, cs as GeocodingService, aF as GeocodingSuggestion, cH as GetRelationOptionsParams, da as GlobalSearchOptions, db as GlobalSearchResultItem, ct as GlobalSearchService, c6 as HookContext, c7 as HookDefinition, c8 as HookHandler, cb as HookRegistry, c9 as HookType, d8 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, cy as ObjectSchemaService, cx as ObjectSchemaServiceOptions, cd as ObjectsRepository, dk as OperationResult, aR as Permission, aP as PermissionScope, cA as PermissionService, cz as PermissionServiceOptions, cl as PermissionsRepository, ah as PhoneFilterValue, at as QueryState, cC as RecordService, cB as RecordServiceOptions, Q as RelationAttribute, ad as RelationFilterOperator, cF as RelationOption, cG as RelationOptionsResponse, cI as RelationService, cE as RelationValidationError, cD as RelationValidationResult, af as RelativeDateValue, aH as ReverseGeocodingParams, aQ as Role, d9 as SearchOptions, ab as SelectFilterOperator, ar as SortDirection, as as SortRule, v as StatusGroup, a2 as StorageProvider, cP as SyncOptions, cO as SyncResult, aV as SystemPermissions, b3 as TabType, b5 as TableTab, bd as TenantId, a7 as TextFilterOperator, aL as Timestamps, d5 as UpdateDBAttribute, dj as UpdateDBFlow, d1 as UpdateDBObject, df as UpdateDBView, a6 as UpdateFile, cq as UpdateFlowInput, cw as UpdateObjectInput, aX as UpdateRoleInput, b2 as UpdateUserProfile, cM as UpdateViewInput, d6 as UpsertDBAttribute, d2 as UpsertDBObject, dg as UpsertDBView, b0 as UserProfile, cK as UserProfileService, cJ as UserProfileServiceOptions, cf as UserProfilesRepository, a_ as UserRole, aS as UserRoleAssignment, a$ as UserStatus, bc as Uuid, bW as ValidationResult, cN as ViewService, dm as ViewSyncOptions, dl 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, c_ as enrichValuesWithSelectLabels, cZ as extractAttributeNames, bu as fileConfigSchema, be as generateId, bf as generatePrefixedId, bz as getAttributeConfigSchema, c1 as getMissingRequiredAttributes, cS as getSyncPreview, dq as getViewSyncPreview, bb as isActivityTab, ao as isAdvancedFilterState, ba as isCustomTab, aC as isFlowDefinition, aD as isFlowPublished, b8 as isFormTab, cY 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, cX as renderLabelExpression, bC as safeParseAttributeConfig, bs as selectConfigSchema, bp as statusConfigSchema, cV as syncAll, cQ as syncNativeObjects, dn 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, cR as verifyNativeObjectsSync, dp as verifyNativeViewsSync, bh as viewRegistry } from './runtime--rp-TG-h.js';
+import { IconName, CountryIso3, CurrencyCode, MimeType, ColorId } from '@stndrds/constants';
 import 'zod';
 
 /**
@@ -300,6 +300,45 @@ type ExtractAttributes<TBuilder> = TBuilder extends {
     };
 } ? A : never;
 
+/**
+ * Default empty value placeholder
+ */
+declare const EMPTY_VALUE_PLACEHOLDER = "\u2014";
+/**
+ * Format an attribute value for display
+ *
+ * This function converts raw attribute values into human-readable strings
+ * based on the attribute type and configuration.
+ *
+ * @param value - The raw value to format
+ * @param attribute - The attribute definition
+ * @returns Formatted string representation
+ *
+ * @example
+ * ```typescript
+ * // Text attribute
+ * formatAttributeValue("Hello", textAttr);
+ * // → "Hello"
+ *
+ * // Currency attribute
+ * formatAttributeValue({ value: 1500, code: "EUR" }, currencyAttr);
+ * // → "1,500.00 EUR"
+ *
+ * // Select attribute with options
+ * formatAttributeValue("active", statusAttr);
+ * // → "Active" (label from options)
+ *
+ * // Location with city granularity
+ * formatAttributeValue({ city: "Paris", country: "FRA" }, locationAttr);
+ * // → "Paris, FRA"
+ *
+ * // Empty value
+ * formatAttributeValue(null, textAttr);
+ * // → "—"
+ * ```
+ */
+declare function formatAttributeValue(value: unknown, attribute: Attribute): string;
+
 /**
  * System resources that can be managed through permissions.
  */
@@ -917,6 +956,231 @@ type ExtractAttributeRequired<T> = T extends {
     };
 } ? R : false;
 
+/**
+ * Builder for creating flow rows with fields
+ */
+declare class FlowRowBuilder {
+    private pageBuilder;
+    private rowData;
+    /** @internal */
+    constructor(pageBuilder: FlowPageBuilder, id: string, order: number);
+    /**
+     * Add a field to the current row
+     *
+     * @param slotId - Reference to a slot defined with .slot()
+     * @param attribute - Attribute name on the object
+     * @param options - Optional field configuration
+     *
+     * @example
+     * ```typescript
+     * .row("row-1")
+     *   .field("mr", "firstName")
+     *   .field("mr", "lastName")
+     * ```
+     */
+    field(slotId: string, attribute: string, options?: {
+        label?: string;
+        required?: boolean;
+    }): this;
+    /**
+     * Start a new row on the same page
+     */
+    row(id: string): FlowRowBuilder;
+    /**
+     * Start a new page
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build the final flow definition
+     */
+    build(): FlowDefinition;
+}
+/**
+ * Builder for creating flow pages with rows
+ */
+declare class FlowPageBuilder {
+    private flow;
+    private pageData;
+    private rowOrder;
+    /** @internal */
+    constructor(flow: FlowBuilder, id: string, label: string, description?: string);
+    /**
+     * Add a row to the current page
+     *
+     * @param id - Unique row identifier
+     *
+     * @example
+     * ```typescript
+     * .page("identity", "Identité")
+     *   .row("name-row")
+     *     .field("mr", "firstName")
+     *     .field("mr", "lastName")
+     *   .row("email-row")
+     *     .field("mr", "email")
+     * ```
+     */
+    row(id: string): FlowRowBuilder;
+    /**
+     * Start a new page
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build the final flow definition
+     */
+    build(): FlowDefinition;
+    /** @internal */
+    _finalizeRow(row: FlowRow): this;
+    /** @internal */
+    _getFlow(): FlowBuilder;
+    /** @internal */
+    _getPageData(): FlowPage;
+}
+/**
+ * Fluent builder for creating FlowDefinition with validation
+ *
+ * @example
+ * ```typescript
+ * const COUPLE_FLOW = flow("couple-creation", "Création Couple")
+ *   .description("Create a couple with company")
+ *   .slot("mr", "contacts", "Monsieur", { color: "blue" })
+ *   .slot("mme", "contacts", "Madame", { color: "pink" })
+ *   .slot("company", "companies", "Entreprise", { color: "green" })
+ *   .relation("mr", "company", "company")
+ *   .relation("mme", "company", "company")
+ *   .page("identity", "Identité")
+ *     .row("mr-name")
+ *       .field("mr", "firstName")
+ *       .field("mr", "lastName")
+ *     .row("mme-name")
+ *       .field("mme", "firstName")
+ *       .field("mme", "lastName")
+ *   .page("company", "Entreprise")
+ *     .row("company-name")
+ *       .field("company", "name")
+ *     .row("company-siret")
+ *       .field("company", "siret")
+ *   .build();
+ * ```
+ */
+declare class FlowBuilder {
+    private data;
+    constructor(name: string, label: string);
+    /**
+     * Set flow description
+     */
+    description(value: string): this;
+    /**
+     * Set flow icon
+     */
+    icon(value: IconName): this;
+    /**
+     * Set extensible metadata
+     */
+    metadata(value: Record<string, unknown>): this;
+    /**
+     * Add a slot (object to create in the flow)
+     *
+     * @param id - Unique slot identifier (used to reference in fields and relations)
+     * @param objectName - Name of the object to create
+     * @param label - Display label for the slot
+     * @param options - Optional slot configuration
+     *
+     * @example
+     * ```typescript
+     * .slot("mr", "contacts", "Monsieur", { color: "blue", icon: "user" })
+     * .slot("company", "companies", "Entreprise", { color: "green" })
+     * ```
+     */
+    slot(id: string, objectName: string, label: string, options?: {
+        color?: ColorId;
+        icon?: IconName;
+    }): this;
+    /**
+     * Define a relation between two slots
+     * The source slot will be linked to the target slot via the specified attribute
+     *
+     * @param sourceSlotId - Slot that has the relation attribute
+     * @param sourceAttribute - Relation attribute name on the source
+     * @param targetSlotId - Target slot to link to
+     *
+     * @example
+     * ```typescript
+     * // mr.company → company (the contact's company field will be set to the created company)
+     * .relation("mr", "company", "company")
+     * ```
+     */
+    relation(sourceSlotId: string, sourceAttribute: string, targetSlotId: string): this;
+    /**
+     * Start a new page/step in the flow
+     *
+     * @param id - Unique page identifier
+     * @param label - Display label
+     * @param description - Optional description
+     *
+     * @example
+     * ```typescript
+     * .page("identity", "Identité", "Informations personnelles")
+     *   .row("name")
+     *     .field("mr", "firstName")
+     *     .field("mr", "lastName")
+     * ```
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build and validate the flow definition
+     *
+     * @throws Error if validation fails
+     */
+    build(): FlowDefinition;
+    /**
+     * Validate that required data is present
+     */
+    private validateRequiredData;
+    /**
+     * Validate that all field slotId references exist
+     */
+    private validateFieldReferences;
+    /**
+     * Validate that all relation references exist and are valid
+     */
+    private validateRelationReferences;
+    /**
+     * @internal Used by FlowPageBuilder to finalize a page
+     */
+    _finalizePage(page: FlowPage): this;
+    /**
+     * Validate flow name format (kebab-case)
+     */
+    private validateName;
+    /**
+     * Validate that there are no circular dependencies in relations
+     * Uses DFS to detect cycles in the dependency graph
+     */
+    private validateNoCircularDependencies;
+}
+/**
+ * Create a new flow builder
+ *
+ * @param name - Flow name (kebab-case)
+ * @param label - Display label
+ *
+ * @example
+ * ```typescript
+ * const COUPLE_FLOW = flow("couple-creation", "Création Couple")
+ *   .slot("mr", "contacts", "Monsieur")
+ *   .slot("mme", "contacts", "Madame")
+ *   .page("identity", "Identité")
+ *     .row("mr-name")
+ *       .field("mr", "firstName")
+ *       .field("mr", "lastName")
+ *     .row("mme-name")
+ *       .field("mme", "firstName")
+ *       .field("mme", "lastName")
+ *   .build();
+ * ```
+ */
+declare function flow(name: string, label: string): FlowBuilder;
+
 /**
  * Extract attribute info from a builder instance
  */
@@ -1397,4 +1661,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, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, 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, 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, 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 };