@mintplayer/ng-spark 22.14.0 → 22.16.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mintplayer/ng-spark",
   "private": false,
-  "version": "22.14.0",
+  "version": "22.16.0",
   "description": "Angular component library for MintPlayer.Spark CRUD applications",
   "repository": {
     "type": "git",

package/types/mintplayer-ng-spark-models.d.ts

@@ -237,6 +237,19 @@ interface EntityType {
     attributes: EntityAttributeDefinition[];
     /** Query aliases or IDs to display as related query tables on the detail page. */
     queries?: string[];
+    /**
+     * The definitions of this type's AsDetail row types, sent alongside it so a detail table can draw
+     * its columns.
+     *
+     * Needed because a row type usually has no rights of its own — a row is edited through its parent
+     * — and the entity-type catalogue is gated on `Query`. Resolving a row type from the catalogue
+     * therefore failed silently, and the table rendered with **no columns at all**.
+     *
+     * Per-caller and gated on the *parent's* right, which is the same gate that already ships each
+     * row's attribute schema inside `attr.objects`. Pruned server-side: no `queryType`, `indexName`,
+     * `queries` or `alias`.
+     */
+    detailTypes?: EntityType[];
 }
 
 type SparkQueryRenderMode = 'Pagination' | 'VirtualScrolling';
@@ -581,6 +594,17 @@ declare const AS_DETAIL_ROW_KEY = "__sparkRowKey";
  * rendering nothing — it reads as a real value. `typeName` lets a caller filter it back out.
  */
 declare function selfBreadcrumb(row: Record<string, any> | null | undefined, typeName?: string): string | null;
+/**
+ * The same filter as {@link selfBreadcrumb}, for a caller holding the server's breadcrumb string
+ * directly rather than a flattened row dict — `attr.object.breadcrumb` on a detail page, or a query
+ * cell's `breadcrumb`.
+ *
+ * Split out so there is exactly one answer to "is this the type-name placeholder?". The first
+ * implementation lived inside `selfBreadcrumb` and so covered only the two pipes that flatten a row
+ * first; the two that read the string straight off the wire kept printing `BuildFeedback` and
+ * `GateSettings` at users (#384). A second copy of the comparison is how that happens again.
+ */
+declare function resolvedBreadcrumb(value: unknown, typeName?: string): string | null;
 /**
  * Reserved key under which {@link nestedPoToDisplayRow} stashes the server-resolved breadcrumb of
  * each reference attribute (keyed by attribute name). Lets an AsDetail reference cell render the
@@ -588,6 +612,16 @@ declare function selfBreadcrumb(row: Record<string, any> | null | undefined, typ
  * reference-query options page. Prefixed to avoid colliding with a real attribute name.
  */
 declare const AS_DETAIL_BREADCRUMBS_KEY = "__sparkBreadcrumbs";
+/**
+ * Whether a flattened-row key is one this module reserved rather than a model attribute.
+ *
+ * `nestedPoToDict` and `nestedPoToDisplayRow` stash the row key and the resolved breadcrumbs
+ * alongside the real values, which is safe on the way back — `dictToNestedPo` walks the entity
+ * type's attributes and never the dict's keys. It is *not* safe for anything that enumerates the
+ * dict to build display text: a caller joining `Object.values(dict)` prints the row's guid and its
+ * own breadcrumb as though they were fields.
+ */
+declare function isReservedAsDetailKey(key: string): boolean;
 /**
  * Like {@link nestedPoToDict}, but for the read-only detail display path. In addition to each
  * attribute's value it preserves the server-resolved per-reference `breadcrumb` under
@@ -740,5 +774,5 @@ interface EvaluableAttribute {
  */
 declare function evaluateRules(attr: EvaluableAttribute, value: any): RuleFailure[];
 
-export { AS_DETAIL_BREADCRUMBS_KEY, AS_DETAIL_ROW_KEY, AS_DETAIL_SELF_BREADCRUMB_KEY, ELookupDisplayType, EReferenceDisplayType, ShowedOn, applyOverlay, currentLanguage, dictToNestedPo, evaluateRules, filterQueryActions, hasShowedOnFlag, isPersistentObject, isQueryRow, mergeRefreshValues, nestedPoToDict, nestedPoToDisplayRow, overlayFromResponse, parseSelectionRule, resolveTranslation, selectionModeFor, selfBreadcrumb, valueFor };
+export { AS_DETAIL_BREADCRUMBS_KEY, AS_DETAIL_ROW_KEY, AS_DETAIL_SELF_BREADCRUMB_KEY, ELookupDisplayType, EReferenceDisplayType, ShowedOn, applyOverlay, currentLanguage, dictToNestedPo, evaluateRules, filterQueryActions, hasShowedOnFlag, isPersistentObject, isQueryRow, isReservedAsDetailKey, mergeRefreshValues, nestedPoToDict, nestedPoToDisplayRow, overlayFromResponse, parseSelectionRule, resolveTranslation, resolvedBreadcrumb, selectionModeFor, selfBreadcrumb, valueFor };
 export type { AttributeGroup, AttributeOverlay, AttributeTab, CustomActionDefinition, EntityAttributeDefinition, EntityPermissions, EntityType, EntityTypeResolver, EvaluableAttribute, LookupReference, LookupReferenceListItem, LookupReferenceValue, PersistentObject, PersistentObjectAttribute, PersistentObjectPermissions, ProgramUnit, ProgramUnitGroup, ProgramUnitsConfiguration, QueryColumn, QueryResult, QueryResultItem, QueryResultItemValue, RefreshOverlay, RefreshedOption, RetryActionPayload, RetryActionResult, RuleFailure, SparkCellColumn, SparkQuery, SparkQueryRenderMode, SparkQuerySortColumn, SparkRow, SparkSelectionMode, StreamingErrorMessage, StreamingMessage, StreamingPatchItem, StreamingPatchMessage, StreamingSnapshotMessage, TranslatedString, ValidationError, ValidationErrorResponse, ValidationRule };

package/types/mintplayer-ng-spark-pipes.d.ts

@@ -170,6 +170,23 @@ declare class CanDeleteDetailRowPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<CanDeleteDetailRowPipe, "canDeleteDetailRow", true>;
 }
 
+/**
+ * Whether the caller may edit rows of an AsDetail attribute's row type.
+ *
+ * The third of the `can*DetailRow` family, and the one the server was already answering. `canEdit`
+ * has been computed, shipped and fetched per AsDetail attribute since row rights landed — it was
+ * simply never read for the row path, so the form offered an edit the save would undo.
+ *
+ * ⚠️ Apply this **read-only, never hidden**. A row the caller may not edit must stay fully
+ * readable; hiding the inputs would hide the data, which is a worse answer than showing it
+ * uneditable.
+ */
+declare class CanEditDetailRowPipe implements PipeTransform {
+    transform(attr: EntityAttributeDefinition, permissions: Record<string, EntityPermissions>): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CanEditDetailRowPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<CanEditDetailRowPipe, "canEditDetailRow", true>;
+}
+
 declare class LookupDisplayTypePipe implements PipeTransform {
     transform(attr: EntityAttributeDefinition, lookupRefOptions: Record<string, LookupReference>): ELookupDisplayType;
     static ɵfac: i0.ɵɵFactoryDeclaration<LookupDisplayTypePipe, never>;
@@ -248,5 +265,5 @@ declare class QueryReferenceChipsPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<QueryReferenceChipsPipe, "queryReferenceChips", true>;
 }
 
-export { ArrayValuePipe, AsDetailCellValuePipe, AsDetailColumnsPipe, AsDetailDisplayValuePipe, AsDetailTypePipe, AttributeValuePipe, CanCreateDetailRowPipe, CanDeleteDetailRowPipe, ErrorForAttributePipe, IconNamePipe, InlineRefOptionsPipe, InputTypePipe, LookupDisplayTypePipe, LookupDisplayValuePipe, LookupOptionsPipe, QueryCellValuePipe, QueryReferenceChipsPipe, RawAttributeValuePipe, ReferenceAttrValuePipe, ReferenceChipsPipe, ReferenceDisplayValuePipe, ReferenceLinkRoutePipe, ResolveTranslationPipe, RouterLinkPipe, TranslateKeyPipe };
+export { ArrayValuePipe, AsDetailCellValuePipe, AsDetailColumnsPipe, AsDetailDisplayValuePipe, AsDetailTypePipe, AttributeValuePipe, CanCreateDetailRowPipe, CanDeleteDetailRowPipe, CanEditDetailRowPipe, ErrorForAttributePipe, IconNamePipe, InlineRefOptionsPipe, InputTypePipe, LookupDisplayTypePipe, LookupDisplayValuePipe, LookupOptionsPipe, QueryCellValuePipe, QueryReferenceChipsPipe, RawAttributeValuePipe, ReferenceAttrValuePipe, ReferenceChipsPipe, ReferenceDisplayValuePipe, ReferenceLinkRoutePipe, ResolveTranslationPipe, RouterLinkPipe, TranslateKeyPipe };
 export type { AsDetailCellValue, ReferenceChip };