@crystaldesign/diva-backoffice 26.12.0-beta.3 → 26.12.0-beta.5

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/components/ArticleTable/index.d.ts

@@ -1,17 +1,25 @@
 import React from 'react';
-import { DivaSpreadsheetHooks, SpreadsheetRefProps } from '@crystaldesign/spreadsheet';
+import { DivaActionDef, DivaContext, DivaSpreadsheetHooks, SpreadsheetRefProps } from '@crystaldesign/spreadsheet';
+import { HeaderProducts } from '../../logic/headerSync';
 interface ArticleTableProps {
     /** Free text of the page's search input — the grid ORs it over the legacy search fields. */
     searchTerm?: string;
     /** Page-level hooks, e.g. the selection that drives the subtable tabs. */
     hooks?: DivaSpreadsheetHooks<Record<string, unknown>>;
+    /** The page's row buttons (actions column), e.g. the header refresh. */
+    rowActions?: DivaActionDef<Record<string, unknown>, DivaContext>[];
+    /** The organization's header rows for the refresh marker; the grid waits for them (undefined = loading). */
+    headers?: HeaderProducts;
 }
 /**
  * All articles of the organization as a server-side grid: the catalog service pages, sorts and
  * filters `/v1/products`. The organization scoping lives in the preFilter — the products filter path
  * applies neither the organization nor `archived` by itself (see HeaderData/hooks/useHeaderData.ts).
  * The supplier / EK group context is per row: the two leading columns name it; keeping the header
- * inheritance (`headerValues`) in sync with those values is a server concern.
+ * inheritance (`headerValues`) linked to those values is a server concern. A header save changes no
+ * article — rows whose header snapshot differs from the header row, or that are not linked to the
+ * header row of their context yet, get a warning accent, and the page's row action pulls the current
+ * header values in.
  */
 declare const ArticleTable: React.ForwardRefExoticComponent<ArticleTableProps & React.RefAttributes<SpreadsheetRefProps<Record<string, unknown>>>>;
 export default ArticleTable;

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/components/ArticleTable/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/ui/AssortmentManager/ArticleData/components/ArticleTable/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAiB,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAatG,UAAU,iBAAiB;IACzB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;;;;;GAMG;AACH,QAAA,MAAM,YAAY,wHA6GhB,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/ui/AssortmentManager/ArticleData/components/ArticleTable/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAiB,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAUlI,OAAO,EAAE,cAAc,EAAoB,MAAM,wBAAwB,CAAC;AAI1E,UAAU,iBAAiB;IACzB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,wEAAwE;IACxE,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC;IACnE,4GAA4G;IAC5G,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,YAAY,wHAmHhB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/hooks/useHeaderProducts.d.ts

@@ -0,0 +1,15 @@
+import RootStore from '../../../../store/RootStore';
+import { HeaderProducts } from '../logic/headerSync';
+export interface HeaderProductsState {
+    /** The active header rows, indexed. Undefined while loading; empty after a failed load (nothing is marked then). */
+    headers?: HeaderProducts;
+    loading: boolean;
+}
+/**
+ * The header rows the article table compares the articles against (`isHeaderOutdated`, `hasUnlinkedHeader`).
+ * Loaded once per mount — the grid waits for it, because ag-grid does not re-evaluate row classes when a
+ * value outside the row data changes. A failed load degrades to "nothing marked" with a warning toast; the
+ * articles themselves stay fully usable.
+ */
+export default function useHeaderProducts(root: RootStore): HeaderProductsState;
+//# sourceMappingURL=useHeaderProducts.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/hooks/useHeaderProducts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHeaderProducts.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/ArticleData/hooks/useHeaderProducts.ts"],"names":[],"mappings":"AAGA,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAuB,MAAM,qBAAqB,CAAC;AAyB1E,MAAM,WAAW,mBAAmB;IAClC,oHAAoH;IACpH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AA+CD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB,CA0B9E"}

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/hooks/useRefreshHeaderValues.d.ts

@@ -0,0 +1,9 @@
+import RootStore from '../../../../store/RootStore';
+/**
+ * Pulls the current header values into one article through the catalog service
+ * (`POST /v1/products/:id/headervalues/refresh`) and returns the updated article, which the grid uses to
+ * replace its row. The server resolves the header row, rebuilds the merge and refuses transferred
+ * articles — the client sends nothing but the id. No loading state here: the row action button shows its own.
+ */
+export default function useRefreshHeaderValues(root: RootStore): (articleId: string) => Promise<Record<string, unknown>>;
+//# sourceMappingURL=useRefreshHeaderValues.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/hooks/useRefreshHeaderValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefreshHeaderValues.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/ArticleData/hooks/useRefreshHeaderValues.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAGpD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,IAAI,EAAE,SAAS,eAExC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkB9D"}

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/index.d.ts

@@ -2,8 +2,11 @@ import React from 'react';
 /**
  * The article ("Positionsdaten") page of the assortment manager: lists all articles of the
  * organization, narrowed by the free text search. The supplier / EK group context lives per row in
- * the two leading columns; keeping the header inheritance (`headerValues`) in sync with those values
- * is a server concern. The selected row feeds the ITEM_GROUP tabs in the bottom toolbar.
+ * the two leading columns; writes into them link the header row client side (`onCellEditRequest` →
+ * headerLink), the catalog service relinks on every save that changes them. A header save does not
+ * change the articles — rows whose header snapshot differs from the current header row show as
+ * outdated, and the row action of the actions column pulls the current header values into one
+ * article on request. The selected row feeds the ITEM_GROUP tabs in the bottom toolbar.
  */
 declare function ArticleData(): React.JSX.Element;
 declare const _default: typeof ArticleData & {

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/ui/AssortmentManager/ArticleData/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAgBtE;;;;;GAKG;AACH,iBAAS,WAAW,sBAoJnB;;;;AAED,wBAAqC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/ui/AssortmentManager/ArticleData/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAwBtE;;;;;;;;GAQG;AACH,iBAAS,WAAW,sBA0OnB;;;;AAED,wBAAqC"}

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/logic/articleColumns.d.ts

@@ -46,7 +46,8 @@ export declare function labelCompanionResets(oldData: ArticleRow | undefined, da
  * Builds the article table's column tree from the field catalogue: one header group per catalogue
  * `group` in file order, one column per `showOnArticle` entry; entries without a group render
  * ungrouped at the top level. Header-inheritable text and number fields render as `withPlaceholder`
- * columns, multilanguage fields as nested language groups, ITEM_GROUPs as row-count summaries.
+ * columns (except the two context columns, see CONTEXT_FIELD_KEYS), multilanguage fields as nested
+ * language groups, ITEM_GROUPs as row-count summaries.
  * Fields naming a `commonColumn` collapse into one shared symbol column each, their own columns
  * hidden.
  */

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/logic/articleColumns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"articleColumns.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/ArticleData/logic/articleColumns.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,EAA0B,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAGvE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,KAAK,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAAqB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAQjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAIjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8BAE/B,CAAC;AAoBF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAIvF,CAAC;AAsBH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAOjH;AAiQD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,SAAS,EACZ,wBAAwB,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,EACjE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAM,GAC1C,aAAa,EAAE,CA2EjB"}
+{"version":3,"file":"articleColumns.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/ArticleData/logic/articleColumns.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAoB,MAAM,4BAA4B,CAAC;AAE3F,OAAO,EAA0B,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAIvE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,KAAK,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAAqB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAQjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAIjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8BAG/B,CAAC;AAoBF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAIvF,CAAC;AAuDH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAOjH;AA8QD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,SAAS,EACZ,wBAAwB,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,EACjE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAM,GAC1C,aAAa,EAAE,CA8EjB"}

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/logic/headerLink.d.ts

@@ -0,0 +1,38 @@
+import { CellEditRequestedEvent, DivaContext } from '@crystaldesign/spreadsheet';
+import { HeaderProduct } from '../../HeaderData/hooks/useHeaderData';
+type ArticleRow = Record<string, unknown>;
+/** Loads the header product of a supplier / EK group combination; undefined when the combination has none. */
+export type HeaderResolver = (supplierNr: string, ekg: string) => Promise<HeaderProduct | undefined>;
+/** The article paths the header row is looked up by — the key fields the catalog relinks on (`headerInheritance.keyFields`). */
+export declare const HEADER_KEY_PATHS: {
+    readonly supplier: "customData.SAP.SAP_EINA_LIFNR";
+    readonly ekg: "customData.SAP.SAP_EINE_EKGRP";
+};
+/**
+ * The `headerValues` an article carries for its header row, in the shape the catalog service writes
+ * itself (`buildHeaderValuesSnapshot`): the row's customData as the inheritance source plus its audit
+ * fields (`lastUpdated` is what the outdated marker compares, see headerSync.ts).
+ */
+export declare function headerValuesSnapshot(header: HeaderProduct): Record<string, unknown>;
+export type HeaderLinker = ReturnType<typeof createHeaderLinker>;
+/**
+ * Links the header row client side, the way the lookup cell fills its dependent fields: once both key
+ * fields of a row are set, the header product is loaded and written into the row's `headerValues`, so
+ * the placeholder cells show the inherited values before anything is saved and the commit carries the
+ * link. The catalog service respects a body carrying `headerValues` on create and rebuilds the link
+ * itself whenever the keys change later, so it stays the authority — this only moves the moment the
+ * user sees the inheritance forward. A missing key, a combination without a header row and a failed
+ * lookup all remove the link, as the server would: the previous header's values must not survive a
+ * key change — and the catalog links the row on save anyway.
+ */
+export declare function createHeaderLinker(resolveHeader: HeaderResolver): {
+    /**
+     * The grid's `hooks.onCellEditRequest`: every write into a cell arrives here; whenever it changes the
+     * supplier / EK group combination (`oldData` vs `data`, the row as the write leaves it — whichever
+     * column or source did it), the (re)link starts with the new keys. The transaction handler lock holds
+     * the auto-commit back until the link is written, so the saved row carries it.
+     */
+    onCellEditRequest({ oldData, data, node, context, api }: CellEditRequestedEvent<ArticleRow, DivaContext>): void;
+};
+export {};
+//# sourceMappingURL=headerLink.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/logic/headerLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerLink.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/ArticleData/logic/headerLink.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,8GAA8G;AAC9G,MAAM,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;AAErG,gIAAgI;AAChI,eAAO,MAAM,gBAAgB;;;CAA+F,CAAC;AAE7H;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWnF;AAWD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,cAAc;IAiC5D;;;;;OAKG;6DACsD,sBAAsB,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI;EAiBlH"}

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/logic/headerSync.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The active header rows of the organization (`_id`, `lastUpdated`, key fields), keyed by product id and by
+ * their supplier / EK group context ({@link headerContextKey}).
+ */
+export interface HeaderProducts {
+    byId: ReadonlyMap<string, Record<string, unknown>>;
+    byContext: ReadonlyMap<string, Record<string, unknown>>;
+}
+/**
+ * The supplier / EK group context of a row as one map key — the client-side counterpart of the catalog's
+ * header key fields (`headerInheritance.keyFields`), read from the materialized values. Undefined while a
+ * key field is missing or empty: an incomplete context pairs with no header row.
+ */
+export declare function headerContextKey(data: Record<string, unknown> | undefined): string | undefined;
+/** Indexes the loaded header rows for {@link isHeaderOutdated} and {@link hasUnlinkedHeader}. */
+export declare function indexHeaderProducts(rows: Record<string, unknown>[]): HeaderProducts;
+/**
+ * An article whose header snapshot is older than the header row it references: the header was saved after
+ * the article last pulled its values. Compared by timestamp — `headerValues.lastUpdated` is the header's
+ * `lastUpdated` at snapshot time — so the header rows are loaded with a few fields instead of their whole
+ * `customData`; an organization has thousands of them. Derived from the data on both sides, a header save
+ * writes nothing into articles. Not reported for transferred articles (they can never be refreshed), for
+ * articles without a link, and while the header rows are not loaded or the referenced row is gone.
+ */
+export declare function isHeaderOutdated(data: Record<string, unknown> | undefined, headers: HeaderProducts | undefined): boolean;
+/**
+ * An article without a header link whose supplier / EK group context has a header row by now: the article
+ * was imported or created before that header row existed (the import sets no link then, and a header save
+ * writes nothing into articles). A refresh links it — the catalog resolves the header through the key
+ * fields, not through the stored link. Not reported for transferred articles and while the header rows are
+ * not loaded.
+ */
+export declare function hasUnlinkedHeader(data: Record<string, unknown> | undefined, headers: HeaderProducts | undefined): boolean;
+/** Whether the refresh action has something to pull: outdated header values, or a header row not linked yet. */
+export declare function canRefreshHeader(data: Record<string, unknown> | undefined, headers: HeaderProducts | undefined): boolean;
+//# sourceMappingURL=headerSync.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/ArticleData/logic/headerSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerSync.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/ArticleData/logic/headerSync.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI9F;AAED,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,cAAc,CAOnF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAOxH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAMzH;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAExH"}

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/components/AffectedCount/index.d.ts

@@ -2,12 +2,13 @@ import React from 'react';
 import { AffectedProductsState } from '../../hooks/useAffectedProducts';
 interface AffectedCountProps {
     affected: AffectedProductsState;
-    /** Unsaved changes present — the number turns into a warning because it is about to take effect. */
+    /** Unsaved changes present — the number turns into a warning because saving makes that many articles outdated. */
     dirty: boolean;
 }
 /**
  * How many articles inherit the header values. Stays quiet while nothing is edited and turns into a warning
- * as soon as there are unsaved changes, since that is the moment the number becomes a consequence.
+ * as soon as there are unsaved changes: after the save exactly these articles show as outdated in the
+ * article table, and each of them has to be refreshed there.
  *
  * The count is per supplier / EK group and not per field: the filter behind it does not look at individual
  * fields, so a per-field number would be the same one repeated.

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/components/AffectedCount/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/ui/AssortmentManager/HeaderData/components/AffectedCount/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAIxE,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,oGAAoG;IACpG,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,kBAAkB,4BA6B7D;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/ui/AssortmentManager/HeaderData/components/AffectedCount/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAIxE,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,kHAAkH;IAClH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,kBAAkB,4BA6B7D;AAED,eAAe,aAAa,CAAC"}

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/components/Content/index.d.ts

@@ -5,7 +5,7 @@ import { PreparedTableSave } from '../../types';
 interface ContentProps {
     /** The loaded header product (`isHeader: true`) whose values are edited. */
     data?: HeaderProduct;
-    /** How many articles a save propagates the header values into. */
+    /** How many articles inherit from this header — the ones that show as outdated after a save. */
     affected: AffectedProductsState;
     /** Group keys (= product paths) of ITEM_GROUP tabs with unsaved changes; drives save button and markers. */
     tableDirtyKeys: string[];

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/components/Content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/ui/AssortmentManager/HeaderData/components/Content/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AASnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA2ChD,UAAU,YAAY;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,qBAAqB,CAAC;IAChC,4GAA4G;IAC5G,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,uGAAuG;IACvG,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,sGAAsG;IACtG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,iBAAS,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,YAAY,qBA0MnI;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../src/ui/AssortmentManager/HeaderData/components/Content/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AASnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA2ChD,UAAU,YAAY;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,gGAAgG;IAChG,QAAQ,EAAE,qBAAqB,CAAC;IAChC,4GAA4G;IAC5G,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,uGAAuG;IACvG,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,sGAAsG;IACtG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,iBAAS,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,YAAY,qBA0MnI;AAED,eAAe,OAAO,CAAC"}

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/hooks/useAffectedProducts.d.ts

@@ -6,13 +6,13 @@ export interface AffectedProductsState {
     error?: string;
 }
 /**
- * Counts the articles a change to the header values reaches.
+ * Counts the articles a change to the header values concerns — the ones that show as outdated in the
+ * article table after a save and can be refreshed there.
  *
- * The filter mirrors what `ProductModificationService.collectHeaderValueTargetIds` selects server side — the
- * `headerValues._id` reference plus the same two exclusions — so the number reflects what a save actually
- * touches. Deliberately unlike the SAP import path (`PfisterArticleService.updateHeaderValuesInProducts`),
- * articles already sent to SAP (`SentToSAPSuccess: true`) are excluded: editing header data must not change
- * articles that are already transferred.
+ * The filter is the `headerValues._id` reference plus the two exclusions the refresh refuses anyway.
+ * Deliberately unlike the SAP import path (`PfisterArticleService.updateHeaderValuesInProducts`), articles
+ * already sent to SAP (`SentToSAPSuccess: true`) are excluded: transferred articles can never be refreshed,
+ * so the article table does not report them as outdated either.
  * `limit=0` makes this a pure count: the catalog service skips the data pipeline and only runs the count
  * aggregation, so `total` arrives without any documents.
  */

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/hooks/useHeaderData.d.ts

@@ -10,6 +10,20 @@ export interface HeaderDataState {
     /** Set when the request itself failed, which is a different situation from "no header row exists". */
     error?: string;
 }
+/**
+ * Fetches the header product (`isHeader: true`) of a supplier / EK group combination; undefined when
+ * the combination has none.
+ *
+ * `type: 'string'` on the two SAP keys is required: `parseFilterParam` casts an unquoted numeric string to
+ * a number, which then matches nothing. `archived` is filtered here because the catalog service drops the
+ * controller's own `archived: false` on the filter code path — the same reason
+ * `PfisterArticleService.getProductHeaderValues` spells it out.
+ *
+ * `organizationId` belongs in the filter as well: on that same code path the `organizationIds` query
+ * parameter only drives the permission check and does not scope the query (`ProductService.search`), so
+ * without the clause another organization's header row could be loaded.
+ */
+export declare function fetchHeaderProduct(root: RootStore, supplierNr: string, ekg: string): Promise<HeaderProduct | undefined>;
 /** Loads the header product for a supplier / EK group combination as reactive state. */
 export default function useHeaderData(root: RootStore, supplierNr?: string, ekg?: string): HeaderDataState;
 //# sourceMappingURL=useHeaderData.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/hooks/useHeaderData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHeaderData.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/HeaderData/hooks/useHeaderData.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAGpD,yFAAyF;AACzF,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,uGAAuG;IACvG,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyCD,wFAAwF;AACxF,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CA4BzG"}
+{"version":3,"file":"useHeaderData.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/HeaderData/hooks/useHeaderData.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAGpD,yFAAyF;AACzF,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,uGAAuG;IACvG,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAwB7H;AAED,wFAAwF;AACxF,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CA4BzG"}

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/hooks/useSaveHeaderData.d.ts

@@ -8,18 +8,19 @@ export interface SaveHeaderDataState {
 /**
  * Saves the header product through the catalog service.
  *
- * `PATCH /v1/products/:id/headervalues` patches the header row and propagates its values into the
- * `headerValues` of every product referencing it. Both halves live in the catalog because that is where
- * `isHeader`, `headerValues` and `overrideValues` are defined and merged — going through a client specific
- * service is not necessary and would tie the assortment manager to one customer's article service.
+ * `PATCH /v1/products/:id/headervalues` patches the header row and nothing else — the products referencing
+ * it keep their values until the user refreshes them one by one in the article table, which recognizes them
+ * by comparing their header snapshot with the header row. The route lives in the catalog because that is
+ * where `isHeader`, `headerValues` and `overrideValues` are defined and merged — going through a client
+ * specific service is not necessary and would tie the assortment manager to one customer's article service.
  *
  * Only the changed paths are sent, as JSON Patch. That is the reason for using this endpoint over the older
  * route through diva-pfister-article, whose `createProductFromDivaNr` was written to sync whole records out
  * of the legacy SQL database and replaces `customData` wholesale — it forced the client to send the entire
  * object back and silently dropped anything left out.
  *
- * Which products inherit from this header is decided by the backend off the `headerValues._id` they carry;
- * the client sends no filter for it.
+ * Which products inherit from this header is recorded on the products themselves (`headerValues._id`); the
+ * client sends nothing about them.
  */
 export default function useSaveHeaderData(root: RootStore, data?: HeaderProduct): SaveHeaderDataState;
 //# sourceMappingURL=useSaveHeaderData.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/HeaderData/hooks/useSaveHeaderData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSaveHeaderData.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/HeaderData/hooks/useSaveHeaderData.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,4FAA4F;IAC5F,IAAI,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACzE,MAAM,EAAE,OAAO,CAAC;CACjB;AASD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,mBAAmB,CAoCpG"}
+{"version":3,"file":"useSaveHeaderData.d.ts","sourceRoot":"","sources":["../../../../../../../../src/ui/AssortmentManager/HeaderData/hooks/useSaveHeaderData.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,6BAA6B,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,4FAA4F;IAC5F,IAAI,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACzE,MAAM,EAAE,OAAO,CAAC;CACjB;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,mBAAmB,CAoCpG"}

package/build/types/backoffice/src/ui/AssortmentManager/tests/headerLink.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=headerLink.test.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/tests/headerLink.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerLink.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/ui/AssortmentManager/tests/headerLink.test.ts"],"names":[],"mappings":""}

package/build/types/backoffice/src/ui/AssortmentManager/tests/headerSync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=headerSync.test.d.ts.map

package/build/types/backoffice/src/ui/AssortmentManager/tests/headerSync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerSync.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/ui/AssortmentManager/tests/headerSync.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crystaldesign/diva-backoffice",
-  "version": "26.12.0-beta.3",
+  "version": "26.12.0-beta.5",
   "description": "Ant Design backoffice shell: configuration plus the IDM and enricher editors.",
   "license": "COMMERCIAL",
   "devDependencies": {
@@ -16,14 +16,14 @@
   "dependencies": {
     "@ant-design/icons": "6.3.4",
     "@babel/runtime": "7.24.7",
-    "@crystaldesign/content-box": "26.12.0-beta.3",
-    "@crystaldesign/content-item": "26.12.0-beta.3",
-    "@crystaldesign/diva-agent": "26.12.0-beta.3",
-    "@crystaldesign/diva-core": "26.12.0-beta.3",
-    "@crystaldesign/diva-utils": "26.12.0-beta.3",
-    "@crystaldesign/media-upload": "26.12.0-beta.3",
-    "@crystaldesign/rtf-editor": "26.12.0-beta.3",
-    "@crystaldesign/spreadsheet": "26.12.0-beta.3",
+    "@crystaldesign/content-box": "26.12.0-beta.5",
+    "@crystaldesign/content-item": "26.12.0-beta.5",
+    "@crystaldesign/diva-agent": "26.12.0-beta.5",
+    "@crystaldesign/diva-core": "26.12.0-beta.5",
+    "@crystaldesign/diva-utils": "26.12.0-beta.5",
+    "@crystaldesign/media-upload": "26.12.0-beta.5",
+    "@crystaldesign/rtf-editor": "26.12.0-beta.5",
+    "@crystaldesign/spreadsheet": "26.12.0-beta.5",
     "@dnd-kit/core": "^6.1.0",
     "@dnd-kit/sortable": "^8.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -57,5 +57,5 @@
   },
   "module": "build/esm/index.js",
   "types": "./build/types/backoffice/src/index.d.ts",
-  "gitHead": "312438387ce4d1fe172606411bdd40d1fa3653ff"
+  "gitHead": "77181ce68e122d2c5758941c21c3659cd4f26b83"
 }