@shop-os/modelkit 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -9,6 +9,11 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.2.5] - 2026-09-15
+
+### Changed
+- `Catalog.list()` returns rows in picker order: `display.sortOrder` descending, rows without one after the ordered ones, then `label` ascending (case-insensitive), then `id`. pro-backend orders its query the same way. Before, the order was the insertion order of the primed rows (pro-backend heap order), so an edited row moved to the end of every picker. `compareCatalogOrder` and `sortCatalogRows` are exported from the root and `/catalog` entries for consumers that sort their own lists.
+
 ## [0.2.4] - 2026-09-15
 
 ### Fixed

package/dist/catalog.cjs

@@ -30,6 +30,7 @@ __export(catalog_entry_exports, {
   OTHER_MODELS: () => OTHER_MODELS,
   TEXT_MODELS: () => TEXT_MODELS,
   VIDEO_MODELS: () => VIDEO_MODELS,
+  compareCatalogOrder: () => compareCatalogOrder,
   isModelKitError: () => isModelKitError,
   liveCatalog: () => liveCatalog,
   liveState: () => liveState,
@@ -39,7 +40,8 @@ __export(catalog_entry_exports, {
   resolveAudioOptions: () => resolveAudioOptions,
   resolveImageOptions: () => resolveImageOptions,
   resolveOptions: () => resolveOptions,
-  resolveVideoOptions: () => resolveVideoOptions
+  resolveVideoOptions: () => resolveVideoOptions,
+  sortCatalogRows: () => sortCatalogRows
 });
 module.exports = __toCommonJS(catalog_entry_exports);
 
@@ -69,6 +71,22 @@ function isModelKitError(err) {
   return err instanceof ModelKitError;
 }
 
+// src/catalog/order.ts
+function compareCatalogOrder(a, b) {
+  const sa = a.display?.sortOrder;
+  const sb = b.display?.sortOrder;
+  if (sa !== void 0 && sb !== void 0 && sa !== sb) return sb - sa;
+  if (sa !== void 0 && sb === void 0) return -1;
+  if (sa === void 0 && sb !== void 0) return 1;
+  return compareText(a.label.toLowerCase(), b.label.toLowerCase()) || compareText(a.id, b.id);
+}
+function compareText(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function sortCatalogRows(rows) {
+  return [...rows].sort(compareCatalogOrder);
+}
+
 // src/catalog/registry.ts
 var Catalog = class _Catalog {
   byId = /* @__PURE__ */ new Map();
@@ -125,11 +143,12 @@ var Catalog = class _Catalog {
     }
     return model;
   }
+  /** Rows in picker order: `display.sortOrder` descending, then label. See `compareCatalogOrder`. */
   list(filter = {}) {
     const lifecycles = filter.lifecycle ?? ["active"];
     return [...this.byId.values()].filter(
       (m) => (filter.type ? m.type === filter.type : true) && lifecycles.includes(m.lifecycle)
-    );
+    ).sort(compareCatalogOrder);
   }
   /** Merge rows by id. Used for catalogOverride. */
   withOverrides(rows) {