@saasicat/ui-vue 1.0.0-rc.2 → 1.0.0-rc.4

package/README.md

@@ -1,5 +1,7 @@
 # @saasicat/ui-vue
 
+## What this is
+
 Vue 3 components + composables for the SuperAdmin UI shell. Provides the
 boot loader, manifest loader (ETag cache), nav builder, action registry,
 standard pages (Dashboard, Tenants, Plans, Discovery, …) and the tenant
@@ -9,18 +11,45 @@ self-service building blocks (`FeatureGate`, `useTenantManifest`,
 Peer dependencies: `vue` (required); `vue-router`, `pinia`, `quasar`
 (optional — see the layers below for what actually needs them).
 
-## Layers
-
-The package is layered so that each entry only loads what it names.
-Lower layers never import upward; ESLint (`no-restricted-imports`, repo
-root config) enforces the boundaries in CI.
-
-| Entry                                                                                           | Source                           | May import                               | Contents                                                                                                                                                                                                                                                         |
-| ----------------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `@saasicat/ui-vue/client`                                                                       | `src/client/`                    | `@saasicat/core` only                    | Framework-free core: `BootLoader`, `ManifestLoader` (ETag cache), nav builder, action registry, batch column fetcher, the `HttpClient`/`KvStore` contract with its `fetch` and axios adapters, `AdminError`. Usable from any framework or plain Node/TypeScript. |
-| `@saasicat/ui-vue` (main)                                                                       | `src/vue/` (+ client re-exports) | Vue, `vue-router`, Pinia — **no Quasar** | Composables (`useTenants`, `usePlanEditor`, …), router guards, injection keys + shell contract, notify-port type, optional Pinia store factory.                                                                                                                  |
-| `@saasicat/ui-vue/quasar`                                                                       | `src/quasar/`                    | everything above + Quasar                | `createSuperAdminApp()` bootstrap and the Quasar notify-port implementation.                                                                                                                                                                                     |
-| `@saasicat/ui-vue/pages/*.vue`, `/layouts/*.vue`, `/auth/*.vue`, `/ui/*.vue`, `/pages-tenant/*` | SFC directories                  | everything                               | The Quasar reference UI, shipped as raw `.vue` from `src/` (compiled by the consumer's Vite).                                                                                                                                                                    |
+## What this is not
+
+Not a component library to pick from. It is the SuperAdmin application's
+inside: complete pages, the shell around them, the theme they read and the
+data layer beneath them. Taking one primitive out of context is possible and
+rarely what you want.
+
+Not a design system for your product, either. The `Admin*` roster exists for
+admin surfaces; everything else is Quasar, styled through the theme.
+
+Not compiled for the subpaths that ship `.vue` and `.ts` from `src/` — your
+build compiles those, which is what makes Quasar and Sass theming work and why
+that source stays within ES2021.
+
+## Entry points
+
+The package is layered so that each entry only loads what it names. Lower
+layers never import upward, and ESLint enforces it — the reasoning is in
+[ADR 0004](../../docs/explanation/adr/0004-ui-vue-layer-boundaries.md).
+
+| Entry                 | Source          | May import                    | When you take it                                                                                                                                                                     |
+| --------------------- | --------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `./client`            | `src/client/`   | `@saasicat/core` only         | Framework-free: loaders, nav builder, action registry, the resource descriptors, `HttpClient`/`KvStore` with their `fetch` and axios adapters, `AdminError`. Usable from plain Node. |
+| `.`                   | `src/vue/`      | Vue, `vue-router`, Pinia      | Composables, router guards, injection keys, `createAdminRoutes`, the store factory. No Quasar.                                                                                       |
+| `./quasar`            | `src/quasar/`   | everything above, plus Quasar | `createSuperAdminApp()` and the Quasar implementations of the notify and confirm ports.                                                                                              |
+| `./pages`             | `src/pages/`    | everything                    | `standardAdminChildren()` — the platform's own screens as route children.                                                                                                            |
+| `./pages/*.vue`       | `src/pages/`    | everything                    | One standard page, when you mount it yourself.                                                                                                                                       |
+| `./layouts/*.vue`     | `src/layouts/`  | everything                    | `AdminLayout` — the shell around the pages.                                                                                                                                          |
+| `./auth/*.vue`        | `src/auth/`     | everything                    | The login screen and the first-run setup wizard.                                                                                                                                     |
+| `./ui/*.vue`          | `src/ui/`       | everything                    | The `Admin*` primitives, when you build a page of your own.                                                                                                                          |
+| `./theme.css`         | `src/ui/theme/` | —                             | The stylesheet. Import it once; without it the pages render unstyled.                                                                                                                |
+| `./theme/*`           | `src/ui/theme/` | —                             | The individual token layers, for a consumer that overrides roles.                                                                                                                    |
+| `./theme/breakpoints` | `src/ui/theme/` | —                             | The five breakpoint values, for a build that needs them in JavaScript.                                                                                                               |
+| `./vue`               | `src/vue/`      | Vue, `vue-router`, Pinia      | The Vue layer alone, without the client re-exports.                                                                                                                                  |
+| `./testing/*`         | `src/testing/`  | everything                    | Fixtures for component and end-to-end tests against the pages.                                                                                                                       |
+
+The four subpaths that hand out `.vue` and `.ts` from `src/` are compiled by
+**your** build, which is what makes Quasar and Sass theming work —
+[ADR 0005](../../docs/explanation/adr/0005-ship-sfc-source-not-dist.md).
 
 ### The shipped source has a language floor
 
@@ -125,7 +154,8 @@ pnpm create saasicat-admin admin --project-key=myapp
 ```
 
 See the [quickstart](https://github.com/uelker70/saasicat/blob/main/docs/quickstart.md) (step 9) for the full setup
-and the [handbook](https://github.com/uelker70/saasicat/blob/main/docs/handbook.md) for the architecture.
+and the [architecture](https://github.com/uelker70/saasicat/blob/main/docs/explanation/architecture.md)
+for how the pieces fit.
 
 ## Language
 
@@ -145,7 +175,7 @@ own call: `i18n.locales` narrows the set, `i18n.additionalLocales` adds
 languages the platform does not ship, `i18n.overrides` replaces individual
 strings, and `i18n.switcher: false` drops the control entirely. Components read
 the catalog via `useSaMessages('<namespace>')` / `useSuperAdminI18n()`.
-See [handbook §8.7](https://github.com/uelker70/saasicat/blob/main/docs/handbook.md#87-ui-language-i18n).
+See [UI language](https://github.com/uelker70/saasicat/blob/main/docs/guides/build-the-admin-frontend.md#ui-language-i18n).
 
 ## Build
 
@@ -155,3 +185,9 @@ pnpm --filter @saasicat/ui-vue build
 
 Produces `dist/{index,client/index,quasar/index}.{js,cjs,d.ts}` via tsup
 (`tsup.config.ts`); `vue`, `vue-router`, `pinia` and `quasar` stay external.
+
+## Next
+
+- [Build the admin frontend](../../docs/guides/build-the-admin-frontend.md) — wiring it into an app
+- [Design guide](../../docs/explanation/design-guide.md) — the page recipe and the colour roles
+- [Pages take resources, not callbacks](../../docs/explanation/adr/0008-resource-ports-over-props.md)

package/dist/.build-stamp

@@ -1 +1 @@
-14b1904cc8763759de50625a5589d989cdf7e6be7f84abe3f6c54aa3ca8ac9ae
+024a49d3b5411560f32b7690e677e4a35c170ed8457314fd33c2493b868a2cc9

package/dist/{batch-column-fetcher-VwjOxerL.d.ts → batch-column-fetcher-BsX1cJiU.d.ts}

@@ -1,4 +1,4 @@
-import { a5 as SaMessages, H as HttpClient, l as KvStore, a2 as SaLocale, aA as SaNavMessages } from './catalog-C5VKGbxk.js';
+import { a5 as SaMessages, H as HttpClient, l as KvStore, a2 as SaLocale, aA as SaNavMessages } from './catalog-D257Y044.js';
 import { PublicBootResponse, AdminManifest, StandardPageKey, TenantColumnDef } from '@saasicat/core';
 
 /**

package/dist/{batch-column-fetcher-Dk9X92db.d.cts → batch-column-fetcher-DLq3zI7m.d.cts}

@@ -1,4 +1,4 @@
-import { a5 as SaMessages, H as HttpClient, l as KvStore, a2 as SaLocale, aA as SaNavMessages } from './catalog-C5VKGbxk.cjs';
+import { a5 as SaMessages, H as HttpClient, l as KvStore, a2 as SaLocale, aA as SaNavMessages } from './catalog-D257Y044.cjs';
 import { PublicBootResponse, AdminManifest, StandardPageKey, TenantColumnDef } from '@saasicat/core';
 
 /**

package/dist/{catalog-C5VKGbxk.d.cts → catalog-D257Y044.d.cts}

@@ -1320,8 +1320,10 @@ declare const marketingMessages: Record<SaBuiltinLocale, {
         colPlan: string;
         colVisible: string;
         colBadge: string;
-        colPriority: string;
+        colOrder: string;
         colHighlight: string;
+        reorderLabel: string;
+        reorderTitle: string;
         versionTabsLabel: string;
         versionTitle: string;
         versionValidFromUnknown: string;

package/dist/{catalog-C5VKGbxk.d.ts → catalog-D257Y044.d.ts}

@@ -1320,8 +1320,10 @@ declare const marketingMessages: Record<SaBuiltinLocale, {
         colPlan: string;
         colVisible: string;
         colBadge: string;
-        colPriority: string;
+        colOrder: string;
         colHighlight: string;
+        reorderLabel: string;
+        reorderTitle: string;
         versionTabsLabel: string;
         versionTitle: string;
         versionValidFromUnknown: string;

package/dist/{chunk-6X6AGH66.js → chunk-6B5WYQFC.js}

@@ -3,7 +3,7 @@ import {
   defaultHttpClient,
   isSaBuiltinLocale,
   navMessages
-} from "./chunk-P4EJF43F.js";
+} from "./chunk-RJDW4RJT.js";
 
 // src/client/nav-builder.ts
 var DEFAULT_STANDARD_PAGE_ROUTES = {

package/dist/{chunk-L7HPDVHV.js → chunk-JXHRJ2ZD.js}

@@ -3,7 +3,7 @@ import {
   isAxiosNoResponseError,
   markTransportFailure,
   trimTrailingSlashes
-} from "./chunk-P4EJF43F.js";
+} from "./chunk-RJDW4RJT.js";
 
 // src/client/version.ts
 var ADMIN_UI_VERSION = "1.2.0";
@@ -173,6 +173,38 @@ function isProductionBoot(boot) {
   return boot?.project?.environment === "production";
 }
 
+// src/client/reorder-priorities.ts
+import { MARKETING_PRIORITY_MAX, MARKETING_PRIORITY_MIN } from "@saasicat/core";
+function reorderedPriorities(priorities, from, to) {
+  const count = priorities.length;
+  if (from === to || from < 0 || to < 0 || from >= count || to >= count) {
+    return priorities.map(() => null);
+  }
+  const order = priorities.map((_, index) => index);
+  order.splice(to, 0, ...order.splice(from, 1));
+  const values = descendingDistinct(priorities);
+  const next = priorities.map(() => null);
+  order.forEach((originalIndex, position) => {
+    const value = values[position];
+    if (value !== priorities[originalIndex]) next[originalIndex] = value;
+  });
+  return next;
+}
+function descendingDistinct(priorities) {
+  const values = [...priorities].sort((a, b) => b - a);
+  const count = values.length;
+  for (let i = 0; i < count; i++) {
+    values[i] = Math.min(values[i], MARKETING_PRIORITY_MAX - i);
+  }
+  for (let i = 1; i < count; i++) {
+    values[i] = Math.min(values[i], values[i - 1] - 1);
+  }
+  for (let i = count - 1; i >= 0; i--) {
+    values[i] = Math.max(values[i], MARKETING_PRIORITY_MIN + (count - 1 - i));
+  }
+  return values;
+}
+
 // src/client/resolve-plans.ts
 function todayIsoDate() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -311,6 +343,7 @@ export {
   createAdminResourceClient,
   resolveLoginBranding,
   isProductionBoot,
+  reorderedPriorities,
   todayIsoDate,
   isCurrentlyValid,
   isFutureScheduled,

package/dist/{chunk-P4EJF43F.js → chunk-RJDW4RJT.js}

@@ -2420,8 +2420,10 @@ var marketingMessages = defineMessages(
       colPlan: "Plan",
       colVisible: "Sichtbar",
       colBadge: "Badge",
-      colPriority: "Priorit\xE4t",
+      colOrder: "Reihenfolge",
       colHighlight: "Highlight",
+      reorderLabel: "{plan} verschieben \xB7 Position {position} von {total}",
+      reorderTitle: "Ziehen oder Pfeiltasten: Reihenfolge \xE4ndern",
       versionTabsLabel: "Plan-Versionen f\xFCr {plan}",
       versionTitle: "Version {version}: g\xFCltig {from} bis {until}{changeNote}",
       versionValidFromUnknown: "unbekannt",
@@ -2544,8 +2546,10 @@ var marketingMessages = defineMessages(
       colPlan: "Plan",
       colVisible: "Visible",
       colBadge: "Badge",
-      colPriority: "Priority",
+      colOrder: "Order",
       colHighlight: "Highlight",
+      reorderLabel: "Move {plan} \xB7 position {position} of {total}",
+      reorderTitle: "Drag or use the arrow keys to reorder",
       versionTabsLabel: "Plan versions for {plan}",
       versionTitle: "Version {version}: valid {from} to {until}{changeNote}",
       versionValidFromUnknown: "unknown",

package/dist/{chunk-A7JICGQ5.js → chunk-U634B27W.js}

@@ -4,7 +4,7 @@ import {
   bindResource,
   createSaCatalog,
   defaultKvStore
-} from "./chunk-P4EJF43F.js";
+} from "./chunk-RJDW4RJT.js";
 
 // src/vue/super-admin-context.ts
 var SUPER_ADMIN_BRAND_KEY = /* @__PURE__ */ Symbol.for(

package/dist/{chunk-4CJBABLZ.js → chunk-UHNJ2W3B.js}

@@ -4,7 +4,7 @@ import {
   buildRoutes,
   buildSidebar,
   defaultSectionOrder
-} from "./chunk-6X6AGH66.js";
+} from "./chunk-6B5WYQFC.js";
 import {
   SUPER_ADMIN_ACTIONS_KEY,
   SUPER_ADMIN_BRAND_KEY,
@@ -17,7 +17,7 @@ import {
   useResource,
   useSaMessages,
   useSuperAdminI18n
-} from "./chunk-A7JICGQ5.js";
+} from "./chunk-U634B27W.js";
 import {
   AdminError,
   BootLoader,
@@ -38,7 +38,7 @@ import {
   requireServerAnswer,
   toAdminError,
   trimTrailingSlashes
-} from "./chunk-P4EJF43F.js";
+} from "./chunk-RJDW4RJT.js";
 
 // src/vue/status.ts
 var PROMO_STATUS_TONE = {
@@ -2636,15 +2636,63 @@ function useBatchColumns(manifest, tenantIds, options = {}) {
   return { data, loading, error, reload: load };
 }
 
+// src/vue/use-row-reorder.ts
+import { onScopeDispose, ref as ref28 } from "vue";
+function useRowReorder(rowCount, handleOf, onDrop) {
+  const draggingIndex = ref28(null);
+  const targetIndex = ref28(null);
+  function positionAt(clientY, from) {
+    const count = rowCount();
+    let insertAt = count;
+    for (let index = 0; index < count; index++) {
+      const rect = handleOf(index)?.getBoundingClientRect();
+      if (rect && clientY < rect.top + rect.height / 2) {
+        insertAt = index;
+        break;
+      }
+    }
+    return insertAt > from ? insertAt - 1 : insertAt;
+  }
+  function onMove(event) {
+    if (draggingIndex.value === null) return;
+    targetIndex.value = positionAt(event.clientY, draggingIndex.value);
+  }
+  function onUp() {
+    const from = draggingIndex.value;
+    const to = targetIndex.value;
+    stop();
+    if (from !== null && to !== null && from !== to) onDrop(from, to);
+  }
+  function stop() {
+    draggingIndex.value = null;
+    targetIndex.value = null;
+    document.removeEventListener("pointermove", onMove);
+    document.removeEventListener("pointerup", onUp);
+    document.removeEventListener("pointercancel", stop);
+  }
+  function start(index, event) {
+    if (event.button !== 0) return;
+    event.preventDefault();
+    draggingIndex.value = index;
+    targetIndex.value = index;
+    event.currentTarget?.setPointerCapture?.(event.pointerId);
+    document.addEventListener("pointermove", onMove);
+    document.addEventListener("pointerup", onUp);
+    document.addEventListener("pointercancel", stop);
+  }
+  onScopeDispose(stop);
+  return { draggingIndex, targetIndex, start };
+}
+
 // src/vue/manifest-store-factory.ts
 import { defineStore } from "pinia";
-import { ref as ref28 } from "vue";
+import { ref as ref29 } from "vue";
 function createManifestStore(options) {
   return defineStore(options.id ?? "admin-manifest", () => {
-    const manifest = ref28(null);
-    const loading = ref28(false);
-    const error = ref28(null);
-    const loaded = ref28(false);
+    const manifest = ref29(null);
+    const loading = ref29(false);
+    const error = ref29(null);
+    const loaded = ref29(false);
     let inflight = null;
     async function load() {
       loading.value = true;
@@ -2748,5 +2796,6 @@ export {
   defaultToneForActionKey,
   usePlatformTenantActions,
   useBatchColumns,
+  useRowReorder,
   createManifestStore
 };

package/dist/client/index.cjs

@@ -107,6 +107,7 @@ __export(client_exports, {
   readErrorCode: () => readErrorCode,
   readErrorDetail: () => readErrorDetail,
   readListPage: () => readListPage,
+  reorderedPriorities: () => reorderedPriorities,
   requestJson: () => requestJson,
   requestJsonBody: () => requestJsonBody,
   requireServerAnswer: () => requireServerAnswer,
@@ -3056,8 +3057,10 @@ var marketingMessages = defineMessages(
       colPlan: "Plan",
       colVisible: "Sichtbar",
       colBadge: "Badge",
-      colPriority: "Priorit\xE4t",
+      colOrder: "Reihenfolge",
       colHighlight: "Highlight",
+      reorderLabel: "{plan} verschieben \xB7 Position {position} von {total}",
+      reorderTitle: "Ziehen oder Pfeiltasten: Reihenfolge \xE4ndern",
       versionTabsLabel: "Plan-Versionen f\xFCr {plan}",
       versionTitle: "Version {version}: g\xFCltig {from} bis {until}{changeNote}",
       versionValidFromUnknown: "unbekannt",
@@ -3180,8 +3183,10 @@ var marketingMessages = defineMessages(
       colPlan: "Plan",
       colVisible: "Visible",
       colBadge: "Badge",
-      colPriority: "Priority",
+      colOrder: "Order",
       colHighlight: "Highlight",
+      reorderLabel: "Move {plan} \xB7 position {position} of {total}",
+      reorderTitle: "Drag or use the arrow keys to reorder",
       versionTabsLabel: "Plan versions for {plan}",
       versionTitle: "Version {version}: valid {from} to {until}{changeNote}",
       versionValidFromUnknown: "unknown",
@@ -5055,6 +5060,38 @@ function isProductionBoot(boot) {
   return boot?.project?.environment === "production";
 }
 
+// src/client/reorder-priorities.ts
+var import_core2 = require("@saasicat/core");
+function reorderedPriorities(priorities, from, to) {
+  const count = priorities.length;
+  if (from === to || from < 0 || to < 0 || from >= count || to >= count) {
+    return priorities.map(() => null);
+  }
+  const order = priorities.map((_, index) => index);
+  order.splice(to, 0, ...order.splice(from, 1));
+  const values = descendingDistinct(priorities);
+  const next = priorities.map(() => null);
+  order.forEach((originalIndex, position) => {
+    const value = values[position];
+    if (value !== priorities[originalIndex]) next[originalIndex] = value;
+  });
+  return next;
+}
+function descendingDistinct(priorities) {
+  const values = [...priorities].sort((a, b) => b - a);
+  const count = values.length;
+  for (let i = 0; i < count; i++) {
+    values[i] = Math.min(values[i], import_core2.MARKETING_PRIORITY_MAX - i);
+  }
+  for (let i = 1; i < count; i++) {
+    values[i] = Math.min(values[i], values[i - 1] - 1);
+  }
+  for (let i = count - 1; i >= 0; i--) {
+    values[i] = Math.max(values[i], import_core2.MARKETING_PRIORITY_MIN + (count - 1 - i));
+  }
+  return values;
+}
+
 // src/client/resolve-plans.ts
 function todayIsoDate() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -5275,6 +5312,7 @@ function trimChar(value, ch) {
   readErrorCode,
   readErrorDetail,
   readListPage,
+  reorderedPriorities,
   requestJson,
   requestJsonBody,
   requireServerAnswer,

package/dist/client/index.d.cts

@@ -1,7 +1,7 @@
-import { H as HttpClient, T as ResourceDef, S as ResourceContext, y as PilotRow, u as PilotCreatePayload, v as PilotCreateResult, w as PilotEditPayload, x as PilotEditResult, f as EmailHistoryFilter, g as EmailHistoryListResult, E as EmailHistoryDetail, h as EmailHistoryResendResult, z as PlatformEmailProvider, G as PlatformEmailWriteInput, C as PlatformEmailTestInput, F as PlatformEmailTestResult, a2 as SaLocale } from '../catalog-C5VKGbxk.cjs';
-export { A as ActionDefNotInManifestError, a as ActionHandler, b as ActionRegistry, c as AuditListFilter, B as Bound, D as DEFAULT_SA_LOCALE, d as DefineResourceOptions, e as DiscoveryRead, i as EmailHistoryRow, k as HttpResponse, K as KpiReading, l as KvStore, L as LIST_FIRST_PAGE, m as LIST_PAGE_SIZE_DEFAULT, n as LIST_PAGE_SIZE_MAX, o as LIST_PAGINATION_PARAMS, p as ListFilterOf, q as ListOp, r as ListQuery, M as MarketingProjectionsFilter, s as MessageTree, t as MissingHandlerError, P as PartialMessages, I as PlatformResources, J as PromoCodesFilter, N as PromoDetail, O as PublishBundleVersionOptions, Q as PublishPlanVersionOptions, R as ResolvedAction, U as ResourceListPage, V as ResourceOp, W as ResourceOps, X as SA_INTL_LOCALES, Y as SA_LOCALES, Z as SA_LOCALE_LABELS, _ as SA_MESSAGES, $ as SaBuiltinLocale, a0 as SaCatalog, a1 as SaCatalogOptions, a3 as SaLocaleDefinition, a4 as SaLocaleOption, a5 as SaMessages, a6 as SaMessagesOverrides, a7 as TenantsListFilter, a8 as TranslationOf, a9 as auditResource, aa as bindResource, ab as bundleVersionsResource, ac as bundlesResource, ad as clampListPage, ae as clampListPageSize, af as createSaCatalog, ag as dashboardResource, ah as defaultHttpClient, ai as defaultKvStore, aj as defineListOp, ak as defineMessages, al as defineResource, am as discoveryResource, an as filterQueryString, ao as isSaBuiltinLocale, ap as isSentInQuery, aq as listUrl, ar as marketingResource, as as mergeMessages, at as planVersionsResource, au as plansResource, av as platformResources, aw as promoCodesResource, ax as readListPage, ay as resolveMessages, az as tenantsResource } from '../catalog-C5VKGbxk.cjs';
-import { A as AdminError } from '../batch-column-fetcher-Dk9X92db.cjs';
-export { a as AdminErrorInit, B as BatchColumnData, b as BatchColumnDriftError, c as BatchColumnFetcher, d as BatchColumnFetcherOptions, e as BatchColumnRow, f as BatchColumnValue, g as BootLoadError, h as BootLoader, i as BootLoaderOptions, j as BuildRouteEntry, C as CachedManifestEntry, D as DEFAULT_STANDARD_PAGE_ROUTES, M as ManifestLoadError, k as ManifestLoader, l as ManifestLoaderOptions, N as NavBuilderOptions, P as ParamStyle, S as SidebarItem, m as SidebarSection, n as adminErrorMessage, o as buildRoutes, p as buildSidebar, q as defaultSectionOrder, r as httpStatusOf, s as isAdminError, t as isAxiosNoResponseError, u as isEmptyResponse, v as isPlatformError, w as isTransportFailure, x as markEmptyResponse, y as markPlatformError, z as markTransportFailure, E as readErrorCode, F as readErrorDetail, G as resolveExtension, H as toAdminError } from '../batch-column-fetcher-Dk9X92db.cjs';
+import { H as HttpClient, T as ResourceDef, S as ResourceContext, y as PilotRow, u as PilotCreatePayload, v as PilotCreateResult, w as PilotEditPayload, x as PilotEditResult, f as EmailHistoryFilter, g as EmailHistoryListResult, E as EmailHistoryDetail, h as EmailHistoryResendResult, z as PlatformEmailProvider, G as PlatformEmailWriteInput, C as PlatformEmailTestInput, F as PlatformEmailTestResult, a2 as SaLocale } from '../catalog-D257Y044.cjs';
+export { A as ActionDefNotInManifestError, a as ActionHandler, b as ActionRegistry, c as AuditListFilter, B as Bound, D as DEFAULT_SA_LOCALE, d as DefineResourceOptions, e as DiscoveryRead, i as EmailHistoryRow, k as HttpResponse, K as KpiReading, l as KvStore, L as LIST_FIRST_PAGE, m as LIST_PAGE_SIZE_DEFAULT, n as LIST_PAGE_SIZE_MAX, o as LIST_PAGINATION_PARAMS, p as ListFilterOf, q as ListOp, r as ListQuery, M as MarketingProjectionsFilter, s as MessageTree, t as MissingHandlerError, P as PartialMessages, I as PlatformResources, J as PromoCodesFilter, N as PromoDetail, O as PublishBundleVersionOptions, Q as PublishPlanVersionOptions, R as ResolvedAction, U as ResourceListPage, V as ResourceOp, W as ResourceOps, X as SA_INTL_LOCALES, Y as SA_LOCALES, Z as SA_LOCALE_LABELS, _ as SA_MESSAGES, $ as SaBuiltinLocale, a0 as SaCatalog, a1 as SaCatalogOptions, a3 as SaLocaleDefinition, a4 as SaLocaleOption, a5 as SaMessages, a6 as SaMessagesOverrides, a7 as TenantsListFilter, a8 as TranslationOf, a9 as auditResource, aa as bindResource, ab as bundleVersionsResource, ac as bundlesResource, ad as clampListPage, ae as clampListPageSize, af as createSaCatalog, ag as dashboardResource, ah as defaultHttpClient, ai as defaultKvStore, aj as defineListOp, ak as defineMessages, al as defineResource, am as discoveryResource, an as filterQueryString, ao as isSaBuiltinLocale, ap as isSentInQuery, aq as listUrl, ar as marketingResource, as as mergeMessages, at as planVersionsResource, au as plansResource, av as platformResources, aw as promoCodesResource, ax as readListPage, ay as resolveMessages, az as tenantsResource } from '../catalog-D257Y044.cjs';
+import { A as AdminError } from '../batch-column-fetcher-DLq3zI7m.cjs';
+export { a as AdminErrorInit, B as BatchColumnData, b as BatchColumnDriftError, c as BatchColumnFetcher, d as BatchColumnFetcherOptions, e as BatchColumnRow, f as BatchColumnValue, g as BootLoadError, h as BootLoader, i as BootLoaderOptions, j as BuildRouteEntry, C as CachedManifestEntry, D as DEFAULT_STANDARD_PAGE_ROUTES, M as ManifestLoadError, k as ManifestLoader, l as ManifestLoaderOptions, N as NavBuilderOptions, P as ParamStyle, S as SidebarItem, m as SidebarSection, n as adminErrorMessage, o as buildRoutes, p as buildSidebar, q as defaultSectionOrder, r as httpStatusOf, s as isAdminError, t as isAxiosNoResponseError, u as isEmptyResponse, v as isPlatformError, w as isTransportFailure, x as markEmptyResponse, y as markPlatformError, z as markTransportFailure, E as readErrorCode, F as readErrorDetail, G as resolveExtension, H as toAdminError } from '../batch-column-fetcher-DLq3zI7m.cjs';
 import { CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, DiscoverySnapshot, SyncDiscoveryResult, PromotionRow, CreatePromotionData, UpdatePromotionData, AdminUserListFilter, AdminUserListRow, AdminSubscriptionListRow, PromoCodeRecord, AdminTenantDetail, AdminAuditListFilter, AuditEntry } from '@saasicat/core';
 
 declare const ADMIN_UI_VERSION = "1.2.0";
@@ -383,6 +383,24 @@ declare function isProductionBoot(boot: {
     project?: LoginBootProject | null;
 } | null | undefined): boolean;
 
+/**
+ * The priority values that turn a drag into a new order.
+ *
+ * The marketing list sorts by priority descending, so "move this row here" has
+ * to be expressed as numbers before it can be persisted. Two things make that
+ * more than an assignment:
+ *
+ * - **Ties.** Every plan starts at `0`, and swapping two zeroes changes
+ *   nothing. The values have to be pulled apart before they can carry an order.
+ * - **Existing values mean something.** An operator who set 100 / 50 / 10 chose
+ *   those gaps. Renumbering to 3 / 2 / 1 would answer a question nobody asked,
+ *   so the values are kept and only their assignment moves.
+ *
+ * The result is per ORIGINAL index, and `null` where a row keeps what it has —
+ * each change is one write, so not changing is worth reporting.
+ */
+declare function reorderedPriorities(priorities: readonly number[], from: number, to: number): (number | null)[];
+
 interface PlanRowLike {
     id: string;
     planKey: string;
@@ -512,4 +530,4 @@ declare function looksLikeEmail(value: string): boolean;
 /** `value` without any run of `ch` at either end — `trim()` for one character. */
 declare function trimChar(value: string, ch: string): string;
 
-export { ADMIN_UI_VERSION, AdminError, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type AxiosHttpClientOptions, type AxiosLike, type AxiosLikeConfig, type AxiosLikeResponse, type AxiosLikeResponseConfig, type AxiosResponseBody, EmailHistoryDetail, EmailHistoryFilter, EmailHistoryListResult, EmailHistoryResendResult, type FetchHttpClientOptions, HttpClient, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, type LoginBootProject, type LoginBrandFallback, type LoginBranding, type MessageParams, PilotCreatePayload, PilotCreateResult, PilotEditPayload, PilotEditResult, PilotRow, type PlanCounts, type PlanRowLike, type PlanVersionLike, PlatformEmailProvider, PlatformEmailTestInput, PlatformEmailTestResult, PlatformEmailWriteInput, type ResolvePlansInput, type ResolvedPlan, ResourceContext, ResourceDef, type ResourceRequestInit, SaLocale, catalogResource, countPlans, createAdminResourceClient, createAxiosHttpClient, createFetchHttpClient, emailHistoryResource, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isCurrentlyValid, isExpired, isFutureScheduled, isProductionBoot, looksLikeEmail, pilotsResource, platformEmailResource, postJson, promotionsResource, requestJson, requestJsonBody, requireServerAnswer, resolveLoginBranding, resolvePlans, subscriptionsResource, todayIsoDate, trimChar, trimTrailingSlashes, usersResource };
+export { ADMIN_UI_VERSION, AdminError, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type AxiosHttpClientOptions, type AxiosLike, type AxiosLikeConfig, type AxiosLikeResponse, type AxiosLikeResponseConfig, type AxiosResponseBody, EmailHistoryDetail, EmailHistoryFilter, EmailHistoryListResult, EmailHistoryResendResult, type FetchHttpClientOptions, HttpClient, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, type LoginBootProject, type LoginBrandFallback, type LoginBranding, type MessageParams, PilotCreatePayload, PilotCreateResult, PilotEditPayload, PilotEditResult, PilotRow, type PlanCounts, type PlanRowLike, type PlanVersionLike, PlatformEmailProvider, PlatformEmailTestInput, PlatformEmailTestResult, PlatformEmailWriteInput, type ResolvePlansInput, type ResolvedPlan, ResourceContext, ResourceDef, type ResourceRequestInit, SaLocale, catalogResource, countPlans, createAdminResourceClient, createAxiosHttpClient, createFetchHttpClient, emailHistoryResource, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isCurrentlyValid, isExpired, isFutureScheduled, isProductionBoot, looksLikeEmail, pilotsResource, platformEmailResource, postJson, promotionsResource, reorderedPriorities, requestJson, requestJsonBody, requireServerAnswer, resolveLoginBranding, resolvePlans, subscriptionsResource, todayIsoDate, trimChar, trimTrailingSlashes, usersResource };

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
-import { H as HttpClient, T as ResourceDef, S as ResourceContext, y as PilotRow, u as PilotCreatePayload, v as PilotCreateResult, w as PilotEditPayload, x as PilotEditResult, f as EmailHistoryFilter, g as EmailHistoryListResult, E as EmailHistoryDetail, h as EmailHistoryResendResult, z as PlatformEmailProvider, G as PlatformEmailWriteInput, C as PlatformEmailTestInput, F as PlatformEmailTestResult, a2 as SaLocale } from '../catalog-C5VKGbxk.js';
-export { A as ActionDefNotInManifestError, a as ActionHandler, b as ActionRegistry, c as AuditListFilter, B as Bound, D as DEFAULT_SA_LOCALE, d as DefineResourceOptions, e as DiscoveryRead, i as EmailHistoryRow, k as HttpResponse, K as KpiReading, l as KvStore, L as LIST_FIRST_PAGE, m as LIST_PAGE_SIZE_DEFAULT, n as LIST_PAGE_SIZE_MAX, o as LIST_PAGINATION_PARAMS, p as ListFilterOf, q as ListOp, r as ListQuery, M as MarketingProjectionsFilter, s as MessageTree, t as MissingHandlerError, P as PartialMessages, I as PlatformResources, J as PromoCodesFilter, N as PromoDetail, O as PublishBundleVersionOptions, Q as PublishPlanVersionOptions, R as ResolvedAction, U as ResourceListPage, V as ResourceOp, W as ResourceOps, X as SA_INTL_LOCALES, Y as SA_LOCALES, Z as SA_LOCALE_LABELS, _ as SA_MESSAGES, $ as SaBuiltinLocale, a0 as SaCatalog, a1 as SaCatalogOptions, a3 as SaLocaleDefinition, a4 as SaLocaleOption, a5 as SaMessages, a6 as SaMessagesOverrides, a7 as TenantsListFilter, a8 as TranslationOf, a9 as auditResource, aa as bindResource, ab as bundleVersionsResource, ac as bundlesResource, ad as clampListPage, ae as clampListPageSize, af as createSaCatalog, ag as dashboardResource, ah as defaultHttpClient, ai as defaultKvStore, aj as defineListOp, ak as defineMessages, al as defineResource, am as discoveryResource, an as filterQueryString, ao as isSaBuiltinLocale, ap as isSentInQuery, aq as listUrl, ar as marketingResource, as as mergeMessages, at as planVersionsResource, au as plansResource, av as platformResources, aw as promoCodesResource, ax as readListPage, ay as resolveMessages, az as tenantsResource } from '../catalog-C5VKGbxk.js';
-import { A as AdminError } from '../batch-column-fetcher-VwjOxerL.js';
-export { a as AdminErrorInit, B as BatchColumnData, b as BatchColumnDriftError, c as BatchColumnFetcher, d as BatchColumnFetcherOptions, e as BatchColumnRow, f as BatchColumnValue, g as BootLoadError, h as BootLoader, i as BootLoaderOptions, j as BuildRouteEntry, C as CachedManifestEntry, D as DEFAULT_STANDARD_PAGE_ROUTES, M as ManifestLoadError, k as ManifestLoader, l as ManifestLoaderOptions, N as NavBuilderOptions, P as ParamStyle, S as SidebarItem, m as SidebarSection, n as adminErrorMessage, o as buildRoutes, p as buildSidebar, q as defaultSectionOrder, r as httpStatusOf, s as isAdminError, t as isAxiosNoResponseError, u as isEmptyResponse, v as isPlatformError, w as isTransportFailure, x as markEmptyResponse, y as markPlatformError, z as markTransportFailure, E as readErrorCode, F as readErrorDetail, G as resolveExtension, H as toAdminError } from '../batch-column-fetcher-VwjOxerL.js';
+import { H as HttpClient, T as ResourceDef, S as ResourceContext, y as PilotRow, u as PilotCreatePayload, v as PilotCreateResult, w as PilotEditPayload, x as PilotEditResult, f as EmailHistoryFilter, g as EmailHistoryListResult, E as EmailHistoryDetail, h as EmailHistoryResendResult, z as PlatformEmailProvider, G as PlatformEmailWriteInput, C as PlatformEmailTestInput, F as PlatformEmailTestResult, a2 as SaLocale } from '../catalog-D257Y044.js';
+export { A as ActionDefNotInManifestError, a as ActionHandler, b as ActionRegistry, c as AuditListFilter, B as Bound, D as DEFAULT_SA_LOCALE, d as DefineResourceOptions, e as DiscoveryRead, i as EmailHistoryRow, k as HttpResponse, K as KpiReading, l as KvStore, L as LIST_FIRST_PAGE, m as LIST_PAGE_SIZE_DEFAULT, n as LIST_PAGE_SIZE_MAX, o as LIST_PAGINATION_PARAMS, p as ListFilterOf, q as ListOp, r as ListQuery, M as MarketingProjectionsFilter, s as MessageTree, t as MissingHandlerError, P as PartialMessages, I as PlatformResources, J as PromoCodesFilter, N as PromoDetail, O as PublishBundleVersionOptions, Q as PublishPlanVersionOptions, R as ResolvedAction, U as ResourceListPage, V as ResourceOp, W as ResourceOps, X as SA_INTL_LOCALES, Y as SA_LOCALES, Z as SA_LOCALE_LABELS, _ as SA_MESSAGES, $ as SaBuiltinLocale, a0 as SaCatalog, a1 as SaCatalogOptions, a3 as SaLocaleDefinition, a4 as SaLocaleOption, a5 as SaMessages, a6 as SaMessagesOverrides, a7 as TenantsListFilter, a8 as TranslationOf, a9 as auditResource, aa as bindResource, ab as bundleVersionsResource, ac as bundlesResource, ad as clampListPage, ae as clampListPageSize, af as createSaCatalog, ag as dashboardResource, ah as defaultHttpClient, ai as defaultKvStore, aj as defineListOp, ak as defineMessages, al as defineResource, am as discoveryResource, an as filterQueryString, ao as isSaBuiltinLocale, ap as isSentInQuery, aq as listUrl, ar as marketingResource, as as mergeMessages, at as planVersionsResource, au as plansResource, av as platformResources, aw as promoCodesResource, ax as readListPage, ay as resolveMessages, az as tenantsResource } from '../catalog-D257Y044.js';
+import { A as AdminError } from '../batch-column-fetcher-BsX1cJiU.js';
+export { a as AdminErrorInit, B as BatchColumnData, b as BatchColumnDriftError, c as BatchColumnFetcher, d as BatchColumnFetcherOptions, e as BatchColumnRow, f as BatchColumnValue, g as BootLoadError, h as BootLoader, i as BootLoaderOptions, j as BuildRouteEntry, C as CachedManifestEntry, D as DEFAULT_STANDARD_PAGE_ROUTES, M as ManifestLoadError, k as ManifestLoader, l as ManifestLoaderOptions, N as NavBuilderOptions, P as ParamStyle, S as SidebarItem, m as SidebarSection, n as adminErrorMessage, o as buildRoutes, p as buildSidebar, q as defaultSectionOrder, r as httpStatusOf, s as isAdminError, t as isAxiosNoResponseError, u as isEmptyResponse, v as isPlatformError, w as isTransportFailure, x as markEmptyResponse, y as markPlatformError, z as markTransportFailure, E as readErrorCode, F as readErrorDetail, G as resolveExtension, H as toAdminError } from '../batch-column-fetcher-BsX1cJiU.js';
 import { CapabilityCatalogEntryRow, FeatureCatalogEntryRow, QuotaCatalogEntryRow, ReviewCatalogEntryData, CatalogEntryI18n, UpdateCatalogEntryBaseData, DiscoverySnapshot, SyncDiscoveryResult, PromotionRow, CreatePromotionData, UpdatePromotionData, AdminUserListFilter, AdminUserListRow, AdminSubscriptionListRow, PromoCodeRecord, AdminTenantDetail, AdminAuditListFilter, AuditEntry } from '@saasicat/core';
 
 declare const ADMIN_UI_VERSION = "1.2.0";
@@ -383,6 +383,24 @@ declare function isProductionBoot(boot: {
     project?: LoginBootProject | null;
 } | null | undefined): boolean;
 
+/**
+ * The priority values that turn a drag into a new order.
+ *
+ * The marketing list sorts by priority descending, so "move this row here" has
+ * to be expressed as numbers before it can be persisted. Two things make that
+ * more than an assignment:
+ *
+ * - **Ties.** Every plan starts at `0`, and swapping two zeroes changes
+ *   nothing. The values have to be pulled apart before they can carry an order.
+ * - **Existing values mean something.** An operator who set 100 / 50 / 10 chose
+ *   those gaps. Renumbering to 3 / 2 / 1 would answer a question nobody asked,
+ *   so the values are kept and only their assignment moves.
+ *
+ * The result is per ORIGINAL index, and `null` where a row keeps what it has —
+ * each change is one write, so not changing is worth reporting.
+ */
+declare function reorderedPriorities(priorities: readonly number[], from: number, to: number): (number | null)[];
+
 interface PlanRowLike {
     id: string;
     planKey: string;
@@ -512,4 +530,4 @@ declare function looksLikeEmail(value: string): boolean;
 /** `value` without any run of `ch` at either end — `trim()` for one character. */
 declare function trimChar(value: string, ch: string): string;
 
-export { ADMIN_UI_VERSION, AdminError, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type AxiosHttpClientOptions, type AxiosLike, type AxiosLikeConfig, type AxiosLikeResponse, type AxiosLikeResponseConfig, type AxiosResponseBody, EmailHistoryDetail, EmailHistoryFilter, EmailHistoryListResult, EmailHistoryResendResult, type FetchHttpClientOptions, HttpClient, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, type LoginBootProject, type LoginBrandFallback, type LoginBranding, type MessageParams, PilotCreatePayload, PilotCreateResult, PilotEditPayload, PilotEditResult, PilotRow, type PlanCounts, type PlanRowLike, type PlanVersionLike, PlatformEmailProvider, PlatformEmailTestInput, PlatformEmailTestResult, PlatformEmailWriteInput, type ResolvePlansInput, type ResolvedPlan, ResourceContext, ResourceDef, type ResourceRequestInit, SaLocale, catalogResource, countPlans, createAdminResourceClient, createAxiosHttpClient, createFetchHttpClient, emailHistoryResource, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isCurrentlyValid, isExpired, isFutureScheduled, isProductionBoot, looksLikeEmail, pilotsResource, platformEmailResource, postJson, promotionsResource, requestJson, requestJsonBody, requireServerAnswer, resolveLoginBranding, resolvePlans, subscriptionsResource, todayIsoDate, trimChar, trimTrailingSlashes, usersResource };
+export { ADMIN_UI_VERSION, AdminError, type AdminPromoListFilter, type AdminPromoListRow, type AdminResourceClientOptions, type AxiosHttpClientOptions, type AxiosLike, type AxiosLikeConfig, type AxiosLikeResponse, type AxiosLikeResponseConfig, type AxiosResponseBody, EmailHistoryDetail, EmailHistoryFilter, EmailHistoryListResult, EmailHistoryResendResult, type FetchHttpClientOptions, HttpClient, HttpJsonError, IDENTITY_ACCENTS, IDENTITY_ACCENT_VALUES, IDENTITY_NEUTRAL, IDENTITY_NEUTRAL_VALUE, type LoginBootProject, type LoginBrandFallback, type LoginBranding, type MessageParams, PilotCreatePayload, PilotCreateResult, PilotEditPayload, PilotEditResult, PilotRow, type PlanCounts, type PlanRowLike, type PlanVersionLike, PlatformEmailProvider, PlatformEmailTestInput, PlatformEmailTestResult, PlatformEmailWriteInput, type ResolvePlansInput, type ResolvedPlan, ResourceContext, ResourceDef, type ResourceRequestInit, SaLocale, catalogResource, countPlans, createAdminResourceClient, createAxiosHttpClient, createFetchHttpClient, emailHistoryResource, formatCurrency, formatMessage, getJson, identityAccentAt, identityAccentFor, identityChipStyle, isCurrentlyValid, isExpired, isFutureScheduled, isProductionBoot, looksLikeEmail, pilotsResource, platformEmailResource, postJson, promotionsResource, reorderedPriorities, requestJson, requestJsonBody, requireServerAnswer, resolveLoginBranding, resolvePlans, subscriptionsResource, todayIsoDate, trimChar, trimTrailingSlashes, usersResource };

package/dist/client/index.js

@@ -15,11 +15,12 @@ import {
   isFutureScheduled,
   isProductionBoot,
   looksLikeEmail,
+  reorderedPriorities,
   resolveLoginBranding,
   resolvePlans,
   todayIsoDate,
   trimChar
-} from "../chunk-L7HPDVHV.js";
+} from "../chunk-JXHRJ2ZD.js";
 import {
   ActionDefNotInManifestError,
   ActionRegistry,
@@ -31,7 +32,7 @@ import {
   buildSidebar,
   defaultSectionOrder,
   resolveExtension
-} from "../chunk-6X6AGH66.js";
+} from "../chunk-6B5WYQFC.js";
 import {
   AdminError,
   BootLoadError,
@@ -104,7 +105,7 @@ import {
   toAdminError,
   trimTrailingSlashes,
   usersResource
-} from "../chunk-P4EJF43F.js";
+} from "../chunk-RJDW4RJT.js";
 export {
   ADMIN_UI_VERSION,
   ActionDefNotInManifestError,
@@ -193,6 +194,7 @@ export {
   readErrorCode,
   readErrorDetail,
   readListPage,
+  reorderedPriorities,
   requestJson,
   requestJsonBody,
   requireServerAnswer,