@flyos/design-system 1.5.0 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyos/design-system",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "FlyOS design system — shared components, directives, pipes, services, and models for Business App developers.",
   "keywords": [
     "flyos",

package/types/flyos-design-system.d.ts

@@ -1,13 +1,13 @@
 import * as _angular_core from '@angular/core';
 import { Type, InjectionToken, Signal, WritableSignal, OnInit, EventEmitter, OnChanges, OnDestroy, SimpleChanges, EnvironmentProviders, PipeTransform, signal, AfterViewInit, ElementRef, AfterViewChecked, ErrorHandler, Provider, TemplateRef } from '@angular/core';
 import * as rxjs from 'rxjs';
-import { Observable } from 'rxjs';
+import { Observable, MonoTypeOperatorFunction } from 'rxjs';
 import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
+import * as _angular_common_http from '@angular/common/http';
+import { HttpRequest, HttpHandlerFn, HttpErrorResponse } from '@angular/common/http';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 import * as _flyos_design_system from '@flyos/design-system';
 import { CanActivateFn, NavigationExtras } from '@angular/router';
-import * as _angular_common_http from '@angular/common/http';
-import { HttpRequest, HttpHandlerFn } from '@angular/common/http';
 
 /**
  * FlyOS architectural app category — see repo `docs/01-ecosystem-overview.md`.
@@ -1909,10 +1909,35 @@ declare class StandaloneWindowManagerService extends WindowManagerService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<StandaloneWindowManagerService>;
 }
 
+/**
+ * What a lazy route's loader resolves to. A bare component class, or a module
+ * namespace with a `default` export — the two shapes Angular's own
+ * `Route.loadComponent` accepts, so `() => import('./x')` and
+ * `() => import('./x').then(m => m.XComponent)` both work here.
+ */
+type FlyRemoteLoadedComponent = Type<unknown> | {
+    readonly default: Type<unknown>;
+};
+/** Fields every route row carries, whichever way its component is supplied. */
+interface FlyRemoteRouteCommon {
+    readonly path: string;
+    /** Opaque bag the consumer can read from `router.matchedRoute()?.route.data`. */
+    readonly data?: Readonly<Record<string, unknown>>;
+}
+/** A route whose component class is already in the bundle. */
+interface FlyRemoteEagerRoute extends FlyRemoteRouteCommon {
+    readonly component: Type<unknown>;
+    readonly loadComponent?: never;
+}
+/** A route whose component is fetched on first match, via a dynamic `import()`. */
+interface FlyRemoteLazyRoute extends FlyRemoteRouteCommon {
+    readonly component?: never;
+    readonly loadComponent: () => Promise<FlyRemoteLoadedComponent>;
+}
 /**
  * One row in a remote's route table. Mirrors Angular's `Route` interface but
- * pared down to what the FlyOS-embedded router actually supports — synchronous
- * component refs only (no `loadChildren`, no resolvers/guards).
+ * pared down to what the FlyOS-embedded router actually supports — no
+ * `loadChildren`, no resolvers, no guards.
  *
  * Patterns:
  *   ''                       — matches an empty URL ("/")
@@ -1920,13 +1945,22 @@ declare class StandaloneWindowManagerService extends WindowManagerService {
  *   'signals/:id'            — `:foo` captures any single segment into `params.foo`
  *   'signals/:id/edit'       — mixed static + capture segments
  *
- * `data` is an opaque bag the consumer can read from `router.matchedRoute()?.data`.
+ * Supply the component **either** eagerly or lazily — the union makes declaring
+ * both, or neither, a compile error rather than a silent runtime blank:
+ *
+ * ```ts
+ * { path: 'signals',     component: SignalsListComponent }                                  // eager
+ * { path: 'signals/:id', loadComponent: () => import('./detail').then(m => m.DetailComponent) } // lazy
+ * ```
+ *
+ * **Prefer `loadComponent` in a remote of any size.** A remote's route table is
+ * reachable from its exposed federation entry, so every `component:` reference
+ * in it is pulled into the chunk the shell downloads to mount the remote —
+ * before the user has navigated anywhere. An app with forty routes ships all
+ * forty components to render its landing page. `loadComponent` splits each into
+ * its own chunk, fetched on first match and then cached for the session.
  */
-interface FlyRemoteRoute {
-    readonly path: string;
-    readonly component: Type<unknown>;
-    readonly data?: Readonly<Record<string, unknown>>;
-}
+type FlyRemoteRoute = FlyRemoteEagerRoute | FlyRemoteLazyRoute;
 /**
  * Result of matching the current `segments` against a remote's route table.
  * `params` contains captured `:foo` segments — empty object for paths with no
@@ -2877,13 +2911,13 @@ declare function unloadRemoteStyles(appId: string): void;
  * ```
  *
  * Why both? Standalone keeps full Angular routing — query params, guards,
- * resolvers, lazy loading, RouterLink. Embedded gets a stripped-down
- * synchronous outlet that matches against the same route table the remote
- * declared via `FLY_REMOTE_ROUTES`. The same `router.navigate(['/foo', id])`
- * call works in both modes; only the rendering surface differs.
+ * resolvers, RouterLink. Embedded gets a stripped-down outlet that matches
+ * against the same route table the remote declared via `FLY_REMOTE_ROUTES`. The
+ * same `router.navigate(['/foo', id])` call works in both modes; only the
+ * rendering surface differs.
  *
  * Limitations vs. `<router-outlet>`:
- * - Synchronous components only (no `loadComponent` / `loadChildren`).
+ * - No `loadChildren` (route-level code splitting only — see `loadComponent`).
  * - No guards / resolvers / data resolution.
  * - No query-param / hash handling — only path segments.
  * - No `RouterLink` directive — use `(click)="router.navigate(...)"`.
@@ -2893,14 +2927,50 @@ declare function unloadRemoteStyles(appId: string): void;
  * private readonly router = inject(FlyRemoteRouter);
  * readonly id = computed(() => this.router.params()['id'] ?? '');
  * ```
+ *
+ * ## Lazy routes
+ *
+ * A route may supply `loadComponent: () => import('./x').then(m => m.XComponent)`
+ * instead of `component:`. The chunk is fetched on first match and cached for the
+ * lifetime of the outlet, so revisiting a route is synchronous.
+ *
+ * Three behaviours are deliberate, and each exists because the obvious
+ * alternative is worse:
+ *
+ * - **The previous component stays mounted while the next one loads.** Blanking
+ *   the outlet first would flash empty on every navigation, and a remote's chunks
+ *   are served from its own origin — usually a few milliseconds. This matches
+ *   Angular's Router, which does not tear down the current route until the next
+ *   one is ready.
+ * - **A stale resolution never wins.** Navigating A → B → C while B is still in
+ *   flight must not render B over C. Each resolution carries a sequence token and
+ *   is discarded unless it is still the latest.
+ * - **A failed load is reported to `ErrorHandler`, not swallowed.** The
+ *   chunk-404-after-redeploy self-heal (`provideFlyChunkReloadRecovery`) lives in
+ *   the root `ErrorHandler`, and a rejected promise inside an effect would reach
+ *   `unhandledrejection` instead — where that handler never sees it. Routing it
+ *   here is what lets a stale embedded remote recover. The failed loader is
+ *   evicted so a later attempt genuinely retries rather than reusing the
+ *   rejected promise.
  */
 declare class FlyRemoteRouterOutletComponent {
     private readonly router;
+    private readonly errorHandler;
     /**
      * Read directly from FlyRemoteRouter so the outlet re-renders whenever the
      * URL changes (signal-based, OnPush-friendly).
      */
     readonly matched: _angular_core.Signal<_flyos_design_system.FlyRemoteMatch | null>;
+    /** Loaders that have resolved — consulted synchronously, so a revisit never flashes. */
+    private readonly loaded;
+    /** Loaders currently in flight, so a param change mid-load doesn't start a second fetch. */
+    private readonly inFlight;
+    /** Bumped per resolution attempt; a late `.then` compares against it and bows out. */
+    private seq;
+    private readonly component;
+    /** The component class currently projected into `*ngComponentOutlet`. */
+    readonly rendered: _angular_core.Signal<Type<unknown> | null>;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FlyRemoteRouterOutletComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FlyRemoteRouterOutletComponent, "fly-remote-router-outlet", never, {}, {}, never, never, true, never>;
 }
@@ -7169,7 +7239,7 @@ type FlySecureSrcState = 'idle' | 'loading' | 'ready' | 'error';
  * few seconds of its life; the Files Manager download endpoint answers
  * `423 Locked` / `SCAN_PENDING` (with an advisory `Retry-After` header) until
  * the scan clears. Rather than treating that like a permission error, the
- * directive retries the fetch — up to {@link SCAN_PENDING_MAX_RETRIES} times,
+ * directive retries the fetch — up to {@link FLY_SCAN_PENDING_MAX_RETRIES} times,
  * honoring `Retry-After` when present (falling back to a flat 2s) — and swaps
  * in the image automatically once the scan reports Clean. This mirrors the
  * hand-rolled `retry({ count: 6, delay: … })` policy already used by the
@@ -8570,6 +8640,176 @@ declare function flyDownloadBlob(blob: Blob, fileName: string, mimeFallback?: st
  */
 declare function flyExportFileName(contentDisposition: string | null | undefined, fallback: string): string;
 
+/**
+ * Downloads a Files-Manager file through the authenticated `HttpClient` and hands it to the
+ * browser's save dialog.
+ *
+ * **Why this exists rather than an `<a href>`.** `/api/files/{id}/download` is bearer-gated and
+ * Files-Manager exposes no signed or public URL, so a browser-native navigation carries no
+ * `Authorization` header and answers **401**. That is not a hypothetical: three Circles templates
+ * shipped plain `<a href>` download links that were simply broken, Thoughts hit the same 401 on
+ * its story attachments, and in both apps other screens had already hand-rolled the correct blob
+ * fetch inline. The design system shipped the *save* half (`flyDownloadBlob`) and the image-side
+ * *fetch* half (`img[flySecureSrc]`) but nothing for a plain authenticated download, so every app
+ * rediscovered the same 401 and wrote the same fix.
+ *
+ * It also rides out the `423 SCAN_PENDING` window via {@link flyScanRetry}: a freshly-produced
+ * export or upload is still being virus-scanned for the first seconds of its life, which is
+ * exactly when a user clicks.
+ *
+ * @example
+ * private readonly downloads = inject(FlyFileDownloadService);
+ * this.downloads.download(attachment.fileId, attachment.fileName);
+ */
+declare class FlyFileDownloadService {
+    private readonly http;
+    /**
+     * Fetches a file and saves it, subscribing internally — the fire-and-forget form for a click
+     * handler that has no state to drive.
+     *
+     * Errors are left to the app's global `HttpClient` error handling. Use {@link fetch} instead
+     * when the caller needs to show a spinner or a per-row failure state.
+     *
+     * @param fileIdOrUrl A bare Files-Manager file id, or a path starting with `/` used verbatim.
+     * @param fileName    Name offered to the OS save dialog, extension included.
+     */
+    download(fileIdOrUrl: string, fileName: string): void;
+    /**
+     * The observable form: emits the blob after saving it, so a caller can drive its own loading
+     * and error state. The save happens on emission — subscribing is what triggers the download.
+     *
+     * @param fileIdOrUrl A bare Files-Manager file id, or a path starting with `/` used verbatim.
+     * @param fileName    Name offered to the OS save dialog, extension included.
+     */
+    fetch(fileIdOrUrl: string, fileName: string): Observable<Blob>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FlyFileDownloadService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<FlyFileDownloadService>;
+}
+
+/**
+ * Files-Manager answers a fresh (still-scanning) upload with `423 Locked` / `SCAN_PENDING` until
+ * the background virus scan clears it.
+ */
+declare const FLY_SCAN_PENDING_STATUS = 423;
+/**
+ * Retry budget. The scan usually clears within a few seconds, so six attempts comfortably covers
+ * the common case without hammering the endpoint indefinitely on a stuck scan.
+ */
+declare const FLY_SCAN_PENDING_MAX_RETRIES = 6;
+/** Fallback delay when the response carries no (or an unparsable) `Retry-After` header. */
+declare const FLY_SCAN_PENDING_DEFAULT_DELAY_MS = 2000;
+/**
+ * Resolves a `423 Locked` / `SCAN_PENDING` error's `Retry-After` header to a delay in
+ * milliseconds. The header is advisory and, per RFC 9110, either a number of seconds or an
+ * HTTP-date — both are handled. Falls back to {@link FLY_SCAN_PENDING_DEFAULT_DELAY_MS} when the
+ * header is missing, unparsable, or already in the past.
+ */
+declare function flyScanPendingDelayMs(err: HttpErrorResponse): number;
+/**
+ * Rides out the `423 SCAN_PENDING` window on any authenticated Files-Manager request.
+ *
+ * A file is not readable for the first seconds of its life — Files-Manager holds it at `423` until
+ * the virus scan clears. Without this, the first read after an upload or an export completes just
+ * fails, which is exactly when a user is most likely to click.
+ *
+ * **This honours `Retry-After`.** Every hand-rolled copy of this policy across the platform used a
+ * flat `timer(2000)`, which is both slower than necessary when the server says "200ms" and a
+ * hammer when it says "30s". The header is advisory, so the flat fallback remains for responses
+ * that omit it.
+ *
+ * Only `423` is retried. A terminal outcome — `403 SCAN_INFECTED`, `422 SCAN_FAILED`, `401`, or
+ * anything else — re-throws immediately: the `delay` notifier erroring stops `retry` at once
+ * rather than waiting out the budget.
+ *
+ * @example
+ * this.http.get(url, { responseType: 'blob' }).pipe(flyScanRetry())
+ */
+declare function flyScanRetry<T>(options?: {
+    readonly count?: number;
+}): MonoTypeOperatorFunction<T>;
+
+/**
+ * The `ApiResponse<T>` envelope every FlyOS endpoint returns, as it serializes over the wire
+ * (the backend's `Success` is camel-cased to `success` in production JSON).
+ *
+ * `errors` is the business-rule failure list some endpoints return instead of a single `error`;
+ * both shapes are live, which is why {@link flyApiErrorMessage} probes for both.
+ */
+interface FlyApiResponse<T = void> {
+    success: boolean;
+    data?: T;
+    error?: FlyApiError;
+    errors?: string[];
+    meta?: FlyPageMeta;
+}
+/** The structured error an endpoint returns alongside `success: false`. */
+interface FlyApiError {
+    code: string;
+    message: string;
+}
+/** Paging counters an endpoint may return in `meta` rather than inside the payload. */
+interface FlyPageMeta {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+}
+/** A paged payload as the backend `PagedResult<T>` serializes it. */
+interface FlyPaged<T> {
+    items: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/**
+ * A page of results normalized for the UI. Deliberately narrower than {@link FlyPaged}: a list
+ * component needs the rows and the total, and carrying `page`/`pageSize` back out invites a
+ * component to trust the server's echo of a request parameter it already owns.
+ */
+interface FlyPageResult<T> {
+    items: T[];
+    total: number;
+}
+/**
+ * Unwraps `FlyApiResponse<T>` to its payload, or `null` when the call did not succeed.
+ *
+ * This is the STRICT reading: `success: false` yields `null` even if a partial `data` came with
+ * it. Prefer it. Use {@link flyUnwrapLenient} only against an endpoint that is known to answer
+ * unwrapped.
+ */
+declare function flyUnwrap<T>(res: FlyApiResponse<T>): T | null;
+/**
+ * Unwraps `FlyApiResponse<T>`, tolerating an endpoint that answered UNWRAPPED — i.e. returned the
+ * payload as the whole body with no envelope around it.
+ *
+ * **This is a workaround for a backend that is inconsistent, not a preference.** Every endpoint is
+ * supposed to wrap its payload; a handful do not, and call sites carried a defensive
+ * `res.data ?? res` for them. That expression forced the surrounding chain to `any`, which
+ * silenced the mismatch rather than naming it. This keeps the identical runtime behaviour while
+ * staying typed — but a call site reaching for it is evidence of an endpoint worth fixing, and it
+ * cannot distinguish "unwrapped payload" from "envelope with `success: false`".
+ */
+declare function flyUnwrapLenient<T>(res: FlyApiResponse<T>): T;
+/**
+ * Normalizes the `FlyApiResponse<FlyPaged<T>>` envelope to the flat `{ items, total }` a list UI
+ * reads. An absent `total` falls back to the row count, so a server that omits it still renders a
+ * correct count for the page in hand rather than `0`.
+ */
+declare function flyToPage<T>(res: FlyApiResponse<FlyPaged<T>>): FlyPageResult<T>;
+/**
+ * Best-effort extraction of the message (usually an i18n key) out of an
+ * `HttpErrorResponse.error` body returned by a FlyOS endpoint.
+ *
+ * The wire format is inconsistent by design: business-rule failures arrive as `{ errors: [key] }`,
+ * the structured envelope as `{ error: { code, message } }`, framework failures as `{ message }`,
+ * and some proxies hand back a bare string. Call sites used to inline this probe behind
+ * `err?.error as any`, typing the whole chain as `any` and duplicating the logic verbatim.
+ *
+ * @returns the first `errors[]` entry, else `error.message`, else `message`, else the raw string
+ *          body — or `undefined` when none of those is present.
+ */
+declare function flyApiErrorMessage(err: unknown): string | undefined;
+
 /**
  * Shared presence-colour utility — one deterministic seed → colour mapping so
  * every co-authoring surface (mind-maps, canvas-boards, and future Documents/
@@ -10496,6 +10736,6 @@ declare const AUDIENCE_ERROR_CODES: {
 };
 type AudienceErrorCode = (typeof AUDIENCE_ERROR_CODES)[keyof typeof AUDIENCE_ERROR_CODES];
 
-export { AGENT_DRAG_MIME, AGENT_PAYLOAD_VERSION, APP_LOOKUP, AUDIENCE_ERROR_CODES, AUDIENCE_LIMITS, AUDIENCE_PRESETS, AUDIENCE_TERM_KINDS, AgentActionBus, AgentActionUnsupportedDispatchError, AgentCommandRegistry, AgentDropRegistry, AgentFlightAnimator, AgentLookupRegistry, AgentPayloadOversizeError, AudienceBuilderComponent, AuthService, BilingualFieldComponent, CRON_MODES, CRON_WEEKDAYS, ContextMenuComponent, DEFAULT_AGENT_PAYLOAD_LIMITS, DEFAULT_FLY_THEME_MODE, DS_BASELINE_LOCALES, DashboardKpiComponent, DialogResult, EntityLookupComponent, FLYOS_LAUNCH_EVENT, FLYOS_LAUNCH_REQUEST_EVENT, FLYOS_REMOTE_ROUTE_EVENT, FLY_ACCENT_PROPERTY, FLY_ADMIN_ROLES, FLY_CHUNK_RELOAD_FLAG, FLY_COMPACT_THRESHOLD, FLY_COUNTRIES, FLY_EMOJI_BY_ID, FLY_EMOJI_CATEGORIES, FLY_EMOJI_CATEGORY_BY_ID, FLY_EMOJI_DEFAULT_CATEGORIES, FLY_EMOJI_PACK, FLY_EMOJI_PACK_MISSING_MESSAGE, FLY_EMOJI_PREVIEW_COUNT, FLY_EMPTY_VALUE, FLY_LOCALE_CATALOG, FLY_NF_CACHE_HEAL_FLAG, FLY_RELOAD_DEBOUNCE_MS, FLY_RELOAD_REARM_MS, FLY_REMOTE_BASE_PATH, FLY_REMOTE_CONTEXT_EVENT, FLY_REMOTE_CONTEXT_STORE_KEY, FLY_REMOTE_ROUTES, FLY_SEARCH_DEBOUNCE_MS, FLY_SKIN_TONES, FLY_STANDALONE_AUTH_CONFIG, FLY_THEME_MODE_IDS, FLY_WINDOW_HELP_HINT_EVENT, FLY_WINDOW_PAGE_TITLE_EVENT, FlyAchievementProgressComponent, FlyActionMenuComponent, FlyActionStackComponent, FlyAgentDraggableDirective, FlyAnimatedEmojiComponent, FlyAppHomeComponent, FlyAppTopbarComponent, FlyAuthLiveRefresh, FlyBadgeWallComponent, FlyBlockUiComponent, FlyBreadcrumbComponent, FlyButtonComponent, FlyBytesPipe, FlyCaptchaComponent, FlyCardActionsComponent, FlyCardBodyComponent, FlyCardComponent, FlyCardFooterComponent, FlyCardGridComponent, FlyCardMediaComponent, FlyCardMetaComponent, FlyCardStatusComponent, FlyCardTitleComponent, FlyCellDirective, FlyCheckboxComponent, FlyChipComponent, FlyChunkReloadErrorHandler, FlyClickOutsideDirective, FlyCollapsibleComponent, FlyCommentThreadComponent, FlyCompactNumberPipe, FlyConfirmDialogComponent, FlyControlDirective, FlyCronBuilderComponent, FlyDataTableComponent, FlyDatePipe, FlyDateTimePipe, FlyDebouncer, FlyDecimalNumberPipe, FlyDetailCardComponent, FlyDetailShellComponent, FlyDrawerComponent, FlyDurationPipe, FlyDynamicFormComponent, FlyEmojiPickerComponent, FlyFieldComponent, FlyFileUploadComponent, FlyFilterPanelComponent, FlyFormBannerComponent, FlyFormFooterComponent, FlyFormGridComponent, FlyFormSectionComponent, FlyFullNumberPipe, FlyGanttComponent, FlyHubClient, FlyIconButtonComponent, FlyIfAdminDirective, FlyIfRoleDirective, FlyImageUploadComponent, FlyLeaderboardComponent, FlyMetaListComponent, FlyModalComponent, FlyModerationQueueComponent, FlyModuleIconDirective, FlyPaginationComponent, FlyPeoplePickerComponent, FlyPointsTierComponent, FlyProgressComponent, FlyRelativeTimePipe, FlyRemoteContextService, FlyRemoteRouter, FlyRemoteRouterOutletComponent, FlySearchInputComponent, FlySectionHeaderComponent, FlySecureSrcDirective, FlySegmentedComponent, FlySelectComponent, FlySkeletonComponent, FlySliderComponent, FlySparklineComponent, FlySpinnerComponent, FlyStandaloneAuthCallbackComponent, FlyStandaloneAuthService, FlyStateMessageComponent, FlyDynamicFormComponent as FlySurveyFormComponent, FlyTabComponent, FlyTabsComponent, FlyTagsInputComponent, FlyThemeService, FlyTimePipe, FlyToastService, FlyToggleComponent, FlyTooltipDirective, FlyTreeNavComponent, FlyTypeaheadComponent, FlyUserDirectoryService, FlyWindowHelpService, FlyWindowTitleService, FlyosPendingLaunchesGlobalKey, FlyosShellHandlesLaunchRequestsGlobalKey, FlyosShellOwnsHistoryGlobalKey, GANTT_ZOOMS, I18nService, LAUNCH_CONTEXT, MessageBoxButtons, MessageBoxComponent, MessageBoxIcon, MessageBoxService, MockAuthService, OverlayStack, PRESENCE_COLORS, PageHeaderComponent, RTL_LOCALE_SET, SHARE_ORG_CHART_SYSTEM_KEY_APPS, SHARE_ORG_CHART_SYSTEM_KEY_DEFAULT, SHARE_PANEL_DEFAULT_FILE_LEVELS, STATE_DEFAULT_ICONS, STATE_DEFAULT_MESSAGE_KEYS, STEP_UP_CODE, STEP_UP_REAUTH_HANDLER, STEP_UP_RETURN_KEY, SUPPORTED_AGENT_PAYLOAD_VERSIONS, SharePanelComponent, SourceAppResolver, StandaloneWindowManagerService, StatusBadgeComponent, StepUpService, ToastHostComponent, TranslatePipe, WINDOW_DATA, WINDOW_HELP_HINT, WindowManagerService, applySkinTone, applySuggestion, ariaSort, buildCron, canConfirm, canGoNext, canGoPrev, captureFocus, clampPage, clampSliderValue, connectRemoteLaunch, enterActivatesNatively, filterGroup, filterSuggestions, findLocaleByDialect, findLocaleByPrefix, firstEnabledIndex, firstModuleIndex, flattenModules, flyAdminGuard, flyCaptchaBase64Utf8, flyCaptchaBuildToken, flyCaptchaSha256Hex, flyCompactNumber, flyDebounced, flyDecimalNumber, flyDownloadBlob, flyDuration, flyEmojiFor, flyEmojiIsTonable, flyEmojiPackUrl, flyExportFileName, flyFirstEnabledIndex, flyFormatBytes, flyFormatDate, flyFormatDateTime, flyFormatTime, flyFullNumber, flyNextEnabledIndex, flyNextSegmentIndex, flyRelativeTime, flyResolveActiveTab, flyRoleGuard, flySignedCompact, flySkinToneLabelKey, flyStandaloneAuthGuard, flyStandaloneAuthInterceptor, flyToDateOnly, hasAnyRoleIn, healNativeFederationCacheOnce, initialExpanded, isAccentColor, isChunkLoadError, isFlyAuthStorePopulated, isNativeFederationCacheError, isRtlLocale, isRtlLocaleEntry, isValidCron, isValidSingleField, loadRemoteStyles, matchFlyRoutePattern, nextEnabledIndex, nextModuleIndex, nextSegmentIndex, nextSort, normalizeFlyTheme, normalizeRoles, overlayStack, parseCron, parseStepUpChallenge, parseTags, presenceColorFor, printConsoleSecurityWarning, provideFlyChunkReloadRecovery, provideFlyEmojiPack, provideFlyStandaloneAuth, reloadOnceForChunkError, requestAppLaunch, resolveActiveModule, resolveActiveSection, resolveActiveTab, resolveCellValue, resolveStateIcon, resolveStateMessageKey, restoreFocus, sameTags, sectionHintKey, sectionLayout, sliderTrackGradient, sparklinePath, sparklinePoints, stepUpInterceptor, stepUpReturnKey, trimAgentPayload, trimAgentString, unloadRemoteStyles, utf8ByteLength, validateAgentPayload, warnIfEmbeddedSessionMissing };
-export type { ActionMenuItem, AgentAction, AgentActionDispatch, AgentActionVerb, AgentChipHostInputs, AgentCommand, AgentCommandContextBinding, AgentCommandHandle, AgentCommandRegistration, AgentCommandScope, AgentCommandSlashSpec, AgentDragPayload, AgentDraggableItem, AgentDropChipMode, AgentDropRendererRegistration, AgentEnvelopeAttachment, AgentMcpScope, AgentMessageEnvelope, AgentPayloadLimits, AgentPayloadValidationResult, AppEveryonePrincipal, AppEveryoneTerm, AppLookup, AppLookupEntry, AudienceEditTarget, AudienceErrorCode, AudienceFilter, AudienceOptions, AudiencePresetKind, AudienceTerm, AudienceTermKind, BreadcrumbItem, ButtonSize, ButtonVariant, CardLayout, ChartTerm, ChildWindowData, ChipTone, ConfirmKind, ConnectRemoteLaunchOptions, ContextMenuAlign, ContextMenuItem, ContextMenuSection, CronAdvancedFieldDef, CronMode, CronParts, CronWeekday, DesktopApp, DesktopAppCategory, DesktopAppKind, DetailSection, DialogResultWithAcknowledgement, EmbeddedSessionProbe, EntityLinkSelection, FilterGroup, FlyAchievementRow, FlyAppHomeLayout, FlyAppModule, FlyAppModuleSection, FlyAuthRefreshPayload, FlyAuthStoreReadable, FlyBadgeTile, FlyBreadcrumbItem, FlyCaptchaChallenge, FlyCaptchaSolution, FlyCaptchaState, FlyCellContext, FlyColumn, FlyColumnKind, FlyComment, FlyCommentDeleteRequest, FlyCommentEditRequest, FlyCommentLoadMoreRequest, FlyCommentLoadRepliesRequest, FlyCommentLockToggleRequest, FlyCommentPage, FlyCommentReportReason, FlyCommentReportRequest, FlyCommentReportStatus, FlyCommentSubmitRequest, FlyCountry, FlyDrawerSide, FlyDrawerSize, FlyEmojiCategory, FlyEmojiCell, FlyEmojiEntry, FlyEmojiPack, FlyEmojiPackEntry, FlyEmojiPackManifest, FlyEmojiPickerSize, FlyEmojiPickerTab, FlyEmojiSection, FlyFileInfo, FlyFileSelection, FlyFormAnswer, FlyFormAnswerValue, FlyFormDefinition, FlyFormFieldOptions, FlyFormOption, FlyFormQuestion, FlyFormQuestionType, FlyFormScoreDisplay, FlyLaunchEventDetail, FlyLaunchRequestDetail, FlyLeaderboardRow, FlyLiveRefreshOptions, FlyLocaleEntry, FlyMetaItem, FlyModerationLoadPageRequest, FlyModerationLockThreadRequest, FlyModerationOpenSubjectRequest, FlyModerationReport, FlyModerationReportPage, FlyModerationResolutionStatus, FlyModerationResolveRequest, FlyNavigableItem, FlyPeoplePickerMode, FlyPeoplePickerOption, FlyPeopleSearchFn, FlyPointsSummary, FlyRemoteContext, FlyRemoteMatch, FlyRemoteRoute, FlyRemoteRouteEventDetail, FlySearchExpandTrigger, FlySearchInputSize, FlySecureSrcState, FlySelectOption, FlySelectValue, FlySkeletonAnimation, FlySkeletonLayout, FlySkeletonShape, FlySkinTone, FlySort, FlyStandaloneAuthConfig, FlyFileSelection as FlySurveyFileSelection, FlyFormAnswer as FlySurveyFormAnswer, FlyFormAnswerValue as FlySurveyFormAnswerValue, FlyFormDefinition as FlySurveyFormDefinition, FlyFormFieldOptions as FlySurveyFormFieldOptions, FlyFormOption as FlySurveyFormOption, FlyFormQuestion as FlySurveyFormQuestion, FlyFormQuestionType as FlySurveyQuestionType, FlyThemeMode, FlyTooltipPlacement, FlyTreeNavNode, FlyTypeaheadOption, FlyWindowHelpHintEventDetail, FlyWindowHelpPublisher, FlyWindowPageTitleEventDetail, FlyWindowTitlePublisher, FlyosPendingLaunches, FocusRestore, FormBannerKind, GanttDependency, GanttDependencyCreate, GanttRow, GanttRowDatesChange, GanttRowKind, GanttZoom, IconButtonVariant, LaunchContext, LoadBundleOptions, LookupDescriptor, LookupHandle, LookupRegistration, LookupResult, LookupSearch, MessageBoxButton, MessageBoxDontAskAgainConfig, MessageBoxOptions, MessageBoxOptionsWithAcknowledgement, MockAuthConfig, OpenWindowOptions, OuPrincipal, OuTerm, OverlayHandle, PageHeaderVariant, PresetTerm, ProgressTone, RemoteAppDef, RequestAppLaunchOptions, RoleOuLookupRow, RolePrincipal, RolesTerm, SegmentedOption, ShareOrgChartOption, ShareOuNode, SharePanelLevelOption, SharePermissionEntry, SharePrincipal, SharePrincipalKind, ShareUserResult, StateMessageKind, StepUpChallenge, StepUpReauthHandler, StepUpReauthRequest, ToastAction, ToastEntry, ToastOptions, ToastVariant, User, UserPrincipal, UsersTerm, WindowHelpHint, WindowInstance, WindowState };
+export { AGENT_DRAG_MIME, AGENT_PAYLOAD_VERSION, APP_LOOKUP, AUDIENCE_ERROR_CODES, AUDIENCE_LIMITS, AUDIENCE_PRESETS, AUDIENCE_TERM_KINDS, AgentActionBus, AgentActionUnsupportedDispatchError, AgentCommandRegistry, AgentDropRegistry, AgentFlightAnimator, AgentLookupRegistry, AgentPayloadOversizeError, AudienceBuilderComponent, AuthService, BilingualFieldComponent, CRON_MODES, CRON_WEEKDAYS, ContextMenuComponent, DEFAULT_AGENT_PAYLOAD_LIMITS, DEFAULT_FLY_THEME_MODE, DS_BASELINE_LOCALES, DashboardKpiComponent, DialogResult, EntityLookupComponent, FLYOS_LAUNCH_EVENT, FLYOS_LAUNCH_REQUEST_EVENT, FLYOS_REMOTE_ROUTE_EVENT, FLY_ACCENT_PROPERTY, FLY_ADMIN_ROLES, FLY_CHUNK_RELOAD_FLAG, FLY_COMPACT_THRESHOLD, FLY_COUNTRIES, FLY_EMOJI_BY_ID, FLY_EMOJI_CATEGORIES, FLY_EMOJI_CATEGORY_BY_ID, FLY_EMOJI_DEFAULT_CATEGORIES, FLY_EMOJI_PACK, FLY_EMOJI_PACK_MISSING_MESSAGE, FLY_EMOJI_PREVIEW_COUNT, FLY_EMPTY_VALUE, FLY_LOCALE_CATALOG, FLY_NF_CACHE_HEAL_FLAG, FLY_RELOAD_DEBOUNCE_MS, FLY_RELOAD_REARM_MS, FLY_REMOTE_BASE_PATH, FLY_REMOTE_CONTEXT_EVENT, FLY_REMOTE_CONTEXT_STORE_KEY, FLY_REMOTE_ROUTES, FLY_SCAN_PENDING_DEFAULT_DELAY_MS, FLY_SCAN_PENDING_MAX_RETRIES, FLY_SCAN_PENDING_STATUS, FLY_SEARCH_DEBOUNCE_MS, FLY_SKIN_TONES, FLY_STANDALONE_AUTH_CONFIG, FLY_THEME_MODE_IDS, FLY_WINDOW_HELP_HINT_EVENT, FLY_WINDOW_PAGE_TITLE_EVENT, FlyAchievementProgressComponent, FlyActionMenuComponent, FlyActionStackComponent, FlyAgentDraggableDirective, FlyAnimatedEmojiComponent, FlyAppHomeComponent, FlyAppTopbarComponent, FlyAuthLiveRefresh, FlyBadgeWallComponent, FlyBlockUiComponent, FlyBreadcrumbComponent, FlyButtonComponent, FlyBytesPipe, FlyCaptchaComponent, FlyCardActionsComponent, FlyCardBodyComponent, FlyCardComponent, FlyCardFooterComponent, FlyCardGridComponent, FlyCardMediaComponent, FlyCardMetaComponent, FlyCardStatusComponent, FlyCardTitleComponent, FlyCellDirective, FlyCheckboxComponent, FlyChipComponent, FlyChunkReloadErrorHandler, FlyClickOutsideDirective, FlyCollapsibleComponent, FlyCommentThreadComponent, FlyCompactNumberPipe, FlyConfirmDialogComponent, FlyControlDirective, FlyCronBuilderComponent, FlyDataTableComponent, FlyDatePipe, FlyDateTimePipe, FlyDebouncer, FlyDecimalNumberPipe, FlyDetailCardComponent, FlyDetailShellComponent, FlyDrawerComponent, FlyDurationPipe, FlyDynamicFormComponent, FlyEmojiPickerComponent, FlyFieldComponent, FlyFileDownloadService, FlyFileUploadComponent, FlyFilterPanelComponent, FlyFormBannerComponent, FlyFormFooterComponent, FlyFormGridComponent, FlyFormSectionComponent, FlyFullNumberPipe, FlyGanttComponent, FlyHubClient, FlyIconButtonComponent, FlyIfAdminDirective, FlyIfRoleDirective, FlyImageUploadComponent, FlyLeaderboardComponent, FlyMetaListComponent, FlyModalComponent, FlyModerationQueueComponent, FlyModuleIconDirective, FlyPaginationComponent, FlyPeoplePickerComponent, FlyPointsTierComponent, FlyProgressComponent, FlyRelativeTimePipe, FlyRemoteContextService, FlyRemoteRouter, FlyRemoteRouterOutletComponent, FlySearchInputComponent, FlySectionHeaderComponent, FlySecureSrcDirective, FlySegmentedComponent, FlySelectComponent, FlySkeletonComponent, FlySliderComponent, FlySparklineComponent, FlySpinnerComponent, FlyStandaloneAuthCallbackComponent, FlyStandaloneAuthService, FlyStateMessageComponent, FlyDynamicFormComponent as FlySurveyFormComponent, FlyTabComponent, FlyTabsComponent, FlyTagsInputComponent, FlyThemeService, FlyTimePipe, FlyToastService, FlyToggleComponent, FlyTooltipDirective, FlyTreeNavComponent, FlyTypeaheadComponent, FlyUserDirectoryService, FlyWindowHelpService, FlyWindowTitleService, FlyosPendingLaunchesGlobalKey, FlyosShellHandlesLaunchRequestsGlobalKey, FlyosShellOwnsHistoryGlobalKey, GANTT_ZOOMS, I18nService, LAUNCH_CONTEXT, MessageBoxButtons, MessageBoxComponent, MessageBoxIcon, MessageBoxService, MockAuthService, OverlayStack, PRESENCE_COLORS, PageHeaderComponent, RTL_LOCALE_SET, SHARE_ORG_CHART_SYSTEM_KEY_APPS, SHARE_ORG_CHART_SYSTEM_KEY_DEFAULT, SHARE_PANEL_DEFAULT_FILE_LEVELS, STATE_DEFAULT_ICONS, STATE_DEFAULT_MESSAGE_KEYS, STEP_UP_CODE, STEP_UP_REAUTH_HANDLER, STEP_UP_RETURN_KEY, SUPPORTED_AGENT_PAYLOAD_VERSIONS, SharePanelComponent, SourceAppResolver, StandaloneWindowManagerService, StatusBadgeComponent, StepUpService, ToastHostComponent, TranslatePipe, WINDOW_DATA, WINDOW_HELP_HINT, WindowManagerService, applySkinTone, applySuggestion, ariaSort, buildCron, canConfirm, canGoNext, canGoPrev, captureFocus, clampPage, clampSliderValue, connectRemoteLaunch, enterActivatesNatively, filterGroup, filterSuggestions, findLocaleByDialect, findLocaleByPrefix, firstEnabledIndex, firstModuleIndex, flattenModules, flyAdminGuard, flyApiErrorMessage, flyCaptchaBase64Utf8, flyCaptchaBuildToken, flyCaptchaSha256Hex, flyCompactNumber, flyDebounced, flyDecimalNumber, flyDownloadBlob, flyDuration, flyEmojiFor, flyEmojiIsTonable, flyEmojiPackUrl, flyExportFileName, flyFirstEnabledIndex, flyFormatBytes, flyFormatDate, flyFormatDateTime, flyFormatTime, flyFullNumber, flyNextEnabledIndex, flyNextSegmentIndex, flyRelativeTime, flyResolveActiveTab, flyRoleGuard, flyScanPendingDelayMs, flyScanRetry, flySignedCompact, flySkinToneLabelKey, flyStandaloneAuthGuard, flyStandaloneAuthInterceptor, flyToDateOnly, flyToPage, flyUnwrap, flyUnwrapLenient, hasAnyRoleIn, healNativeFederationCacheOnce, initialExpanded, isAccentColor, isChunkLoadError, isFlyAuthStorePopulated, isNativeFederationCacheError, isRtlLocale, isRtlLocaleEntry, isValidCron, isValidSingleField, loadRemoteStyles, matchFlyRoutePattern, nextEnabledIndex, nextModuleIndex, nextSegmentIndex, nextSort, normalizeFlyTheme, normalizeRoles, overlayStack, parseCron, parseStepUpChallenge, parseTags, presenceColorFor, printConsoleSecurityWarning, provideFlyChunkReloadRecovery, provideFlyEmojiPack, provideFlyStandaloneAuth, reloadOnceForChunkError, requestAppLaunch, resolveActiveModule, resolveActiveSection, resolveActiveTab, resolveCellValue, resolveStateIcon, resolveStateMessageKey, restoreFocus, sameTags, sectionHintKey, sectionLayout, sliderTrackGradient, sparklinePath, sparklinePoints, stepUpInterceptor, stepUpReturnKey, trimAgentPayload, trimAgentString, unloadRemoteStyles, utf8ByteLength, validateAgentPayload, warnIfEmbeddedSessionMissing };
+export type { ActionMenuItem, AgentAction, AgentActionDispatch, AgentActionVerb, AgentChipHostInputs, AgentCommand, AgentCommandContextBinding, AgentCommandHandle, AgentCommandRegistration, AgentCommandScope, AgentCommandSlashSpec, AgentDragPayload, AgentDraggableItem, AgentDropChipMode, AgentDropRendererRegistration, AgentEnvelopeAttachment, AgentMcpScope, AgentMessageEnvelope, AgentPayloadLimits, AgentPayloadValidationResult, AppEveryonePrincipal, AppEveryoneTerm, AppLookup, AppLookupEntry, AudienceEditTarget, AudienceErrorCode, AudienceFilter, AudienceOptions, AudiencePresetKind, AudienceTerm, AudienceTermKind, BreadcrumbItem, ButtonSize, ButtonVariant, CardLayout, ChartTerm, ChildWindowData, ChipTone, ConfirmKind, ConnectRemoteLaunchOptions, ContextMenuAlign, ContextMenuItem, ContextMenuSection, CronAdvancedFieldDef, CronMode, CronParts, CronWeekday, DesktopApp, DesktopAppCategory, DesktopAppKind, DetailSection, DialogResultWithAcknowledgement, EmbeddedSessionProbe, EntityLinkSelection, FilterGroup, FlyAchievementRow, FlyApiError, FlyApiResponse, FlyAppHomeLayout, FlyAppModule, FlyAppModuleSection, FlyAuthRefreshPayload, FlyAuthStoreReadable, FlyBadgeTile, FlyBreadcrumbItem, FlyCaptchaChallenge, FlyCaptchaSolution, FlyCaptchaState, FlyCellContext, FlyColumn, FlyColumnKind, FlyComment, FlyCommentDeleteRequest, FlyCommentEditRequest, FlyCommentLoadMoreRequest, FlyCommentLoadRepliesRequest, FlyCommentLockToggleRequest, FlyCommentPage, FlyCommentReportReason, FlyCommentReportRequest, FlyCommentReportStatus, FlyCommentSubmitRequest, FlyCountry, FlyDrawerSide, FlyDrawerSize, FlyEmojiCategory, FlyEmojiCell, FlyEmojiEntry, FlyEmojiPack, FlyEmojiPackEntry, FlyEmojiPackManifest, FlyEmojiPickerSize, FlyEmojiPickerTab, FlyEmojiSection, FlyFileInfo, FlyFileSelection, FlyFormAnswer, FlyFormAnswerValue, FlyFormDefinition, FlyFormFieldOptions, FlyFormOption, FlyFormQuestion, FlyFormQuestionType, FlyFormScoreDisplay, FlyLaunchEventDetail, FlyLaunchRequestDetail, FlyLeaderboardRow, FlyLiveRefreshOptions, FlyLocaleEntry, FlyMetaItem, FlyModerationLoadPageRequest, FlyModerationLockThreadRequest, FlyModerationOpenSubjectRequest, FlyModerationReport, FlyModerationReportPage, FlyModerationResolutionStatus, FlyModerationResolveRequest, FlyNavigableItem, FlyPageMeta, FlyPageResult, FlyPaged, FlyPeoplePickerMode, FlyPeoplePickerOption, FlyPeopleSearchFn, FlyPointsSummary, FlyRemoteContext, FlyRemoteEagerRoute, FlyRemoteLazyRoute, FlyRemoteLoadedComponent, FlyRemoteMatch, FlyRemoteRoute, FlyRemoteRouteEventDetail, FlySearchExpandTrigger, FlySearchInputSize, FlySecureSrcState, FlySelectOption, FlySelectValue, FlySkeletonAnimation, FlySkeletonLayout, FlySkeletonShape, FlySkinTone, FlySort, FlyStandaloneAuthConfig, FlyFileSelection as FlySurveyFileSelection, FlyFormAnswer as FlySurveyFormAnswer, FlyFormAnswerValue as FlySurveyFormAnswerValue, FlyFormDefinition as FlySurveyFormDefinition, FlyFormFieldOptions as FlySurveyFormFieldOptions, FlyFormOption as FlySurveyFormOption, FlyFormQuestion as FlySurveyFormQuestion, FlyFormQuestionType as FlySurveyQuestionType, FlyThemeMode, FlyTooltipPlacement, FlyTreeNavNode, FlyTypeaheadOption, FlyWindowHelpHintEventDetail, FlyWindowHelpPublisher, FlyWindowPageTitleEventDetail, FlyWindowTitlePublisher, FlyosPendingLaunches, FocusRestore, FormBannerKind, GanttDependency, GanttDependencyCreate, GanttRow, GanttRowDatesChange, GanttRowKind, GanttZoom, IconButtonVariant, LaunchContext, LoadBundleOptions, LookupDescriptor, LookupHandle, LookupRegistration, LookupResult, LookupSearch, MessageBoxButton, MessageBoxDontAskAgainConfig, MessageBoxOptions, MessageBoxOptionsWithAcknowledgement, MockAuthConfig, OpenWindowOptions, OuPrincipal, OuTerm, OverlayHandle, PageHeaderVariant, PresetTerm, ProgressTone, RemoteAppDef, RequestAppLaunchOptions, RoleOuLookupRow, RolePrincipal, RolesTerm, SegmentedOption, ShareOrgChartOption, ShareOuNode, SharePanelLevelOption, SharePermissionEntry, SharePrincipal, SharePrincipalKind, ShareUserResult, StateMessageKind, StepUpChallenge, StepUpReauthHandler, StepUpReauthRequest, ToastAction, ToastEntry, ToastOptions, ToastVariant, User, UserPrincipal, UsersTerm, WindowHelpHint, WindowInstance, WindowState };
 //# sourceMappingURL=flyos-design-system.d.ts.map