@saasicat/ui-vue 0.24.2 → 0.26.0

package/dist/index.d.cts

@@ -1,13 +1,13 @@
-import { BootLoaderOptions, ManifestLoaderOptions, BuildRouteEntry, SidebarSection, NavBuilderOptions, BatchColumnData, BatchColumnFetcherOptions, BootLoader, ManifestLoader } from './client/index.cjs';
-export { ADMIN_UI_VERSION, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, LoginBootProject, LoginBrandFallback, LoginBranding, ManifestLoadError, MessageParams, ParamStyle, PlanCounts, PlanRowLike, PlanVersionLike, ResolvePlansInput, ResolvedPlan, SidebarItem, buildRoutes, buildSidebar, countPlans, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isCurrentlyValid, isExpired, isFutureScheduled, isProductionBoot, postJson, resolveExtension, resolveLoginBranding, resolvePlans, todayIsoDate, trimTrailingSlashes } from './client/index.cjs';
-import { H as HttpClient, e as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './catalog-DJcfm5N2.cjs';
-export { f as ActionDefNotInManifestError, D as DEFAULT_SA_LOCALE, g as HttpResponse, M as MessageTree, h as MissingHandlerError, P as PartialMessages, R as ResolvedAction, i as SA_INTL_LOCALES, j as SA_LOCALES, k as SA_LOCALE_LABELS, l as SA_MESSAGES, m as SaBuiltinLocale, n as SaCatalog, o as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TranslationOf, p as createSaCatalog, q as defaultHttpClient, r as defaultKvStore, s as defineMessages, t as isSaBuiltinLocale, u as mergeMessages, v as resolveMessages } from './catalog-DJcfm5N2.cjs';
-import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter } from './use-sa-theme-B5t7oXph.cjs';
-export { h as ExtensionLoader, I as InstallPlugin, i as SA_LOCALE_STORAGE_KEY, j as SA_THEME_KEY, k as SUPER_ADMIN_ACTIONS_KEY, l as SUPER_ADMIN_BRAND_KEY, m as SUPER_ADMIN_ENDPOINTS_KEY, n as SUPER_ADMIN_EXTENSIONS_KEY, o as SUPER_ADMIN_HTTP_KEY, p as SUPER_ADMIN_I18N_KEY, q as SUPER_ADMIN_LOGIN_ADAPTER_KEY, r as SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY, s as SUPER_ADMIN_MANIFEST_KEY, t as SUPER_ADMIN_NOTIFY_KEY, u as SaColorScheme, v as SaResolvedScheme, g as SaTheme, e as SaThemeOptions, w as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, f as SuperAdminI18n, d as SuperAdminI18nOptions, x as SuperAdminLoginResult, y as SuperAdminManifestGuardOptions, U as UiNotify, z as UiNotifyKind, B as UiNotifyOptions, C as buildNavigationGuard, D as createSaTheme, F as createSuperAdminI18n, G as useSaMessages, H as useSaTheme, J as useSuperAdminI18n } from './use-sa-theme-B5t7oXph.cjs';
+import { AdminError, BootLoaderOptions, ManifestLoaderOptions, BuildRouteEntry, SidebarSection, NavBuilderOptions, BatchColumnData, BatchColumnFetcherOptions, BootLoader, ManifestLoader } from './client/index.cjs';
+export { ADMIN_UI_VERSION, AdminErrorInit, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, AxiosHttpClientOptions, AxiosLike, AxiosLikeConfig, AxiosLikeResponse, AxiosLikeResponseConfig, AxiosResponseBody, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, FetchHttpClientOptions, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, LoginBootProject, LoginBrandFallback, LoginBranding, ManifestLoadError, MessageParams, ParamStyle, PlanCounts, PlanRowLike, PlanVersionLike, ResolvePlansInput, ResolvedPlan, ResourceRequestInit, SidebarItem, adminErrorMessage, buildRoutes, buildSidebar, countPlans, createAdminResourceClient, createAxiosHttpClient, createFetchHttpClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isAdminError, isAxiosNoResponseError, isCurrentlyValid, isEmptyResponse, isExpired, isFutureScheduled, isPlatformError, isProductionBoot, isTransportFailure, markEmptyResponse, markPlatformError, markTransportFailure, postJson, readErrorCode, readErrorDetail, requestJson, requestJsonBody, requireServerAnswer, resolveExtension, resolveLoginBranding, resolvePlans, toAdminError, todayIsoDate, trimTrailingSlashes } from './client/index.cjs';
+import { H as HttpClient, g as ResourceListPage, e as ResourceOps, P as PlatformResources, h as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './catalog-Dch1Ryw0.cjs';
+export { i as ActionDefNotInManifestError, j as AuditListFilter, B as Bound, D as DEFAULT_SA_LOCALE, k as DefineResourceOptions, l as HttpResponse, L as LIST_FIRST_PAGE, m as LIST_PAGE_SIZE_DEFAULT, n as LIST_PAGE_SIZE_MAX, o as LIST_PAGINATION_PARAMS, q as ListFilterOf, r as ListOp, s as ListQuery, M as MessageTree, t as MissingHandlerError, u as PartialMessages, v as PublishPlanVersionOptions, w as ResolvedAction, f as ResourceContext, R as ResourceDef, x as ResourceOp, y as SA_INTL_LOCALES, z as SA_LOCALES, C as SA_LOCALE_LABELS, E as SA_MESSAGES, F as SaBuiltinLocale, G as SaCatalog, I as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TenantsListFilter, J as TranslationOf, N as auditResource, O as bindResource, Q as clampListPage, U as clampListPageSize, V as createSaCatalog, W as defaultHttpClient, X as defaultKvStore, Y as defineListOp, Z as defineMessages, _ as defineResource, $ as filterQueryString, a0 as isSaBuiltinLocale, a1 as isSentInQuery, a2 as listUrl, a3 as mergeMessages, a4 as planVersionsResource, a5 as plansResource, p as platformResources, a6 as readListPage, a7 as resolveMessages, a8 as tenantsResource } from './catalog-Dch1Ryw0.cjs';
+import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter, U as UiNotify, j as ResourceMap } from './resource-registry-D7Xjs-5f.cjs';
+export { C as CreateResourceRegistryOptions, k as ExtensionLoader, I as InstallPlugin, O as OpOverride, l as ResourceOverride, R as ResourceOverrides, m as ResourceRegistry, n as SA_COLOR_SCHEMES, o as SA_LOCALE_STORAGE_KEY, p as SA_THEME_KEY, q as SA_THEME_STORAGE_KEY, r as SUPER_ADMIN_ACTIONS_KEY, s as SUPER_ADMIN_BRAND_KEY, t as SUPER_ADMIN_CONFIRM_KEY, u as SUPER_ADMIN_ENDPOINTS_KEY, v as SUPER_ADMIN_EXTENSIONS_KEY, w as SUPER_ADMIN_HTTP_KEY, x as SUPER_ADMIN_I18N_KEY, y as SUPER_ADMIN_LOGIN_ADAPTER_KEY, z as SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY, B as SUPER_ADMIN_MANIFEST_KEY, D as SUPER_ADMIN_NOTIFY_KEY, F as SUPER_ADMIN_RESOURCES_KEY, G as SaColorScheme, H as SaResolvedScheme, h as SaTheme, f as SaThemeOptions, J as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, g as SuperAdminI18n, e as SuperAdminI18nOptions, K as SuperAdminLoginResult, L as SuperAdminManifestGuardOptions, d as UiConfirm, M as UiConfirmPrompt, i as UiConfirmRequest, N as UiConfirmResult, P as UiConfirmTone, Q as UiNotifyKind, T as UiNotifyOptions, V as buildNavigationGuard, W as createResourceRegistry, X as createSaTheme, Y as createSuperAdminI18n, Z as useResource, _ as useSaMessages, $ as useSaTheme, a0 as useSuperAdminI18n } from './resource-registry-D7Xjs-5f.cjs';
 import { AdminManifest, TenantListFilter, TenantDto, AuditQuery, AuditEntry, FeatureUiRegistry, PromoPreviewResponse, OnboardingSelectionRequest, PublicMarketingBundle, FeatureDef, FeatureKey, PublicBootResponse, DiscoverySnapshot, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, SyncDiscoveryResult, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, SubscriptionBundleRecord, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, PromotionRow, CreatePromotionData, UpdatePromotionData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, TenantActionDef } from '@saasicat/types';
 import { RouteRecordRaw, NavigationGuardWithThis } from 'vue-router';
 import * as vue from 'vue';
-import { Ref, ComputedRef, InjectionKey, App } from 'vue';
+import { Ref, ComputedRef, WatchSource, InjectionKey, App } from 'vue';
 import { StoreDefinition } from 'pinia';
 
 /** Returns the `extensions:` map registered in `createSuperAdminApp()`. */
@@ -49,7 +49,15 @@ interface CreateAdminRoutesOptions {
     /**
      * Loader for the shared login page. The app passes it through as a
      * package-path import (resolved by the app bundler):
-     * `() => import('@saasicat/ui-vue/pages-standard/SuperAdminLoginPage.vue')`.
+     * `() => import('@saasicat/ui-vue/pages/SuperAdminLoginPage.vue')`.
+     *
+     * That subpath has two spellings today: the export map maps both
+     * `./pages/*` and `./pages-standard/*` onto `src/pages-standard/`, so the
+     * two imports are the same file. The scaffolder template
+     * (`create-saasicat-admin`) and `examples/notesapp` spell it `/pages/*`,
+     * which is why the example above does; the package README lists the SFC
+     * entries under `/pages-standard/*`. Collapsing the pair is a breaking
+     * change to the export map and is deliberately not done here.
      */
     loginPage: RouteComponent;
     /** Layout component for `/admin` (e.g. `() => import('@/layouts/AdminLayout.vue')`). */
@@ -67,12 +75,14 @@ interface CreateAdminRoutesOptions {
 }
 declare function createAdminRoutes(options: CreateAdminRoutesOptions): RouteRecordRaw[];
 
-interface ApiListResponse<T> {
-    items: T[];
-    page?: number;
-    pageSize?: number;
-    total?: number;
-}
+/**
+ * The envelope a list endpoint may answer with.
+ *
+ * @deprecated Use `ResourceListPage`, which is this shape under the name the
+ * resource layer works with. Kept as an alias so an app that typed its own
+ * endpoint against it keeps compiling; one shape, one definition.
+ */
+type ApiListResponse<T> = ResourceListPage<T>;
 interface UseApiListOptions<TFilter> {
     endpoint: string;
     /**
@@ -127,6 +137,154 @@ interface UsePaginationResult<T> {
 }
 declare function usePagination<T>(rows: Ref<readonly T[]> | ComputedRef<readonly T[]>, initialRowsPerPage?: number): UsePaginationResult<T>;
 
+/**
+ * What an action did. `ok` is the branch to read — it answers for a
+ * `Promise<void>` action exactly as well as for one that returns a row.
+ */
+type AsyncActionResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: AdminError;
+};
+interface AsyncAction<A extends unknown[], T> {
+    /** Runs the action. Never throws; the outcome is in the result. */
+    run: (...args: A) => Promise<AsyncActionResult<T>>;
+    /** True while the call is in flight — what a submit button disables on. */
+    pending: Ref<boolean>;
+    /** The last failure, or `null`. Cleared at the start of every run. */
+    error: Ref<AdminError | null>;
+    /** Clears `error` without running anything. */
+    reset: () => void;
+}
+interface UseAsyncActionOptions<T> {
+    /**
+     * Which outcomes raise a toast. Default `'error'` — a success that changed
+     * something visible needs no announcement, a failure always does.
+     */
+    notifyOn?: 'error' | 'both' | 'none';
+    /** Text for the success toast. Required for `notifyOn: 'both'` to say anything. */
+    successMessage?: string | (() => string);
+    /**
+     * Overrides how a failure is worded.
+     *
+     * Not decoration: several pages map a status and an error code to a
+     * specific sentence — a 422 carrying `STRICT_MODE_VIOLATIONS` reads out the
+     * violations, a 401 says the session expired. `AdminError` carries
+     * `status`, `code` and `body`, so that mapping is a pure function of the
+     * error, and this is where it attaches.
+     */
+    errorMessage?: (error: AdminError) => string;
+    /** Runs after a successful call, before `run` resolves. */
+    onSuccess?: (result: T) => void | Promise<void>;
+    /**
+     * Notify port to report through. Defaults to the injected one.
+     *
+     * There is no fallback beyond that: this layer must not import Quasar, so
+     * it cannot reach `quasarNotify` the way a page can. Without a bootstrap
+     * and without this option, failures are reported through `error` alone.
+     */
+    notify?: UiNotify;
+}
+declare function useAsyncAction<A extends unknown[], T>(fn: (...args: A) => Promise<T>, options?: UseAsyncActionOptions<T>): AsyncAction<A, T>;
+
+interface AsyncData<T> {
+    /** The loaded value, or `initial` before the first load and after a failure. */
+    data: Ref<T>;
+    /** True while a load is in flight. */
+    pending: Ref<boolean>;
+    /** The last failure, or `null`. Cleared at the start of every load. */
+    error: Ref<AdminError | null>;
+    /** Loads again — after a mutation, or from a retry button. */
+    reload: () => Promise<void>;
+}
+interface UseAsyncDataOptions<T> {
+    /** Value before the first load, and the value restored when one fails. */
+    initial: T;
+    /** Load once on creation. Default `true`. */
+    immediate?: boolean;
+    /** Reload whenever any of these changes — a filter, a selected row, a locale. */
+    watch?: WatchSource[];
+}
+declare function useAsyncData<T>(fn: () => Promise<T>, options: UseAsyncDataOptions<T>): AsyncData<T>;
+
+/** The operations of a resource that answer with one page of a list. */
+type ListOpNames<TOps extends ResourceOps> = {
+    [N in keyof TOps]: Awaited<ReturnType<TOps[N]>> extends ResourceListPage<unknown> ? N : never;
+}[keyof TOps];
+/**
+ * The resources that have such an operation at all.
+ *
+ * Without this, `useResourceList('plans')` compiled: `plans.list` answers with
+ * a plain `PlanRow[]`, the row type collapsed to `never`, and the first thing
+ * to notice was `items.value` being `undefined` at runtime. Derived from the
+ * operations rather than listed, so a resource that grows a list operation
+ * becomes available here by being written, not by being remembered.
+ */
+type ListResourceKey<TMap extends ResourceMap> = {
+    [K in keyof TMap]: [ListOpNames<TMap[K]['ops']>] extends [never] ? never : K;
+}[keyof TMap];
+/**
+ * The row type a named list operation yields — read off the operation, not
+ * declared next to it. A hand-maintained map of resource to row is the same
+ * defect one level up: it can be right today and silently wrong tomorrow.
+ */
+type RowOf<TOps extends ResourceOps, N extends keyof TOps> = Awaited<ReturnType<TOps[N]>> extends ResourceListPage<infer TRow> ? TRow : never;
+/** A paginated read: what a standard admin list binds its table to. */
+interface AsyncList<T> {
+    /** The rows of the current page. */
+    items: ComputedRef<T[]>;
+    /**
+     * Rows matching the filter when the endpoint reports a total, and rows on
+     * this page when it does not. Several admin controllers answer with a bare
+     * array, and there is no honest way to tell the two apart afterwards — see
+     * `ResourceListPage.total`.
+     */
+    total: ComputedRef<number>;
+    /** 1-based. Moved by `goToPage`, and reset to 1 by a filter change. */
+    page: Ref<number>;
+    pageSize: Ref<number>;
+    /**
+     * True while a load is in flight. Named as in `useAsyncData` and
+     * `useAsyncAction`, whose flag this is — `useApiList` calls its own
+     * `loading`.
+     */
+    pending: Ref<boolean>;
+    /** The last failure, or `null`. Cleared at the start of every load. */
+    error: Ref<AdminError | null>;
+    /** Loads the current page again — after a mutation, or from a retry button. */
+    reload: () => Promise<void>;
+    /** Jumps to a page (1-based, clamped) and loads. */
+    goToPage: (page: number) => Promise<void>;
+    /** Changes the page size, returns to page 1, and loads. */
+    setPageSize: (size: number) => Promise<void>;
+}
+interface UseResourceListOptions<TOps extends ResourceOps, N extends ListOpNames<TOps>> {
+    /** Which operation to page through. Defaults to `list`. */
+    op?: N;
+    /**
+     * Reactive filter. A change returns to page 1 and reloads — a filter that
+     * narrows the list while the operator is on page 4 would otherwise ask for
+     * a page that no longer exists and render nothing.
+     *
+     * `page` and `pageSize` are not filter keys; see the guard below.
+     */
+    filter?: Ref<Record<string, unknown>>;
+    /**
+     * Rows per page to start with. Defaults to `LIST_PAGE_SIZE_DEFAULT`.
+     *
+     * Here rather than through `setPageSize` after construction, which is what
+     * a page with a `pageSize` prop had to do: `setPageSize` loads, and the
+     * first load was already queued, so the list fetched the same rows twice on
+     * every mount.
+     */
+    pageSize?: number;
+    /** Load once on creation. Default `true`. */
+    immediate?: boolean;
+}
+declare function useResourceList<K extends ListResourceKey<TMap> & keyof TMap & string, TMap extends ResourceMap = PlatformResources, N extends ListOpNames<TMap[K]['ops']> = ListOpNames<TMap[K]['ops']>>(key: K, opts?: UseResourceListOptions<TMap[K]['ops'], N>): AsyncList<RowOf<TMap[K]['ops'], N>>;
+
 interface UseTenantsOptions {
     /**
      * Fully qualified tenants-list endpoint including the app globalPrefix
@@ -768,6 +926,12 @@ interface UseDiscoveryOptions {
      */
     autoLoad?: boolean;
 }
+/**
+ * The discovery endpoint could not be read. Its `message` is a diagnostic for
+ * the log, in English like every other developer-facing string in the
+ * repository — the sentence a user is shown comes from the `errors` catalog
+ * through `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class DiscoveryLoadError extends Error {
     readonly status: number;
     constructor(status: number, message: string);
@@ -805,6 +969,12 @@ interface UseCatalogEntriesOptions {
     projectKey: string;
     autoLoad?: boolean;
 }
+/**
+ * A catalog-entries call failed. Its `message` is a diagnostic for the log, in
+ * English like every other developer-facing string in the repository — the
+ * sentence a user is shown comes from the `errors` catalog through
+ * `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class CatalogEntriesApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -946,6 +1116,12 @@ interface UseMarketingProjectionsOptions {
     filter: MarketingProjectionFilter;
     autoLoad?: boolean;
 }
+/**
+ * A marketing-projections call failed. Its `message` is a diagnostic for the
+ * log, in English like every other developer-facing string in the repository —
+ * the sentence a user is shown comes from the `errors` catalog through
+ * `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class MarketingProjectionsApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -972,6 +1148,12 @@ interface UsePromotionsOptions {
     projectKey: string;
     autoLoad?: boolean;
 }
+/**
+ * A promotions call failed. Its `message` is a diagnostic for the log, in
+ * English like every other developer-facing string in the repository — the
+ * sentence a user is shown comes from the `errors` catalog through
+ * `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class PromotionsApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -1323,6 +1505,14 @@ interface PlatformLoaders {
     bootLoader: BootLoader;
     manifestLoader: ManifestLoader;
 }
+/**
+ * Fills in what an app left out.
+ *
+ * Exported because the bootstrap needs the same answer, and two copies of a
+ * default are two places for it to drift — which is how `projectKey` was
+ * added to one of them and not the other.
+ */
+declare function resolveSuperAdminEndpoints(endpoints: SuperAdminEndpoints): Required<SuperAdminEndpoints>;
 /**
  * Builds `BootLoader` + `ManifestLoader` from a single endpoint constant.
  * Apps use the same constant for `createSuperAdminApp({ endpoints })`.
@@ -1841,4 +2031,4 @@ interface PlanChangeWizardI18n {
  */
 declare function planChangeWizardI18n(i18n: TenantPlanSectionI18n): PlanChangeWizardI18n;
 
-export { ALL_ROWS, ActionHandler, ActionRegistry, ActionsMap, type ApiListResponse, BatchColumnData, BatchColumnFetcherOptions, type BillingCycleStr, BootLoader, BootLoaderOptions, BuildRouteEntry, type BulkItemKind, type BulkItemStatus, type BulkPublishItem, type BundleAddPreviewShape, type BundleCancelPreviewShape, type BundlePreviewIssueShape, type BundlePreviewShape, type BundlePreviewSnapshotShape, BundlesApiError, CATALOG_DEFAULT_LOCALE, type CatalogBundle, CatalogEntriesApiError, type CatalogPlan, type ConfirmDialogState, type CreateAdminRoutesOptions, type CreateManifestStoreOptions, type CreatePlatformLoadersOptions, DEFAULT_I18N_DE, DEFAULT_I18N_EN, DEFAULT_ROWS_PER_PAGE, DEFAULT_YEARLY_FACTOR, DiscoveryLoadError, type DraftPricing, ENTITLEMENT_INJECTION_KEY, type EmailHistoryDetail, type EmailHistoryFilter, type EmailHistoryListResult, type EmailHistoryResendResult, type EmailHistoryRow, type EmailHistoryStatus, type EntitlementSnapshotShape, ExtensionsMap, type FeatureRegistryEntry, type FeatureRouterGuardOptions, type FeatureRowMarkers, HttpClient, KvStore, ManifestLoader, ManifestLoaderOptions, type ManifestStoreActions, type ManifestStoreDefinition, type ManifestStoreState, MarketingProjectionsApiError, type MfaDialogState, NavBuilderOptions, PAGE_SIZE_OPTIONS, type PackageSnapshotShape, type PilotCopy, type PilotCreatePayload, type PilotCreateResult, type PilotEditPayload, type PilotEditResult, type PlanChangePreviewShape, type PlanChangeWizardI18n, type PlanSnapshotShape, PlannedOnlyFeatureError, PlansApiError, type PlatformEmailProvider, type PlatformEmailTestInput, type PlatformEmailTestResult, type PlatformEmailWriteInput, type PlatformLoaders, type PlatformTenantActionRow, type PlatformTenantActionTone, type PlatformTenantActionsOptions, type PlatformTenantActionsResult, type PriceLineItem, ProjectPageHost, type PromoCodeCreatePayload, type PromoCodeDurationType, type PromoCodePlanOption, type PromoCodeUpdatePayload, type PromoCodeValueType, type PromoState, type PromoStatus, PromotionsApiError, type QuotaMeta, type RedundantFeatureHintShape, type ResolvedTenantAction, SERVER_PAGE_SIZE_OPTIONS, SaLocale, SidebarSection, type SubscriptionBundleShape, type SubscriptionDraft, SuperAdminBrand, SuperAdminEndpoints, SuperAdminLoginAdapter, type TenantActionFlowProviders, type TenantActionInput, type TenantManifestNavItem, type TenantManifestShape, type TenantPlanSectionI18n, type TenantRowLike, TenantSubscriptionBundlesApiError, type UsageSnapshotShape, type UseActionsResult, type UseApiListOptions, type UseApiListResult, type UseAuditEntriesOptions, type UseAuditEntriesResult, type UseBatchColumnsResult, type UseBulkPublishOptions, type UseBulkPublishResult, type UseBundleVersionsMapOptions, type UseBundleVersionsMapResult, type UseBundleVersionsOptions, type UseBundleVersionsResult, type UseBundlesOptions, type UseBundlesResult, type UseCatalogEntriesOptions, type UseCatalogEntriesResult, type UseDiscoveryOptions, type UseDiscoveryResult, type UseEntitlementOptions, type UseEntitlementResult, type UseLivePlanVersionsOptions, type UseLivePlanVersionsResult, type UseManifestResult, type UseMarketingProjectionsOptions, type UseMarketingProjectionsResult, type UseNavResult, type UsePaginationResult, type UsePlanEditorOptions, type UsePlanEditorResult, type UsePlanVersionsOptions, type UsePlanVersionsResult, type UsePlansOptions, type UsePlansResult, type UsePromotionsOptions, type UsePromotionsResult, type UsePublicBootResult, type UseSubscriptionDraftOptions, type UseTenantActionFlowResult, type UseTenantBillingCatalogOptions, type UseTenantBillingCatalogResult, type UseTenantBillingOptions, type UseTenantBillingResult, type UseTenantManifestOptions, type UseTenantManifestResult, type UseTenantSubscriptionBundlesOptions, type UseTenantSubscriptionBundlesResult, type UseTenantsOptions, type UseTenantsResult, buildFeatureRegistry, buildFeatureRouterGuard, buildQuotaRegistry, createAdminRoutes, createManifestStore, createPlatformLoaders, createProjectPageHostRoute, defaultIconForActionKey, defaultTenantPlanSectionI18n, defaultToneForActionKey, planChangeWizardI18n, provideEntitlement, useActions, useApiList, useAuditEntries, useBatchColumns, useBulkPublish, useBundleVersions, useBundleVersionsMap, useBundles, useCatalogEntries, useDiscovery, useEntitlement, useInjectedEntitlement, useLivePlanVersions, useManifest, useMarketingProjections, useNav, usePagination, usePlanEditor, usePlanVersions, usePlans, usePlatformTenantActions, usePromotions, usePublicBoot, useSubscriptionDraft, useSuperAdminActions, useSuperAdminBrand, useSuperAdminEndpoints, useSuperAdminExtensions, useSuperAdminHttp, useSuperAdminLoginAdapter, useSuperAdminManifest, useTenantActionFlow, useTenantBilling, useTenantBillingCatalog, useTenantManifest, useTenantSubscriptionBundles, useTenants };
+export { ALL_ROWS, ActionHandler, ActionRegistry, ActionsMap, AdminError, type ApiListResponse, type AsyncAction, type AsyncActionResult, type AsyncData, type AsyncList, BatchColumnData, BatchColumnFetcherOptions, type BillingCycleStr, BootLoader, BootLoaderOptions, BuildRouteEntry, type BulkItemKind, type BulkItemStatus, type BulkPublishItem, type BundleAddPreviewShape, type BundleCancelPreviewShape, type BundlePreviewIssueShape, type BundlePreviewShape, type BundlePreviewSnapshotShape, BundlesApiError, CATALOG_DEFAULT_LOCALE, type CatalogBundle, CatalogEntriesApiError, type CatalogPlan, type ConfirmDialogState, type CreateAdminRoutesOptions, type CreateManifestStoreOptions, type CreatePlatformLoadersOptions, DEFAULT_I18N_DE, DEFAULT_I18N_EN, DEFAULT_ROWS_PER_PAGE, DEFAULT_YEARLY_FACTOR, DiscoveryLoadError, type DraftPricing, ENTITLEMENT_INJECTION_KEY, type EmailHistoryDetail, type EmailHistoryFilter, type EmailHistoryListResult, type EmailHistoryResendResult, type EmailHistoryRow, type EmailHistoryStatus, type EntitlementSnapshotShape, ExtensionsMap, type FeatureRegistryEntry, type FeatureRouterGuardOptions, type FeatureRowMarkers, HttpClient, KvStore, type ListOpNames, type ListResourceKey, ManifestLoader, ManifestLoaderOptions, type ManifestStoreActions, type ManifestStoreDefinition, type ManifestStoreState, MarketingProjectionsApiError, type MfaDialogState, NavBuilderOptions, PAGE_SIZE_OPTIONS, type PackageSnapshotShape, type PilotCopy, type PilotCreatePayload, type PilotCreateResult, type PilotEditPayload, type PilotEditResult, type PlanChangePreviewShape, type PlanChangeWizardI18n, type PlanSnapshotShape, PlannedOnlyFeatureError, PlansApiError, type PlatformEmailProvider, type PlatformEmailTestInput, type PlatformEmailTestResult, type PlatformEmailWriteInput, type PlatformLoaders, PlatformResources, type PlatformTenantActionRow, type PlatformTenantActionTone, type PlatformTenantActionsOptions, type PlatformTenantActionsResult, type PriceLineItem, ProjectPageHost, type PromoCodeCreatePayload, type PromoCodeDurationType, type PromoCodePlanOption, type PromoCodeUpdatePayload, type PromoCodeValueType, type PromoState, type PromoStatus, PromotionsApiError, type QuotaMeta, type RedundantFeatureHintShape, type ResolvedTenantAction, ResourceListPage, ResourceMap, ResourceOps, type RowOf, SERVER_PAGE_SIZE_OPTIONS, SaLocale, SidebarSection, type SubscriptionBundleShape, type SubscriptionDraft, SuperAdminBrand, SuperAdminEndpoints, SuperAdminLoginAdapter, type TenantActionFlowProviders, type TenantActionInput, type TenantManifestNavItem, type TenantManifestShape, type TenantPlanSectionI18n, type TenantRowLike, TenantSubscriptionBundlesApiError, UiNotify, type UsageSnapshotShape, type UseActionsResult, type UseApiListOptions, type UseApiListResult, type UseAsyncActionOptions, type UseAsyncDataOptions, type UseAuditEntriesOptions, type UseAuditEntriesResult, type UseBatchColumnsResult, type UseBulkPublishOptions, type UseBulkPublishResult, type UseBundleVersionsMapOptions, type UseBundleVersionsMapResult, type UseBundleVersionsOptions, type UseBundleVersionsResult, type UseBundlesOptions, type UseBundlesResult, type UseCatalogEntriesOptions, type UseCatalogEntriesResult, type UseDiscoveryOptions, type UseDiscoveryResult, type UseEntitlementOptions, type UseEntitlementResult, type UseLivePlanVersionsOptions, type UseLivePlanVersionsResult, type UseManifestResult, type UseMarketingProjectionsOptions, type UseMarketingProjectionsResult, type UseNavResult, type UsePaginationResult, type UsePlanEditorOptions, type UsePlanEditorResult, type UsePlanVersionsOptions, type UsePlanVersionsResult, type UsePlansOptions, type UsePlansResult, type UsePromotionsOptions, type UsePromotionsResult, type UsePublicBootResult, type UseResourceListOptions, type UseSubscriptionDraftOptions, type UseTenantActionFlowResult, type UseTenantBillingCatalogOptions, type UseTenantBillingCatalogResult, type UseTenantBillingOptions, type UseTenantBillingResult, type UseTenantManifestOptions, type UseTenantManifestResult, type UseTenantSubscriptionBundlesOptions, type UseTenantSubscriptionBundlesResult, type UseTenantsOptions, type UseTenantsResult, buildFeatureRegistry, buildFeatureRouterGuard, buildQuotaRegistry, createAdminRoutes, createManifestStore, createPlatformLoaders, createProjectPageHostRoute, defaultIconForActionKey, defaultTenantPlanSectionI18n, defaultToneForActionKey, planChangeWizardI18n, provideEntitlement, resolveSuperAdminEndpoints, useActions, useApiList, useAsyncAction, useAsyncData, useAuditEntries, useBatchColumns, useBulkPublish, useBundleVersions, useBundleVersionsMap, useBundles, useCatalogEntries, useDiscovery, useEntitlement, useInjectedEntitlement, useLivePlanVersions, useManifest, useMarketingProjections, useNav, usePagination, usePlanEditor, usePlanVersions, usePlans, usePlatformTenantActions, usePromotions, usePublicBoot, useResourceList, useSubscriptionDraft, useSuperAdminActions, useSuperAdminBrand, useSuperAdminEndpoints, useSuperAdminExtensions, useSuperAdminHttp, useSuperAdminLoginAdapter, useSuperAdminManifest, useTenantActionFlow, useTenantBilling, useTenantBillingCatalog, useTenantManifest, useTenantSubscriptionBundles, useTenants };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { BootLoaderOptions, ManifestLoaderOptions, BuildRouteEntry, SidebarSection, NavBuilderOptions, BatchColumnData, BatchColumnFetcherOptions, BootLoader, ManifestLoader } from './client/index.js';
-export { ADMIN_UI_VERSION, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, LoginBootProject, LoginBrandFallback, LoginBranding, ManifestLoadError, MessageParams, ParamStyle, PlanCounts, PlanRowLike, PlanVersionLike, ResolvePlansInput, ResolvedPlan, SidebarItem, buildRoutes, buildSidebar, countPlans, createAdminResourceClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isCurrentlyValid, isExpired, isFutureScheduled, isProductionBoot, postJson, resolveExtension, resolveLoginBranding, resolvePlans, todayIsoDate, trimTrailingSlashes } from './client/index.js';
-import { H as HttpClient, e as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './catalog-DJcfm5N2.js';
-export { f as ActionDefNotInManifestError, D as DEFAULT_SA_LOCALE, g as HttpResponse, M as MessageTree, h as MissingHandlerError, P as PartialMessages, R as ResolvedAction, i as SA_INTL_LOCALES, j as SA_LOCALES, k as SA_LOCALE_LABELS, l as SA_MESSAGES, m as SaBuiltinLocale, n as SaCatalog, o as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TranslationOf, p as createSaCatalog, q as defaultHttpClient, r as defaultKvStore, s as defineMessages, t as isSaBuiltinLocale, u as mergeMessages, v as resolveMessages } from './catalog-DJcfm5N2.js';
-import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter } from './use-sa-theme-OUBlaqgl.js';
-export { h as ExtensionLoader, I as InstallPlugin, i as SA_LOCALE_STORAGE_KEY, j as SA_THEME_KEY, k as SUPER_ADMIN_ACTIONS_KEY, l as SUPER_ADMIN_BRAND_KEY, m as SUPER_ADMIN_ENDPOINTS_KEY, n as SUPER_ADMIN_EXTENSIONS_KEY, o as SUPER_ADMIN_HTTP_KEY, p as SUPER_ADMIN_I18N_KEY, q as SUPER_ADMIN_LOGIN_ADAPTER_KEY, r as SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY, s as SUPER_ADMIN_MANIFEST_KEY, t as SUPER_ADMIN_NOTIFY_KEY, u as SaColorScheme, v as SaResolvedScheme, g as SaTheme, e as SaThemeOptions, w as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, f as SuperAdminI18n, d as SuperAdminI18nOptions, x as SuperAdminLoginResult, y as SuperAdminManifestGuardOptions, U as UiNotify, z as UiNotifyKind, B as UiNotifyOptions, C as buildNavigationGuard, D as createSaTheme, F as createSuperAdminI18n, G as useSaMessages, H as useSaTheme, J as useSuperAdminI18n } from './use-sa-theme-OUBlaqgl.js';
+import { AdminError, BootLoaderOptions, ManifestLoaderOptions, BuildRouteEntry, SidebarSection, NavBuilderOptions, BatchColumnData, BatchColumnFetcherOptions, BootLoader, ManifestLoader } from './client/index.js';
+export { ADMIN_UI_VERSION, AdminErrorInit, AdminPromoListFilter, AdminPromoListRow, AdminResourceClientOptions, AxiosHttpClientOptions, AxiosLike, AxiosLikeConfig, AxiosLikeResponse, AxiosLikeResponseConfig, AxiosResponseBody, BatchColumnDriftError, BatchColumnFetcher, BatchColumnRow, BatchColumnValue, BootLoadError, CachedManifestEntry, DEFAULT_STANDARD_PAGE_ROUTES, FetchHttpClientOptions, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, LoginBootProject, LoginBrandFallback, LoginBranding, ManifestLoadError, MessageParams, ParamStyle, PlanCounts, PlanRowLike, PlanVersionLike, ResolvePlansInput, ResolvedPlan, ResourceRequestInit, SidebarItem, adminErrorMessage, buildRoutes, buildSidebar, countPlans, createAdminResourceClient, createAxiosHttpClient, createFetchHttpClient, defaultSectionOrder, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isAdminError, isAxiosNoResponseError, isCurrentlyValid, isEmptyResponse, isExpired, isFutureScheduled, isPlatformError, isProductionBoot, isTransportFailure, markEmptyResponse, markPlatformError, markTransportFailure, postJson, readErrorCode, readErrorDetail, requestJson, requestJsonBody, requireServerAnswer, resolveExtension, resolveLoginBranding, resolvePlans, toAdminError, todayIsoDate, trimTrailingSlashes } from './client/index.js';
+import { H as HttpClient, g as ResourceListPage, e as ResourceOps, P as PlatformResources, h as ActionRegistry, A as ActionHandler, K as KvStore, S as SaLocale } from './catalog-Dch1Ryw0.js';
+export { i as ActionDefNotInManifestError, j as AuditListFilter, B as Bound, D as DEFAULT_SA_LOCALE, k as DefineResourceOptions, l as HttpResponse, L as LIST_FIRST_PAGE, m as LIST_PAGE_SIZE_DEFAULT, n as LIST_PAGE_SIZE_MAX, o as LIST_PAGINATION_PARAMS, q as ListFilterOf, r as ListOp, s as ListQuery, M as MessageTree, t as MissingHandlerError, u as PartialMessages, v as PublishPlanVersionOptions, w as ResolvedAction, f as ResourceContext, R as ResourceDef, x as ResourceOp, y as SA_INTL_LOCALES, z as SA_LOCALES, C as SA_LOCALE_LABELS, E as SA_MESSAGES, F as SaBuiltinLocale, G as SaCatalog, I as SaCatalogOptions, c as SaLocaleDefinition, b as SaLocaleOption, a as SaMessages, d as SaMessagesOverrides, T as TenantsListFilter, J as TranslationOf, N as auditResource, O as bindResource, Q as clampListPage, U as clampListPageSize, V as createSaCatalog, W as defaultHttpClient, X as defaultKvStore, Y as defineListOp, Z as defineMessages, _ as defineResource, $ as filterQueryString, a0 as isSaBuiltinLocale, a1 as isSentInQuery, a2 as listUrl, a3 as mergeMessages, a4 as planVersionsResource, a5 as plansResource, p as platformResources, a6 as readListPage, a7 as resolveMessages, a8 as tenantsResource } from './catalog-Dch1Ryw0.js';
+import { A as ActionsMap, a as SuperAdminBrand, b as SuperAdminEndpoints, E as ExtensionsMap, c as SuperAdminLoginAdapter, U as UiNotify, j as ResourceMap } from './resource-registry-TaR7rtq0.js';
+export { C as CreateResourceRegistryOptions, k as ExtensionLoader, I as InstallPlugin, O as OpOverride, l as ResourceOverride, R as ResourceOverrides, m as ResourceRegistry, n as SA_COLOR_SCHEMES, o as SA_LOCALE_STORAGE_KEY, p as SA_THEME_KEY, q as SA_THEME_STORAGE_KEY, r as SUPER_ADMIN_ACTIONS_KEY, s as SUPER_ADMIN_BRAND_KEY, t as SUPER_ADMIN_CONFIRM_KEY, u as SUPER_ADMIN_ENDPOINTS_KEY, v as SUPER_ADMIN_EXTENSIONS_KEY, w as SUPER_ADMIN_HTTP_KEY, x as SUPER_ADMIN_I18N_KEY, y as SUPER_ADMIN_LOGIN_ADAPTER_KEY, z as SUPER_ADMIN_MANIFEST_CLEAR_CACHE_KEY, B as SUPER_ADMIN_MANIFEST_KEY, D as SUPER_ADMIN_NOTIFY_KEY, F as SUPER_ADMIN_RESOURCES_KEY, G as SaColorScheme, H as SaResolvedScheme, h as SaTheme, f as SaThemeOptions, J as SuperAdminAuthGuardOptions, S as SuperAdminGuardOptions, g as SuperAdminI18n, e as SuperAdminI18nOptions, K as SuperAdminLoginResult, L as SuperAdminManifestGuardOptions, d as UiConfirm, M as UiConfirmPrompt, i as UiConfirmRequest, N as UiConfirmResult, P as UiConfirmTone, Q as UiNotifyKind, T as UiNotifyOptions, V as buildNavigationGuard, W as createResourceRegistry, X as createSaTheme, Y as createSuperAdminI18n, Z as useResource, _ as useSaMessages, $ as useSaTheme, a0 as useSuperAdminI18n } from './resource-registry-TaR7rtq0.js';
 import { AdminManifest, TenantListFilter, TenantDto, AuditQuery, AuditEntry, FeatureUiRegistry, PromoPreviewResponse, OnboardingSelectionRequest, PublicMarketingBundle, FeatureDef, FeatureKey, PublicBootResponse, DiscoverySnapshot, CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, SyncDiscoveryResult, BundleVersionRow, CreateBundleVersionDraftData, BundleVersionMutationResult, UpdateBundleVersionDraftData, BundleRow, CreateBundleData, UpdateBundleData, SubscriptionBundleRecord, MarketingProjectionFilter, MarketingProjectionRow, CreateMarketingProjectionData, UpdateMarketingProjectionData, PromotionRow, CreatePromotionData, UpdatePromotionData, PlanVersionRow, CreatePlanVersionDraftData, PlanVersionMutationResult, UpdatePlanVersionDraftData, PlanRow, CreatePlanData, UpdatePlanData, TenantActionDef } from '@saasicat/types';
 import { RouteRecordRaw, NavigationGuardWithThis } from 'vue-router';
 import * as vue from 'vue';
-import { Ref, ComputedRef, InjectionKey, App } from 'vue';
+import { Ref, ComputedRef, WatchSource, InjectionKey, App } from 'vue';
 import { StoreDefinition } from 'pinia';
 
 /** Returns the `extensions:` map registered in `createSuperAdminApp()`. */
@@ -49,7 +49,15 @@ interface CreateAdminRoutesOptions {
     /**
      * Loader for the shared login page. The app passes it through as a
      * package-path import (resolved by the app bundler):
-     * `() => import('@saasicat/ui-vue/pages-standard/SuperAdminLoginPage.vue')`.
+     * `() => import('@saasicat/ui-vue/pages/SuperAdminLoginPage.vue')`.
+     *
+     * That subpath has two spellings today: the export map maps both
+     * `./pages/*` and `./pages-standard/*` onto `src/pages-standard/`, so the
+     * two imports are the same file. The scaffolder template
+     * (`create-saasicat-admin`) and `examples/notesapp` spell it `/pages/*`,
+     * which is why the example above does; the package README lists the SFC
+     * entries under `/pages-standard/*`. Collapsing the pair is a breaking
+     * change to the export map and is deliberately not done here.
      */
     loginPage: RouteComponent;
     /** Layout component for `/admin` (e.g. `() => import('@/layouts/AdminLayout.vue')`). */
@@ -67,12 +75,14 @@ interface CreateAdminRoutesOptions {
 }
 declare function createAdminRoutes(options: CreateAdminRoutesOptions): RouteRecordRaw[];
 
-interface ApiListResponse<T> {
-    items: T[];
-    page?: number;
-    pageSize?: number;
-    total?: number;
-}
+/**
+ * The envelope a list endpoint may answer with.
+ *
+ * @deprecated Use `ResourceListPage`, which is this shape under the name the
+ * resource layer works with. Kept as an alias so an app that typed its own
+ * endpoint against it keeps compiling; one shape, one definition.
+ */
+type ApiListResponse<T> = ResourceListPage<T>;
 interface UseApiListOptions<TFilter> {
     endpoint: string;
     /**
@@ -127,6 +137,154 @@ interface UsePaginationResult<T> {
 }
 declare function usePagination<T>(rows: Ref<readonly T[]> | ComputedRef<readonly T[]>, initialRowsPerPage?: number): UsePaginationResult<T>;
 
+/**
+ * What an action did. `ok` is the branch to read — it answers for a
+ * `Promise<void>` action exactly as well as for one that returns a row.
+ */
+type AsyncActionResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: AdminError;
+};
+interface AsyncAction<A extends unknown[], T> {
+    /** Runs the action. Never throws; the outcome is in the result. */
+    run: (...args: A) => Promise<AsyncActionResult<T>>;
+    /** True while the call is in flight — what a submit button disables on. */
+    pending: Ref<boolean>;
+    /** The last failure, or `null`. Cleared at the start of every run. */
+    error: Ref<AdminError | null>;
+    /** Clears `error` without running anything. */
+    reset: () => void;
+}
+interface UseAsyncActionOptions<T> {
+    /**
+     * Which outcomes raise a toast. Default `'error'` — a success that changed
+     * something visible needs no announcement, a failure always does.
+     */
+    notifyOn?: 'error' | 'both' | 'none';
+    /** Text for the success toast. Required for `notifyOn: 'both'` to say anything. */
+    successMessage?: string | (() => string);
+    /**
+     * Overrides how a failure is worded.
+     *
+     * Not decoration: several pages map a status and an error code to a
+     * specific sentence — a 422 carrying `STRICT_MODE_VIOLATIONS` reads out the
+     * violations, a 401 says the session expired. `AdminError` carries
+     * `status`, `code` and `body`, so that mapping is a pure function of the
+     * error, and this is where it attaches.
+     */
+    errorMessage?: (error: AdminError) => string;
+    /** Runs after a successful call, before `run` resolves. */
+    onSuccess?: (result: T) => void | Promise<void>;
+    /**
+     * Notify port to report through. Defaults to the injected one.
+     *
+     * There is no fallback beyond that: this layer must not import Quasar, so
+     * it cannot reach `quasarNotify` the way a page can. Without a bootstrap
+     * and without this option, failures are reported through `error` alone.
+     */
+    notify?: UiNotify;
+}
+declare function useAsyncAction<A extends unknown[], T>(fn: (...args: A) => Promise<T>, options?: UseAsyncActionOptions<T>): AsyncAction<A, T>;
+
+interface AsyncData<T> {
+    /** The loaded value, or `initial` before the first load and after a failure. */
+    data: Ref<T>;
+    /** True while a load is in flight. */
+    pending: Ref<boolean>;
+    /** The last failure, or `null`. Cleared at the start of every load. */
+    error: Ref<AdminError | null>;
+    /** Loads again — after a mutation, or from a retry button. */
+    reload: () => Promise<void>;
+}
+interface UseAsyncDataOptions<T> {
+    /** Value before the first load, and the value restored when one fails. */
+    initial: T;
+    /** Load once on creation. Default `true`. */
+    immediate?: boolean;
+    /** Reload whenever any of these changes — a filter, a selected row, a locale. */
+    watch?: WatchSource[];
+}
+declare function useAsyncData<T>(fn: () => Promise<T>, options: UseAsyncDataOptions<T>): AsyncData<T>;
+
+/** The operations of a resource that answer with one page of a list. */
+type ListOpNames<TOps extends ResourceOps> = {
+    [N in keyof TOps]: Awaited<ReturnType<TOps[N]>> extends ResourceListPage<unknown> ? N : never;
+}[keyof TOps];
+/**
+ * The resources that have such an operation at all.
+ *
+ * Without this, `useResourceList('plans')` compiled: `plans.list` answers with
+ * a plain `PlanRow[]`, the row type collapsed to `never`, and the first thing
+ * to notice was `items.value` being `undefined` at runtime. Derived from the
+ * operations rather than listed, so a resource that grows a list operation
+ * becomes available here by being written, not by being remembered.
+ */
+type ListResourceKey<TMap extends ResourceMap> = {
+    [K in keyof TMap]: [ListOpNames<TMap[K]['ops']>] extends [never] ? never : K;
+}[keyof TMap];
+/**
+ * The row type a named list operation yields — read off the operation, not
+ * declared next to it. A hand-maintained map of resource to row is the same
+ * defect one level up: it can be right today and silently wrong tomorrow.
+ */
+type RowOf<TOps extends ResourceOps, N extends keyof TOps> = Awaited<ReturnType<TOps[N]>> extends ResourceListPage<infer TRow> ? TRow : never;
+/** A paginated read: what a standard admin list binds its table to. */
+interface AsyncList<T> {
+    /** The rows of the current page. */
+    items: ComputedRef<T[]>;
+    /**
+     * Rows matching the filter when the endpoint reports a total, and rows on
+     * this page when it does not. Several admin controllers answer with a bare
+     * array, and there is no honest way to tell the two apart afterwards — see
+     * `ResourceListPage.total`.
+     */
+    total: ComputedRef<number>;
+    /** 1-based. Moved by `goToPage`, and reset to 1 by a filter change. */
+    page: Ref<number>;
+    pageSize: Ref<number>;
+    /**
+     * True while a load is in flight. Named as in `useAsyncData` and
+     * `useAsyncAction`, whose flag this is — `useApiList` calls its own
+     * `loading`.
+     */
+    pending: Ref<boolean>;
+    /** The last failure, or `null`. Cleared at the start of every load. */
+    error: Ref<AdminError | null>;
+    /** Loads the current page again — after a mutation, or from a retry button. */
+    reload: () => Promise<void>;
+    /** Jumps to a page (1-based, clamped) and loads. */
+    goToPage: (page: number) => Promise<void>;
+    /** Changes the page size, returns to page 1, and loads. */
+    setPageSize: (size: number) => Promise<void>;
+}
+interface UseResourceListOptions<TOps extends ResourceOps, N extends ListOpNames<TOps>> {
+    /** Which operation to page through. Defaults to `list`. */
+    op?: N;
+    /**
+     * Reactive filter. A change returns to page 1 and reloads — a filter that
+     * narrows the list while the operator is on page 4 would otherwise ask for
+     * a page that no longer exists and render nothing.
+     *
+     * `page` and `pageSize` are not filter keys; see the guard below.
+     */
+    filter?: Ref<Record<string, unknown>>;
+    /**
+     * Rows per page to start with. Defaults to `LIST_PAGE_SIZE_DEFAULT`.
+     *
+     * Here rather than through `setPageSize` after construction, which is what
+     * a page with a `pageSize` prop had to do: `setPageSize` loads, and the
+     * first load was already queued, so the list fetched the same rows twice on
+     * every mount.
+     */
+    pageSize?: number;
+    /** Load once on creation. Default `true`. */
+    immediate?: boolean;
+}
+declare function useResourceList<K extends ListResourceKey<TMap> & keyof TMap & string, TMap extends ResourceMap = PlatformResources, N extends ListOpNames<TMap[K]['ops']> = ListOpNames<TMap[K]['ops']>>(key: K, opts?: UseResourceListOptions<TMap[K]['ops'], N>): AsyncList<RowOf<TMap[K]['ops'], N>>;
+
 interface UseTenantsOptions {
     /**
      * Fully qualified tenants-list endpoint including the app globalPrefix
@@ -768,6 +926,12 @@ interface UseDiscoveryOptions {
      */
     autoLoad?: boolean;
 }
+/**
+ * The discovery endpoint could not be read. Its `message` is a diagnostic for
+ * the log, in English like every other developer-facing string in the
+ * repository — the sentence a user is shown comes from the `errors` catalog
+ * through `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class DiscoveryLoadError extends Error {
     readonly status: number;
     constructor(status: number, message: string);
@@ -805,6 +969,12 @@ interface UseCatalogEntriesOptions {
     projectKey: string;
     autoLoad?: boolean;
 }
+/**
+ * A catalog-entries call failed. Its `message` is a diagnostic for the log, in
+ * English like every other developer-facing string in the repository — the
+ * sentence a user is shown comes from the `errors` catalog through
+ * `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class CatalogEntriesApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -946,6 +1116,12 @@ interface UseMarketingProjectionsOptions {
     filter: MarketingProjectionFilter;
     autoLoad?: boolean;
 }
+/**
+ * A marketing-projections call failed. Its `message` is a diagnostic for the
+ * log, in English like every other developer-facing string in the repository —
+ * the sentence a user is shown comes from the `errors` catalog through
+ * `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class MarketingProjectionsApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -972,6 +1148,12 @@ interface UsePromotionsOptions {
     projectKey: string;
     autoLoad?: boolean;
 }
+/**
+ * A promotions call failed. Its `message` is a diagnostic for the log, in
+ * English like every other developer-facing string in the repository — the
+ * sentence a user is shown comes from the `errors` catalog through
+ * `adminErrorMessage`, in whichever language the shell speaks.
+ */
 declare class PromotionsApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -1323,6 +1505,14 @@ interface PlatformLoaders {
     bootLoader: BootLoader;
     manifestLoader: ManifestLoader;
 }
+/**
+ * Fills in what an app left out.
+ *
+ * Exported because the bootstrap needs the same answer, and two copies of a
+ * default are two places for it to drift — which is how `projectKey` was
+ * added to one of them and not the other.
+ */
+declare function resolveSuperAdminEndpoints(endpoints: SuperAdminEndpoints): Required<SuperAdminEndpoints>;
 /**
  * Builds `BootLoader` + `ManifestLoader` from a single endpoint constant.
  * Apps use the same constant for `createSuperAdminApp({ endpoints })`.
@@ -1841,4 +2031,4 @@ interface PlanChangeWizardI18n {
  */
 declare function planChangeWizardI18n(i18n: TenantPlanSectionI18n): PlanChangeWizardI18n;
 
-export { ALL_ROWS, ActionHandler, ActionRegistry, ActionsMap, type ApiListResponse, BatchColumnData, BatchColumnFetcherOptions, type BillingCycleStr, BootLoader, BootLoaderOptions, BuildRouteEntry, type BulkItemKind, type BulkItemStatus, type BulkPublishItem, type BundleAddPreviewShape, type BundleCancelPreviewShape, type BundlePreviewIssueShape, type BundlePreviewShape, type BundlePreviewSnapshotShape, BundlesApiError, CATALOG_DEFAULT_LOCALE, type CatalogBundle, CatalogEntriesApiError, type CatalogPlan, type ConfirmDialogState, type CreateAdminRoutesOptions, type CreateManifestStoreOptions, type CreatePlatformLoadersOptions, DEFAULT_I18N_DE, DEFAULT_I18N_EN, DEFAULT_ROWS_PER_PAGE, DEFAULT_YEARLY_FACTOR, DiscoveryLoadError, type DraftPricing, ENTITLEMENT_INJECTION_KEY, type EmailHistoryDetail, type EmailHistoryFilter, type EmailHistoryListResult, type EmailHistoryResendResult, type EmailHistoryRow, type EmailHistoryStatus, type EntitlementSnapshotShape, ExtensionsMap, type FeatureRegistryEntry, type FeatureRouterGuardOptions, type FeatureRowMarkers, HttpClient, KvStore, ManifestLoader, ManifestLoaderOptions, type ManifestStoreActions, type ManifestStoreDefinition, type ManifestStoreState, MarketingProjectionsApiError, type MfaDialogState, NavBuilderOptions, PAGE_SIZE_OPTIONS, type PackageSnapshotShape, type PilotCopy, type PilotCreatePayload, type PilotCreateResult, type PilotEditPayload, type PilotEditResult, type PlanChangePreviewShape, type PlanChangeWizardI18n, type PlanSnapshotShape, PlannedOnlyFeatureError, PlansApiError, type PlatformEmailProvider, type PlatformEmailTestInput, type PlatformEmailTestResult, type PlatformEmailWriteInput, type PlatformLoaders, type PlatformTenantActionRow, type PlatformTenantActionTone, type PlatformTenantActionsOptions, type PlatformTenantActionsResult, type PriceLineItem, ProjectPageHost, type PromoCodeCreatePayload, type PromoCodeDurationType, type PromoCodePlanOption, type PromoCodeUpdatePayload, type PromoCodeValueType, type PromoState, type PromoStatus, PromotionsApiError, type QuotaMeta, type RedundantFeatureHintShape, type ResolvedTenantAction, SERVER_PAGE_SIZE_OPTIONS, SaLocale, SidebarSection, type SubscriptionBundleShape, type SubscriptionDraft, SuperAdminBrand, SuperAdminEndpoints, SuperAdminLoginAdapter, type TenantActionFlowProviders, type TenantActionInput, type TenantManifestNavItem, type TenantManifestShape, type TenantPlanSectionI18n, type TenantRowLike, TenantSubscriptionBundlesApiError, type UsageSnapshotShape, type UseActionsResult, type UseApiListOptions, type UseApiListResult, type UseAuditEntriesOptions, type UseAuditEntriesResult, type UseBatchColumnsResult, type UseBulkPublishOptions, type UseBulkPublishResult, type UseBundleVersionsMapOptions, type UseBundleVersionsMapResult, type UseBundleVersionsOptions, type UseBundleVersionsResult, type UseBundlesOptions, type UseBundlesResult, type UseCatalogEntriesOptions, type UseCatalogEntriesResult, type UseDiscoveryOptions, type UseDiscoveryResult, type UseEntitlementOptions, type UseEntitlementResult, type UseLivePlanVersionsOptions, type UseLivePlanVersionsResult, type UseManifestResult, type UseMarketingProjectionsOptions, type UseMarketingProjectionsResult, type UseNavResult, type UsePaginationResult, type UsePlanEditorOptions, type UsePlanEditorResult, type UsePlanVersionsOptions, type UsePlanVersionsResult, type UsePlansOptions, type UsePlansResult, type UsePromotionsOptions, type UsePromotionsResult, type UsePublicBootResult, type UseSubscriptionDraftOptions, type UseTenantActionFlowResult, type UseTenantBillingCatalogOptions, type UseTenantBillingCatalogResult, type UseTenantBillingOptions, type UseTenantBillingResult, type UseTenantManifestOptions, type UseTenantManifestResult, type UseTenantSubscriptionBundlesOptions, type UseTenantSubscriptionBundlesResult, type UseTenantsOptions, type UseTenantsResult, buildFeatureRegistry, buildFeatureRouterGuard, buildQuotaRegistry, createAdminRoutes, createManifestStore, createPlatformLoaders, createProjectPageHostRoute, defaultIconForActionKey, defaultTenantPlanSectionI18n, defaultToneForActionKey, planChangeWizardI18n, provideEntitlement, useActions, useApiList, useAuditEntries, useBatchColumns, useBulkPublish, useBundleVersions, useBundleVersionsMap, useBundles, useCatalogEntries, useDiscovery, useEntitlement, useInjectedEntitlement, useLivePlanVersions, useManifest, useMarketingProjections, useNav, usePagination, usePlanEditor, usePlanVersions, usePlans, usePlatformTenantActions, usePromotions, usePublicBoot, useSubscriptionDraft, useSuperAdminActions, useSuperAdminBrand, useSuperAdminEndpoints, useSuperAdminExtensions, useSuperAdminHttp, useSuperAdminLoginAdapter, useSuperAdminManifest, useTenantActionFlow, useTenantBilling, useTenantBillingCatalog, useTenantManifest, useTenantSubscriptionBundles, useTenants };
+export { ALL_ROWS, ActionHandler, ActionRegistry, ActionsMap, AdminError, type ApiListResponse, type AsyncAction, type AsyncActionResult, type AsyncData, type AsyncList, BatchColumnData, BatchColumnFetcherOptions, type BillingCycleStr, BootLoader, BootLoaderOptions, BuildRouteEntry, type BulkItemKind, type BulkItemStatus, type BulkPublishItem, type BundleAddPreviewShape, type BundleCancelPreviewShape, type BundlePreviewIssueShape, type BundlePreviewShape, type BundlePreviewSnapshotShape, BundlesApiError, CATALOG_DEFAULT_LOCALE, type CatalogBundle, CatalogEntriesApiError, type CatalogPlan, type ConfirmDialogState, type CreateAdminRoutesOptions, type CreateManifestStoreOptions, type CreatePlatformLoadersOptions, DEFAULT_I18N_DE, DEFAULT_I18N_EN, DEFAULT_ROWS_PER_PAGE, DEFAULT_YEARLY_FACTOR, DiscoveryLoadError, type DraftPricing, ENTITLEMENT_INJECTION_KEY, type EmailHistoryDetail, type EmailHistoryFilter, type EmailHistoryListResult, type EmailHistoryResendResult, type EmailHistoryRow, type EmailHistoryStatus, type EntitlementSnapshotShape, ExtensionsMap, type FeatureRegistryEntry, type FeatureRouterGuardOptions, type FeatureRowMarkers, HttpClient, KvStore, type ListOpNames, type ListResourceKey, ManifestLoader, ManifestLoaderOptions, type ManifestStoreActions, type ManifestStoreDefinition, type ManifestStoreState, MarketingProjectionsApiError, type MfaDialogState, NavBuilderOptions, PAGE_SIZE_OPTIONS, type PackageSnapshotShape, type PilotCopy, type PilotCreatePayload, type PilotCreateResult, type PilotEditPayload, type PilotEditResult, type PlanChangePreviewShape, type PlanChangeWizardI18n, type PlanSnapshotShape, PlannedOnlyFeatureError, PlansApiError, type PlatformEmailProvider, type PlatformEmailTestInput, type PlatformEmailTestResult, type PlatformEmailWriteInput, type PlatformLoaders, PlatformResources, type PlatformTenantActionRow, type PlatformTenantActionTone, type PlatformTenantActionsOptions, type PlatformTenantActionsResult, type PriceLineItem, ProjectPageHost, type PromoCodeCreatePayload, type PromoCodeDurationType, type PromoCodePlanOption, type PromoCodeUpdatePayload, type PromoCodeValueType, type PromoState, type PromoStatus, PromotionsApiError, type QuotaMeta, type RedundantFeatureHintShape, type ResolvedTenantAction, ResourceListPage, ResourceMap, ResourceOps, type RowOf, SERVER_PAGE_SIZE_OPTIONS, SaLocale, SidebarSection, type SubscriptionBundleShape, type SubscriptionDraft, SuperAdminBrand, SuperAdminEndpoints, SuperAdminLoginAdapter, type TenantActionFlowProviders, type TenantActionInput, type TenantManifestNavItem, type TenantManifestShape, type TenantPlanSectionI18n, type TenantRowLike, TenantSubscriptionBundlesApiError, UiNotify, type UsageSnapshotShape, type UseActionsResult, type UseApiListOptions, type UseApiListResult, type UseAsyncActionOptions, type UseAsyncDataOptions, type UseAuditEntriesOptions, type UseAuditEntriesResult, type UseBatchColumnsResult, type UseBulkPublishOptions, type UseBulkPublishResult, type UseBundleVersionsMapOptions, type UseBundleVersionsMapResult, type UseBundleVersionsOptions, type UseBundleVersionsResult, type UseBundlesOptions, type UseBundlesResult, type UseCatalogEntriesOptions, type UseCatalogEntriesResult, type UseDiscoveryOptions, type UseDiscoveryResult, type UseEntitlementOptions, type UseEntitlementResult, type UseLivePlanVersionsOptions, type UseLivePlanVersionsResult, type UseManifestResult, type UseMarketingProjectionsOptions, type UseMarketingProjectionsResult, type UseNavResult, type UsePaginationResult, type UsePlanEditorOptions, type UsePlanEditorResult, type UsePlanVersionsOptions, type UsePlanVersionsResult, type UsePlansOptions, type UsePlansResult, type UsePromotionsOptions, type UsePromotionsResult, type UsePublicBootResult, type UseResourceListOptions, type UseSubscriptionDraftOptions, type UseTenantActionFlowResult, type UseTenantBillingCatalogOptions, type UseTenantBillingCatalogResult, type UseTenantBillingOptions, type UseTenantBillingResult, type UseTenantManifestOptions, type UseTenantManifestResult, type UseTenantSubscriptionBundlesOptions, type UseTenantSubscriptionBundlesResult, type UseTenantsOptions, type UseTenantsResult, buildFeatureRegistry, buildFeatureRouterGuard, buildQuotaRegistry, createAdminRoutes, createManifestStore, createPlatformLoaders, createProjectPageHostRoute, defaultIconForActionKey, defaultTenantPlanSectionI18n, defaultToneForActionKey, planChangeWizardI18n, provideEntitlement, resolveSuperAdminEndpoints, useActions, useApiList, useAsyncAction, useAsyncData, useAuditEntries, useBatchColumns, useBulkPublish, useBundleVersions, useBundleVersionsMap, useBundles, useCatalogEntries, useDiscovery, useEntitlement, useInjectedEntitlement, useLivePlanVersions, useManifest, useMarketingProjections, useNav, usePagination, usePlanEditor, usePlanVersions, usePlans, usePlatformTenantActions, usePromotions, usePublicBoot, useResourceList, useSubscriptionDraft, useSuperAdminActions, useSuperAdminBrand, useSuperAdminEndpoints, useSuperAdminExtensions, useSuperAdminHttp, useSuperAdminLoginAdapter, useSuperAdminManifest, useTenantActionFlow, useTenantBilling, useTenantBillingCatalog, useTenantManifest, useTenantSubscriptionBundles, useTenants };