@mintplayer/ng-spark 22.27.0 → 22.28.0

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

@@ -141,9 +141,9 @@ export declare class SparkModerationService {
   }>;
   /**
    * The caller's own reputation, shared by every caller in flight at once: the badge and the
-   * review-queue link both re-read on the same navigation and cost one request.
+   * review-queue link both re-read on the same navigation and cost one request. `null` signed out.
    */
-  ownReputation(): Promise<ModerationReputation>;
+  ownReputation(): Promise<ModerationReputation | null>;
   /** Casts (+1 / −1) or withdraws (0) the caller's vote; resolves to the target's new state. */
   vote(type: string, id: string, direction: -1 | 0 | 1): Promise<ModerationVoteState>;
   /**
@@ -159,8 +159,12 @@ export declare class SparkModerationService {
   unlock(type: string, id: string): Promise<void>;
   /** What the moderator panel shows about a target, including which tools the caller holds. */
   status(type: string, id: string): Promise<ModerationStatus>;
-  /** A user's reputation; the caller's own when `userId` is omitted (with privileges and suspension). */
-  reputation(userId?: string): Promise<ModerationReputation>;
+  /**
+   * A user's reputation; the caller's own when `userId` is omitted (with privileges and suspension).
+   * `null` for an anonymous caller: the server answers it 200 with no result rather than 401, so a
+   * badge on a page anyone may read never sends the app to the sign-in page.
+   */
+  reputation(userId?: string): Promise<ModerationReputation | null>;
   /** The caller's own ledger, newest first. Voters are never named; a reversal reads "Voting corrected (−N)". */
   history(take?: number): Promise<ModerationReputationLine[]>;
   cases(status?: string, skip?: number, take?: number): Promise<ModerationCaseSummary[]>;

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

@@ -117,6 +117,9 @@ export declare class AsDetailTypePipe implements PipeTransform {
 /**
  * The columns of an AsDetail table: the row type's visible attributes, in order — minus those a
  * registered row renderer draws (`rowComponent`), when the host passes its renderer registry.
+ *
+ * An attribute the row type's model draws nowhere (`showedOn: None`, #264) is not a column. Columns are per
+ * type, so they come from the model; a runtime `showedOn` on one row cannot add or remove a column.
  */
 export declare class AsDetailColumnsPipe implements PipeTransform {
   transform(attr: EntityAttributeDefinition, asDetailTypes: Record<string, EntityType>, renderers?: readonly SparkAttributeRendererRegistration[] | null): EntityAttributeDefinition[];

package/types/mintplayer-ng-spark-po-create.d.ts

@@ -16,6 +16,10 @@ export declare class SparkPoCreateComponent {
   validationErrors: import("@angular/core").WritableSignal<ValidationError[]>;
   isSaving: import("@angular/core").WritableSignal<boolean>;
   private allEntityTypes;
+  /**
+   * The errors the form cannot show next to a field: those with no attribute, and those on an attribute the
+   * form does not draw (#264, G6). Those used to be swallowed; Vidyano promotes them to a notification too.
+   */
   generalErrors: import("@angular/core").Signal<ValidationError[]>;
   /**
    * The parent a sub-query card's New passed in the URL (`parentId`, `parentType`, `queryId`), or

package/types/mintplayer-ng-spark-po-detail.d.ts

@@ -108,6 +108,10 @@ export declare class SparkPoDetailComponent {
   private loadItem;
   /** (Re)loads the object, its type, rights and actions. Also what add-ons call via `context.reload()`. */
   load(): Promise<void>;
+  /**
+   * Drawn from the loaded object's own `showedOn`, falling back to the model's (#264, G-Q3): an action sets
+   * it per object in `OnLoadAsync` — a stolen car's police report number is shown, the model says `None`.
+   */
   visibleAttributes: import("@angular/core").Signal<EntityAttributeDefinition[]>;
   private static readonly DEFAULT_TAB;
   ungroupedAttributes: import("@angular/core").Signal<EntityAttributeDefinition[]>;

package/types/mintplayer-ng-spark-po-edit.d.ts

@@ -147,6 +147,11 @@ export declare class SparkPoEditComponent {
    * is not the question's author edits only its translations; the server drops the rest from the
    * save anyway). Shared by the form and {@link getEditableAttributes}, so what is drawn, what is
    * initialised and what is saved agree. A refresh overlay can still lift it.
+   * <para>
+   * The same goes for where an attribute is drawn and whether it is required (#264, G5/G7): an action
+   * sets the runtime `showedOn`/`isRequired` in `OnLoadAsync` (a stolen car shows its police report
+   * number, required), and the form honours that from its first render rather than after a refresh.
+   * </para>
    */
   formEntityType: import("@angular/core").Signal<EntityType | null>;
   type: string;
@@ -160,6 +165,10 @@ export declare class SparkPoEditComponent {
   validationErrors: import("@angular/core").WritableSignal<ValidationError[]>;
   isSaving: import("@angular/core").WritableSignal<boolean>;
   private allEntityTypes;
+  /**
+   * The errors the form cannot show next to a field: those with no attribute, and those on an attribute the
+   * form does not draw (#264, G6). Those used to be swallowed; Vidyano promotes them to a notification too.
+   */
   generalErrors: import("@angular/core").Signal<ValidationError[]>;
   /** After a 409 was merged: what they changed, and that nothing has been saved yet. */
   private readonly conflictNoticeText;
@@ -212,6 +221,13 @@ export declare class SparkPoEditComponent {
    * then dropped on the floor and refused by the server as missing — with no way out of the form.
    * The overlay is the form's, bound two-way, so the two halves cannot drift again.
    */
+  /**
+   * The attributes {@link formDataFrom} gives a slot: the editable ones, plus those the model makes editable
+   * but this object's load made read-only (#264). A refresh can lift a load-time `isReadOnly` (a stolen car's
+   * plate, once the car is back in use), and the control must then show the loaded value, not an empty
+   * required field. Only {@link getEditableAttributes} decides what is saved, so a slot alone sends nothing.
+   */
+  private formDataAttributes;
   getEditableAttributes(): import("@mintplayer/ng-spark/models").EntityAttributeDefinition[];
   onSave(): Promise<void>;
   onCancel(): void;

package/types/mintplayer-ng-spark-po-form.d.ts

@@ -514,6 +514,7 @@ export declare class SparkReferencePickerComponent {
   pagination: import("@angular/core").WritableSignal<PaginationResponse<QueryResultItem> | undefined>;
   settings: import("@angular/core").WritableSignal<DatatableSettings>;
   searchTerm: string;
+  /** The picker lists query rows, so its columns are the query's: `showedOn` includes Query (#264; not None). */
   visibleAttributes: import("@angular/core").Signal<import("@mintplayer/ng-spark/models").EntityAttributeDefinition[]>;
   rows: import("@angular/core").Signal<QueryResultItem[]>;
   displayValue: import("@angular/core").Signal<string>;

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

@@ -103,7 +103,11 @@ export declare class SparkService {
   private static readonly MAX_RETRY_DEPTH;
   private readonly dispatcher;
   getEntityTypes(): Promise<EntityType[]>;
-  getEntityType(id: string): Promise<EntityType>;
+  /**
+   * One entity type, shaped by the caller's attribute rights. `purpose` narrows it for one form (#264, G1/G2):
+   * `'new'` leaves out what the caller may not create and does not apply edit-only denies.
+   */
+  getEntityType(id: string, purpose?: 'new' | 'edit' | 'read'): Promise<EntityType>;
   getEntityTypeByClrType(clrType: string): Promise<EntityType | undefined>;
   getPermissions(entityTypeId: string): Promise<EntityPermissions>;
   getQueries(): Promise<SparkQuery[]>;