@webx-ui/module-admin 0.17.0 → 0.18.1

package/dist/ScreenHead.d.ts

@@ -38,8 +38,12 @@ type __VLS_Props = {
      * The way out of the screen. A route draws a link; `true` draws the same arrow and emits
      * `back` instead, which is what a pane inside `WxListDetail` needs — on a phone the drawer
      * carries no close of its own and the pane has to bring one (CLAUDE.md §4).
+     *
+     * `string` and `object` are spelled out beside `RouteLocationRaw` for the compiler: it
+     * cannot resolve the router's type, drops it and leaves `Boolean` alone as the runtime
+     * type, so every editor passing its list's path warned "Expected Boolean, got String".
      */
-    back?: RouteLocationRaw | boolean;
+    back?: RouteLocationRaw | string | object | boolean;
     /** What the arrow's tooltip says. The panel's own word for it when not given. */
     backLabel?: string;
     /** `2` for a screen, `3` for a pane standing inside one. */
@@ -95,7 +99,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     title: string;
     actions: ScreenAction[];
     subtitle: string;
-    back: RouteLocationRaw | boolean;
+    back: RouteLocationRaw | string | object | boolean;
     backLabel: string;
     level: HeadingLevel;
     collapseBelow: number;

package/dist/collections/api.d.ts

@@ -12,11 +12,35 @@ export interface CollectionSourceInfo {
     categories: string | null;
     /** Whether it can mark its records up for search engines. */
     markup: boolean;
+    /**
+     * The targets its records can be related to (`CollectionSource::relations()`, §3.6 of the
+     * recipes spec) — empty for a source without relations, which has no "only related to".
+     */
+    relations: CollectionRelationTarget[];
+}
+/** A target a source's records point at, named for the choice "only related to …". */
+export interface CollectionRelationTarget {
+    /** Its key in the server's registry of targets: `service`. */
+    key: string;
+    /** Already in the panel's language. */
+    title: string;
+}
+/** "Only the records related to these": one target, and the ones of it that were chosen. */
+export interface CollectionRelated {
+    type: string;
+    ids: number[];
+    /**
+     * "Related to the record of the page the block stands on" — written only when on, and then
+     * `ids` is always empty: the record is the page's, not a choice.
+     */
+    current?: true;
 }
 /** What a `wx-collection` field keeps: the choice, never the records. */
 export interface CollectionValue {
     /** Empty — all of them. */
     categories: number[];
+    /** `null` — not narrowed by relations. */
+    related: CollectionRelated | null;
     /** `null` — all of them. */
     limit: number | null;
     filter: boolean;
@@ -26,7 +50,10 @@ export interface CollectionValue {
 /** The server's ceiling for `limit` (`Selection::MAX_LIMIT`). */
 export declare const COLLECTION_MAX_LIMIT = 100;
 export declare function collectionSources(admin: AdminContext): Promise<CollectionSourceInfo[]>;
-/** Whatever arrived, as the four keys the server writes — the same `Selection::normalise()` does. */
+/** Whatever arrived, as the five keys the server writes — the same `Selection::normalise()` does. */
 export declare function normaliseCollection(value: unknown): CollectionValue;
-/** What `markup: null` means for this choice: on for the whole collection, off for a part of it. */
+/**
+ * What `markup: null` means for this choice: on for the whole collection, off for a part of it —
+ * and "the recipes of this service" is a part as much as a category is.
+ */
 export declare function defaultMarkup(value: CollectionValue): boolean;

package/dist/index.d.ts

@@ -11,7 +11,8 @@ export { createLinksApi, emptyLink, type LinkCandidate, type LinkRel, type LinkS
 export { createHttp, readCookie, HttpError, type Http, type HttpOptions, type RequestOptions, } from './http';
 export { adminTypes } from './screenTypes';
 export { categoryRoutes, createCategoriesApi, itemOrderMode, reorderItems, useCategoryEditor, useCategoryWords, useItemOrder, type CategoriesApi, type CategoriesOptions, type CategoriesPayload, type CategoryDetail, type CategoryEditorContext, type CategoryRow, type CategoryWord, type ItemOrder, type ItemOrderMode, type ItemOrderState, } from './categories';
-export { COLLECTION_MAX_LIMIT, collectionSources, defaultMarkup, normaliseCollection, type CollectionSourceInfo, type CollectionValue, } from './collections/api';
+export { COLLECTION_MAX_LIMIT, collectionSources, defaultMarkup, normaliseCollection, type CollectionRelated, type CollectionRelationTarget, type CollectionSourceInfo, type CollectionValue, } from './collections/api';
+export { createRelationsApi, normaliseRelations, provideRelationOwner, relationOwnerKey, useRelationOwner, type RelationCandidate, type RelationOwner, type RelationsApi, } from './relations/api';
 export type { AdminModule, AdminStatus, AdminUser, Manifest, ManifestModule, NavEntry, PickedImage, RowAction, ScreenAction, AppliedFilter, } from './types';
 export { default as AdminShell } from './AdminShell';
 export { default as AdminNav } from './AdminNav';
@@ -37,6 +38,7 @@ export { default as WxCategoryCreateDialog } from './categories/CategoryCreateDi
 export { default as WxCategoryEditorPage } from './categories/CategoryEditorPage';
 export { default as WxCategoriesField } from './categories/CategoriesField';
 export { default as WxCollectionField } from './collections/CollectionField';
+export { default as WxRelationsField } from './relations/RelationsField';
 export { default as WxSlugField } from './SlugField';
 /** The shared address field under the name it was released with. */
 export { default as WxCategorySlug } from './SlugField';