@algoux/standard-ranklist-renderer-component-angular 0.5.1 → 0.6.1

package/README.md

@@ -98,3 +98,51 @@ export class BoardComponent {
 ```
 
 Use `ModalComponent` directly when you want custom modal content. `SrkUserCellTemplateDirective` and `SrkStatusCellTemplateDirective` let you replace selected ranklist table cells with Angular templates.
+
+## Ranklist Render Options
+
+`RanklistComponent` includes optional render inputs for changing the table structure and status presentation while keeping the default behavior unchanged:
+
+- `splitOrganization`: moves user organization into its own column before the user column.
+- `columnTitles`: overrides text labels for series, organization, user, score, time, Dirt, and SE columns.
+- `statusCellPreset`: uses `classic`, `detailed`, `minimal`, or `compact` status cell content.
+- `statusColorAsText`: uses bold status-colored text instead of colored cell backgrounds.
+- `showProblemStatisticsFooter`: appends a DOMjudge-style per-problem statistics footer.
+- `showDirtColumn`: appends a Dirt percentage column after problem columns.
+- `showSEColumn`: appends a contestant SE column after problem columns, placed after Dirt when both are enabled.
+- `rowBordered`: adds row separators controlled by CSS variables.
+- `columnBordered`: adds column separators controlled by CSS variables.
+- `emptyStatusPlaceholder`: renders a custom string in no-submission status cells.
+- `userAvatarPlacement`: chooses whether the default user avatar renders in the user column or, when `splitOrganization` is enabled, in the organization column.
+
+```ts
+import type { RanklistColumnTitles } from '@algoux/standard-ranklist-renderer-component-angular';
+
+export class BoardComponent {
+  readonly columnTitles: RanklistColumnTitles = {
+    organization: 'Org',
+    user: 'Team',
+    score: 'Solved',
+    time: 'Penalty',
+    dirt: 'Dirt',
+    se: 'SE',
+  };
+}
+```
+
+```html
+<srk-ranklist
+  [data]="staticRanklist"
+  [splitOrganization]="true"
+  [showProblemStatisticsFooter]="true"
+  [showDirtColumn]="true"
+  [showSEColumn]="true"
+  [statusCellPreset]="'compact'"
+  [statusColorAsText]="true"
+  [rowBordered]="true"
+  [columnBordered]="true"
+  [emptyStatusPlaceholder]="'·'"
+  [userAvatarPlacement]="'organization'"
+  [columnTitles]="columnTitles"
+></srk-ranklist>
+```

package/dist/README.md

@@ -98,3 +98,51 @@ export class BoardComponent {
 ```
 
 Use `ModalComponent` directly when you want custom modal content. `SrkUserCellTemplateDirective` and `SrkStatusCellTemplateDirective` let you replace selected ranklist table cells with Angular templates.
+
+## Ranklist Render Options
+
+`RanklistComponent` includes optional render inputs for changing the table structure and status presentation while keeping the default behavior unchanged:
+
+- `splitOrganization`: moves user organization into its own column before the user column.
+- `columnTitles`: overrides text labels for series, organization, user, score, time, Dirt, and SE columns.
+- `statusCellPreset`: uses `classic`, `detailed`, `minimal`, or `compact` status cell content.
+- `statusColorAsText`: uses bold status-colored text instead of colored cell backgrounds.
+- `showProblemStatisticsFooter`: appends a DOMjudge-style per-problem statistics footer.
+- `showDirtColumn`: appends a Dirt percentage column after problem columns.
+- `showSEColumn`: appends a contestant SE column after problem columns, placed after Dirt when both are enabled.
+- `rowBordered`: adds row separators controlled by CSS variables.
+- `columnBordered`: adds column separators controlled by CSS variables.
+- `emptyStatusPlaceholder`: renders a custom string in no-submission status cells.
+- `userAvatarPlacement`: chooses whether the default user avatar renders in the user column or, when `splitOrganization` is enabled, in the organization column.
+
+```ts
+import type { RanklistColumnTitles } from '@algoux/standard-ranklist-renderer-component-angular';
+
+export class BoardComponent {
+  readonly columnTitles: RanklistColumnTitles = {
+    organization: 'Org',
+    user: 'Team',
+    score: 'Solved',
+    time: 'Penalty',
+    dirt: 'Dirt',
+    se: 'SE',
+  };
+}
+```
+
+```html
+<srk-ranklist
+  [data]="staticRanklist"
+  [splitOrganization]="true"
+  [showProblemStatisticsFooter]="true"
+  [showDirtColumn]="true"
+  [showSEColumn]="true"
+  [statusCellPreset]="'compact'"
+  [statusColorAsText]="true"
+  [rowBordered]="true"
+  [columnBordered]="true"
+  [emptyStatusPlaceholder]="'·'"
+  [userAvatarPlacement]="'organization'"
+  [columnTitles]="columnTitles"
+></srk-ranklist>
+```

package/dist/esm2022/lib/index.mjs

@@ -5,4 +5,4 @@ export { ProgressBarComponent } from './progress/progress-bar.component';
 export { RanklistComponent } from './ranklist/ranklist.component';
 export { SrkStatusCellTemplateDirective, } from './ranklist/status-cell-template.directive';
 export { SrkUserCellTemplateDirective, } from './ranklist/user-cell-template.directive';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCw2QkFBNkIsR0FDOUIsTUFBTSwwQ0FBMEMsQ0FBQztBQUNsRCxPQUFPLEVBQ0wseUJBQXlCLEdBQzFCLE1BQU0sc0NBQXNDLENBQUM7QUFDOUMsT0FBTyxFQUNMLGNBQWMsR0FFZixNQUFNLHlCQUF5QixDQUFDO0FBQ2pDLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBQ3pFLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ2xFLE9BQU8sRUFDTCw4QkFBOEIsR0FFL0IsTUFBTSwyQ0FBMkMsQ0FBQztBQUNuRCxPQUFPLEVBQ0wsNEJBQTRCLEdBRTdCLE1BQU0seUNBQXlDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQge1xuICBEZWZhdWx0U29sdXRpb25Nb2RhbENvbXBvbmVudCxcbn0gZnJvbSAnLi9tb2RhbC9kZWZhdWx0LXNvbHV0aW9uLW1vZGFsLmNvbXBvbmVudCc7XG5leHBvcnQge1xuICBEZWZhdWx0VXNlck1vZGFsQ29tcG9uZW50LFxufSBmcm9tICcuL21vZGFsL2RlZmF1bHQtdXNlci1tb2RhbC5jb21wb25lbnQnO1xuZXhwb3J0IHtcbiAgTW9kYWxDb21wb25lbnQsXG4gIHR5cGUgTW9kYWxDbG9zZVJlYXNvbixcbn0gZnJvbSAnLi9tb2RhbC9tb2RhbC5jb21wb25lbnQnO1xuZXhwb3J0IHsgUHJvZ3Jlc3NCYXJDb21wb25lbnQgfSBmcm9tICcuL3Byb2dyZXNzL3Byb2dyZXNzLWJhci5jb21wb25lbnQnO1xuZXhwb3J0IHsgUmFua2xpc3RDb21wb25lbnQgfSBmcm9tICcuL3JhbmtsaXN0L3JhbmtsaXN0LmNvbXBvbmVudCc7XG5leHBvcnQge1xuICBTcmtTdGF0dXNDZWxsVGVtcGxhdGVEaXJlY3RpdmUsXG4gIHR5cGUgU3RhdHVzQ2VsbFRlbXBsYXRlQ29udGV4dCxcbn0gZnJvbSAnLi9yYW5rbGlzdC9zdGF0dXMtY2VsbC10ZW1wbGF0ZS5kaXJlY3RpdmUnO1xuZXhwb3J0IHtcbiAgU3JrVXNlckNlbGxUZW1wbGF0ZURpcmVjdGl2ZSxcbiAgdHlwZSBVc2VyQ2VsbFRlbXBsYXRlQ29udGV4dCxcbn0gZnJvbSAnLi9yYW5rbGlzdC91c2VyLWNlbGwtdGVtcGxhdGUuZGlyZWN0aXZlJztcbmV4cG9ydCB0eXBlIHtcbiAgUmFua1ZhbHVlLFxuICBTb2x1dGlvbkNsaWNrUGF5bG9hZCxcbiAgU3RhdGljUmFua2xpc3QsXG4gIFVzZXJDbGlja1BheWxvYWQsXG59IGZyb20gJy4vdHlwZXMnO1xuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCw2QkFBNkIsR0FDOUIsTUFBTSwwQ0FBMEMsQ0FBQztBQUNsRCxPQUFPLEVBQ0wseUJBQXlCLEdBQzFCLE1BQU0sc0NBQXNDLENBQUM7QUFDOUMsT0FBTyxFQUNMLGNBQWMsR0FFZixNQUFNLHlCQUF5QixDQUFDO0FBQ2pDLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBQ3pFLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ2xFLE9BQU8sRUFDTCw4QkFBOEIsR0FFL0IsTUFBTSwyQ0FBMkMsQ0FBQztBQUNuRCxPQUFPLEVBQ0wsNEJBQTRCLEdBRTdCLE1BQU0seUNBQXlDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQge1xuICBEZWZhdWx0U29sdXRpb25Nb2RhbENvbXBvbmVudCxcbn0gZnJvbSAnLi9tb2RhbC9kZWZhdWx0LXNvbHV0aW9uLW1vZGFsLmNvbXBvbmVudCc7XG5leHBvcnQge1xuICBEZWZhdWx0VXNlck1vZGFsQ29tcG9uZW50LFxufSBmcm9tICcuL21vZGFsL2RlZmF1bHQtdXNlci1tb2RhbC5jb21wb25lbnQnO1xuZXhwb3J0IHtcbiAgTW9kYWxDb21wb25lbnQsXG4gIHR5cGUgTW9kYWxDbG9zZVJlYXNvbixcbn0gZnJvbSAnLi9tb2RhbC9tb2RhbC5jb21wb25lbnQnO1xuZXhwb3J0IHsgUHJvZ3Jlc3NCYXJDb21wb25lbnQgfSBmcm9tICcuL3Byb2dyZXNzL3Byb2dyZXNzLWJhci5jb21wb25lbnQnO1xuZXhwb3J0IHsgUmFua2xpc3RDb21wb25lbnQgfSBmcm9tICcuL3JhbmtsaXN0L3JhbmtsaXN0LmNvbXBvbmVudCc7XG5leHBvcnQge1xuICBTcmtTdGF0dXNDZWxsVGVtcGxhdGVEaXJlY3RpdmUsXG4gIHR5cGUgU3RhdHVzQ2VsbFRlbXBsYXRlQ29udGV4dCxcbn0gZnJvbSAnLi9yYW5rbGlzdC9zdGF0dXMtY2VsbC10ZW1wbGF0ZS5kaXJlY3RpdmUnO1xuZXhwb3J0IHtcbiAgU3JrVXNlckNlbGxUZW1wbGF0ZURpcmVjdGl2ZSxcbiAgdHlwZSBVc2VyQ2VsbFRlbXBsYXRlQ29udGV4dCxcbn0gZnJvbSAnLi9yYW5rbGlzdC91c2VyLWNlbGwtdGVtcGxhdGUuZGlyZWN0aXZlJztcbmV4cG9ydCB0eXBlIHtcbiAgUmFua2xpc3RDb2x1bW5UaXRsZXMsXG4gIFJhbmtsaXN0U3RhdHVzQ2VsbFByZXNldCxcbiAgUmFua2xpc3RVc2VyQXZhdGFyUGxhY2VtZW50LFxuICBSYW5rVmFsdWUsXG4gIFNvbHV0aW9uQ2xpY2tQYXlsb2FkLFxuICBTdGF0aWNSYW5rbGlzdCxcbiAgVXNlckNsaWNrUGF5bG9hZCxcbn0gZnJvbSAnLi90eXBlcyc7XG4iXX0=