@hestia-earth/ui-components 0.43.13 → 0.43.14

package/fesm2022/hestia-earth-ui-components.mjs

@@ -11839,6 +11839,20 @@ const isMissingValue = (values, binding) => isSubstitutable(binding) && isMissin
  * identical to the symbolic one.
  */
 const hasAnySubstitution = (values, bindings) => bindings.some(binding => isSubstitutable(binding) && !isMissing(values[binding.key]));
+const CONTRIBUTORS = {
+    cycle: { row: 'Cycle', group: 'Cycles', heading: 'Cycles combined' },
+    subAggregation: { row: 'Sub-aggregation', group: 'sub-aggregations', heading: 'Sub-aggregations combined' },
+    country: { row: 'Country aggregation', group: 'country aggregations', heading: 'Country aggregations combined' }
+};
+/**
+ * What one contributor of an aggregation is, which is what the `$i$` of every rule stands for: a
+ * World aggregation combines country aggregations, a country aggregation the sub-aggregations of its
+ * sub-systems, and a sub-aggregation the Cycles uploaded for the country. The documentation has to
+ * write both, so naming the stage is what tells a reader which of the two a rule is about.
+ *
+ * A World aggregation is never itself a sub-aggregation, so that stage is read first.
+ */
+const contributorNames = ({ worldAggregation, subAggregation }) => worldAggregation ? CONTRIBUTORS.country : subAggregation ? CONTRIBUTORS.cycle : CONTRIBUTORS.subAggregation;
 // a symbol reading one column of a contributors table: `key` names the table, `column` the field
 const isTableBinding = (binding) => !!binding.key && !!binding.column && !binding.match;
 // the packed `log_as_table` string: rows split on `;`, columns on `_`, each column a `key:value`
@@ -11852,6 +11866,10 @@ const parseRows = (packed) => typeof packed !== 'string'
         return at === -1 ? columns : { ...columns, [pair.slice(0, at)]: pair.slice(at + 1) };
     }, {}));
 const ID_COLUMN$1 = 'id';
+// A column no contributor recorded is dropped rather than shown as a column of blanks, which is
+// how the values of the Cycles behind a sub-aggregation are left out. Kept as documented where
+// there is no row to judge them by: the contributors were counted rather than listed.
+const recordedColumns = (columns, rows) => rows.length ? columns.filter(({ column }) => rows.some(row => !isMissing(row[column]))) : columns;
 // how many leading segments every id shares, e.g. the product and country of a sub-aggregation
 const commonPrefix = (ids) => {
     const [first = [], ...rest] = ids;
@@ -11894,10 +11912,10 @@ const contributorsTable = (values, formulas) => {
         .find(name => !isMissing(values[name]) || tableCount(values, name));
     if (!key)
         return undefined;
-    const columns = bindings
-        .filter(binding => binding.key === key)
-        .map(({ symbol, description, column }) => ({ symbol, description, column: column }));
     const parsed = parseRows(values[key]);
+    const columns = recordedColumns(bindings
+        .filter(binding => binding.key === key)
+        .map(({ symbol, description, column }) => ({ symbol, description, column: column })), parsed);
     const labels = distinguishingLabels(parsed.map(row => row[ID_COLUMN$1]));
     const rows = parsed.map((row, index) => ({
         id: row[ID_COLUMN$1],
@@ -11917,9 +11935,9 @@ const PRODUCT_PAGES = {
 };
 /**
  * The rules are shown in the order they answer a reader's questions: how this value was calculated,
- * which values went into it, then how each of those was weighted. Grouping them by what they
+ * which Cycles went into it, then how each of those was weighted. Grouping them by what they
  * compute rather than by the page they are documented on is what puts the two calculations either
- * side of the values they combine.
+ * side of the contributors they combine.
  */
 const GROUPS = [
     { id: 'value', heading: 'How the value is calculated', pageOrder: pages => pages },
@@ -12011,10 +12029,10 @@ class NodeAggregatedFormulasComponent {
                 .filter(formula => formulaGroup(formula) === id && this.applies(formula))
         })).filter(section => section.formulas.length > 0), ...(ngDevMode ? [{ debugName: "sections" }] : []));
         /**
-         * The values this one was combined from, as the aggregation recorded them: one row per Cycle or
-         * sub-aggregation, under the symbols the formulas above read them with. Absent where the
-         * contributors were too many to record, which is every aggregation built straight from source
-         * Cycles - their number is shown instead.
+         * What this value was combined from, as the aggregation recorded it: one row per contributor,
+         * under the symbols the formulas above read them with. Absent where the contributors were too
+         * many to record, which is every aggregation built straight from source Cycles - their number
+         * is shown instead.
          */
         this.contributors = computed(() => {
             const table = contributorsTable(this.values(), this.sections().flatMap(section => section.formulas));
@@ -12025,6 +12043,9 @@ class NodeAggregatedFormulasComponent {
                 rows: table.rows.map(row => ({ ...row, node: { '@type': NodeType.Cycle, '@id': row.id } }))
             });
         }, ...(ngDevMode ? [{ debugName: "contributors" }] : []));
+        // what the `$i$` of every rule stands for here, which the panel names so a reader does not have to
+        // pick between the two the documentation writes
+        this.contributor = computed(() => contributorNames({ worldAggregation: this.worldAggregation(), subAggregation: this.subAggregation() }), ...(ngDevMode ? [{ debugName: "contributor" }] : []));
         this.renderedSections = computed(() => {
             const values = this.values();
             const showValues = this.substituted() && this.hasSubstitutions();
@@ -12086,7 +12107,7 @@ class NodeAggregatedFormulasComponent {
         return this.ranForAggregation(formula) && this.appliesToNodeKey(formula);
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NodeAggregatedFormulasComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.0.6", type: NodeAggregatedFormulasComponent, isStandalone: true, selector: "he-node-aggregated-formulas", inputs: { termType: { classPropertyName: "termType", publicName: "termType", isSignal: true, isRequired: false, transformFunction: null }, termId: { classPropertyName: "termId", publicName: "termId", isSignal: true, isRequired: false, transformFunction: null }, nodeKey: { classPropertyName: "nodeKey", publicName: "nodeKey", isSignal: true, isRequired: false, transformFunction: null }, values: { classPropertyName: "values", publicName: "values", isSignal: true, isRequired: false, transformFunction: null }, worldAggregation: { classPropertyName: "worldAggregation", publicName: "worldAggregation", isSignal: true, isRequired: false, transformFunction: null }, subAggregation: { classPropertyName: "subAggregation", publicName: "subAggregation", isSignal: true, isRequired: false, transformFunction: null }, substituted: { classPropertyName: "substituted", publicName: "substituted", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { substituted: "substitutedChange" }, ngImport: i0, template: "@if (renderedSections().length) {\n  <div class=\"aggregated-formulas\">\n    <p class=\"is-size-7 is-mb-2 | formula-intro\">\n      Aggregated values are calculated from the underlying Cycles, not measured. These are the rules that produced this\n      one, in the order they are applied.\n    </p>\n\n    <div class=\"is-pt-2 is-pr-1 is-overflow-y-auto | aggregated-formulas-rules\">\n      @for (section of renderedSections(); track section.id; let first = $first) {\n        <he-formula-block\n          [formulas]=\"section.formulas\"\n          [heading]=\"section.heading\"\n          [collapsible]=\"true\"\n          [showToggle]=\"first\"\n          [hasSubstitutions]=\"hasSubstitutions()\"\n          [(substituted)]=\"substituted\"\n          emptyTitle=\"No recorded values to substitute\" />\n\n        <!-- the values combined sit between the two calculations: what went in, above how each was weighted -->\n        @if (section.id === 'value' && contributors(); as table) {\n          <he-collapsible-block heading=\"Values combined\">\n            @if (table.rows.length) {\n              <table class=\"table is-narrow is-size-7 w-100 | contributors-table\">\n                <thead>\n                  <tr>\n                    <th>Cycle</th>\n                    @for (column of table.columns; track column.symbol) {\n                      <th class=\"has-text-right\">\n                        <span [heKatex]=\"column.symbol\" [heKatexInline]=\"true\"></span>\n                      </th>\n                    }\n                  </tr>\n                </thead>\n                <tbody>\n                  @for (row of table.rows; track row.id) {\n                    <tr>\n                      <td [attr.title]=\"row.id\">\n                        <he-node-link [node]=\"row.node\" linkClass=\"has-text-white\">\n                          <span class=\"break-word\">{{ row.label }}</span>\n                        </he-node-link>\n                      </td>\n                      @for (value of row.values; track $index) {\n                        <td class=\"has-text-right is-nowrap\">{{ value | precision: 4 | default: '-' }}</td>\n                      }\n                    </tr>\n                  }\n                </tbody>\n              </table>\n            } @else {\n              <p class=\"is-size-7\">\n                Combined from {{ table.count }} Cycles, too many for the aggregation to record one by one.\n              </p>\n            }\n          </he-collapsible-block>\n        }\n      }\n    </div>\n  </div>\n}\n", styles: [".formula-intro{opacity:.85}.contributors-table{background-color:transparent;color:inherit}.contributors-table th,.contributors-table td{border-color:#fff3;color:inherit;padding:.15rem .5rem .15rem 0;vertical-align:top}.contributors-table th{opacity:.7}.contributors-table ::ng-deep .katex{font-size:1em}.aggregated-formulas-rules{max-height:50vh}\n"], dependencies: [{ kind: "directive", type: KatexDirective, selector: "[heKatex]", inputs: ["heKatex", "heKatexInline"] }, { kind: "component", type: NodeLinkComponent, selector: "he-node-link", inputs: ["node", "dataState", "showExternalLink", "linkClass"] }, { kind: "component", type: FormulaBlockComponent, selector: "he-formula-block", inputs: ["formulas", "hasSubstitutions", "emptyTitle", "heading", "note", "showToggle", "collapsible", "open", "substituted"], outputs: ["openChange", "substitutedChange"] }, { kind: "component", type: CollapsibleBlockComponent, selector: "he-collapsible-block", inputs: ["heading", "collapsible", "open"], outputs: ["openChange"] }, { kind: "pipe", type: DefaultPipe, name: "default" }, { kind: "pipe", type: PrecisionPipe, name: "precision" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.0.6", type: NodeAggregatedFormulasComponent, isStandalone: true, selector: "he-node-aggregated-formulas", inputs: { termType: { classPropertyName: "termType", publicName: "termType", isSignal: true, isRequired: false, transformFunction: null }, termId: { classPropertyName: "termId", publicName: "termId", isSignal: true, isRequired: false, transformFunction: null }, nodeKey: { classPropertyName: "nodeKey", publicName: "nodeKey", isSignal: true, isRequired: false, transformFunction: null }, values: { classPropertyName: "values", publicName: "values", isSignal: true, isRequired: false, transformFunction: null }, worldAggregation: { classPropertyName: "worldAggregation", publicName: "worldAggregation", isSignal: true, isRequired: false, transformFunction: null }, subAggregation: { classPropertyName: "subAggregation", publicName: "subAggregation", isSignal: true, isRequired: false, transformFunction: null }, substituted: { classPropertyName: "substituted", publicName: "substituted", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { substituted: "substitutedChange" }, ngImport: i0, template: "@if (renderedSections().length) {\n  <div class=\"aggregated-formulas\">\n    <p class=\"is-size-7 is-mb-2 | formula-intro\">\n      Aggregated values are calculated from the underlying {{ contributor().group }}, not measured. These are the rules\n      that produced this one, in the order they are applied.\n    </p>\n\n    <div class=\"is-pt-2 is-pr-1 is-overflow-y-auto | aggregated-formulas-rules\">\n      @for (section of renderedSections(); track section.id; let first = $first) {\n        <he-formula-block\n          [formulas]=\"section.formulas\"\n          [heading]=\"section.heading\"\n          [collapsible]=\"true\"\n          [showToggle]=\"first\"\n          [hasSubstitutions]=\"hasSubstitutions()\"\n          [(substituted)]=\"substituted\"\n          emptyTitle=\"No recorded values to substitute\" />\n\n        <!-- the contributors sit between the two calculations: what went in, above how a weight is derived -->\n        @if (section.id === 'value' && contributors(); as table) {\n          <he-collapsible-block [heading]=\"contributor().heading\">\n            @if (table.rows.length) {\n              <table class=\"table is-narrow is-size-7 w-100 | contributors-table\">\n                <thead>\n                  <tr>\n                    <th>{{ contributor().row }}</th>\n                    @for (column of table.columns; track column.symbol) {\n                      <th class=\"has-text-right\">\n                        <span [heKatex]=\"column.symbol\" [heKatexInline]=\"true\"></span>\n                      </th>\n                    }\n                  </tr>\n                </thead>\n                <tbody>\n                  @for (row of table.rows; track row.id) {\n                    <tr>\n                      <td [attr.title]=\"row.id\">\n                        <he-node-link [node]=\"row.node\" linkClass=\"has-text-white\">\n                          <span class=\"break-word\">{{ row.label }}</span>\n                        </he-node-link>\n                      </td>\n                      @for (value of row.values; track $index) {\n                        <td class=\"has-text-right is-nowrap\">{{ value | precision: 4 | default: '-' }}</td>\n                      }\n                    </tr>\n                  }\n                </tbody>\n              </table>\n            } @else {\n              <p class=\"is-size-7\">\n                Combined from {{ table.count }} {{ contributor().group }}, too many for the aggregation to record one by\n                one.\n              </p>\n            }\n          </he-collapsible-block>\n        }\n      }\n    </div>\n  </div>\n}\n", styles: [".formula-intro{opacity:.85}.contributors-table{background-color:transparent;color:inherit}.contributors-table th,.contributors-table td{border-color:#fff3;color:inherit;padding:.15rem .5rem .15rem 0;vertical-align:top}.contributors-table th{opacity:.7}.contributors-table ::ng-deep .katex{font-size:1em}.aggregated-formulas-rules{max-height:50vh}\n"], dependencies: [{ kind: "directive", type: KatexDirective, selector: "[heKatex]", inputs: ["heKatex", "heKatexInline"] }, { kind: "component", type: NodeLinkComponent, selector: "he-node-link", inputs: ["node", "dataState", "showExternalLink", "linkClass"] }, { kind: "component", type: FormulaBlockComponent, selector: "he-formula-block", inputs: ["formulas", "hasSubstitutions", "emptyTitle", "heading", "note", "showToggle", "collapsible", "open", "substituted"], outputs: ["openChange", "substitutedChange"] }, { kind: "component", type: CollapsibleBlockComponent, selector: "he-collapsible-block", inputs: ["heading", "collapsible", "open"], outputs: ["openChange"] }, { kind: "pipe", type: DefaultPipe, name: "default" }, { kind: "pipe", type: PrecisionPipe, name: "precision" }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NodeAggregatedFormulasComponent, decorators: [{
             type: Component$1,
@@ -12097,14 +12118,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.6", ngImpor
                         NodeLinkComponent,
                         FormulaBlockComponent,
                         CollapsibleBlockComponent
-                    ], template: "@if (renderedSections().length) {\n  <div class=\"aggregated-formulas\">\n    <p class=\"is-size-7 is-mb-2 | formula-intro\">\n      Aggregated values are calculated from the underlying Cycles, not measured. These are the rules that produced this\n      one, in the order they are applied.\n    </p>\n\n    <div class=\"is-pt-2 is-pr-1 is-overflow-y-auto | aggregated-formulas-rules\">\n      @for (section of renderedSections(); track section.id; let first = $first) {\n        <he-formula-block\n          [formulas]=\"section.formulas\"\n          [heading]=\"section.heading\"\n          [collapsible]=\"true\"\n          [showToggle]=\"first\"\n          [hasSubstitutions]=\"hasSubstitutions()\"\n          [(substituted)]=\"substituted\"\n          emptyTitle=\"No recorded values to substitute\" />\n\n        <!-- the values combined sit between the two calculations: what went in, above how each was weighted -->\n        @if (section.id === 'value' && contributors(); as table) {\n          <he-collapsible-block heading=\"Values combined\">\n            @if (table.rows.length) {\n              <table class=\"table is-narrow is-size-7 w-100 | contributors-table\">\n                <thead>\n                  <tr>\n                    <th>Cycle</th>\n                    @for (column of table.columns; track column.symbol) {\n                      <th class=\"has-text-right\">\n                        <span [heKatex]=\"column.symbol\" [heKatexInline]=\"true\"></span>\n                      </th>\n                    }\n                  </tr>\n                </thead>\n                <tbody>\n                  @for (row of table.rows; track row.id) {\n                    <tr>\n                      <td [attr.title]=\"row.id\">\n                        <he-node-link [node]=\"row.node\" linkClass=\"has-text-white\">\n                          <span class=\"break-word\">{{ row.label }}</span>\n                        </he-node-link>\n                      </td>\n                      @for (value of row.values; track $index) {\n                        <td class=\"has-text-right is-nowrap\">{{ value | precision: 4 | default: '-' }}</td>\n                      }\n                    </tr>\n                  }\n                </tbody>\n              </table>\n            } @else {\n              <p class=\"is-size-7\">\n                Combined from {{ table.count }} Cycles, too many for the aggregation to record one by one.\n              </p>\n            }\n          </he-collapsible-block>\n        }\n      }\n    </div>\n  </div>\n}\n", styles: [".formula-intro{opacity:.85}.contributors-table{background-color:transparent;color:inherit}.contributors-table th,.contributors-table td{border-color:#fff3;color:inherit;padding:.15rem .5rem .15rem 0;vertical-align:top}.contributors-table th{opacity:.7}.contributors-table ::ng-deep .katex{font-size:1em}.aggregated-formulas-rules{max-height:50vh}\n"] }]
+                    ], template: "@if (renderedSections().length) {\n  <div class=\"aggregated-formulas\">\n    <p class=\"is-size-7 is-mb-2 | formula-intro\">\n      Aggregated values are calculated from the underlying {{ contributor().group }}, not measured. These are the rules\n      that produced this one, in the order they are applied.\n    </p>\n\n    <div class=\"is-pt-2 is-pr-1 is-overflow-y-auto | aggregated-formulas-rules\">\n      @for (section of renderedSections(); track section.id; let first = $first) {\n        <he-formula-block\n          [formulas]=\"section.formulas\"\n          [heading]=\"section.heading\"\n          [collapsible]=\"true\"\n          [showToggle]=\"first\"\n          [hasSubstitutions]=\"hasSubstitutions()\"\n          [(substituted)]=\"substituted\"\n          emptyTitle=\"No recorded values to substitute\" />\n\n        <!-- the contributors sit between the two calculations: what went in, above how a weight is derived -->\n        @if (section.id === 'value' && contributors(); as table) {\n          <he-collapsible-block [heading]=\"contributor().heading\">\n            @if (table.rows.length) {\n              <table class=\"table is-narrow is-size-7 w-100 | contributors-table\">\n                <thead>\n                  <tr>\n                    <th>{{ contributor().row }}</th>\n                    @for (column of table.columns; track column.symbol) {\n                      <th class=\"has-text-right\">\n                        <span [heKatex]=\"column.symbol\" [heKatexInline]=\"true\"></span>\n                      </th>\n                    }\n                  </tr>\n                </thead>\n                <tbody>\n                  @for (row of table.rows; track row.id) {\n                    <tr>\n                      <td [attr.title]=\"row.id\">\n                        <he-node-link [node]=\"row.node\" linkClass=\"has-text-white\">\n                          <span class=\"break-word\">{{ row.label }}</span>\n                        </he-node-link>\n                      </td>\n                      @for (value of row.values; track $index) {\n                        <td class=\"has-text-right is-nowrap\">{{ value | precision: 4 | default: '-' }}</td>\n                      }\n                    </tr>\n                  }\n                </tbody>\n              </table>\n            } @else {\n              <p class=\"is-size-7\">\n                Combined from {{ table.count }} {{ contributor().group }}, too many for the aggregation to record one by\n                one.\n              </p>\n            }\n          </he-collapsible-block>\n        }\n      }\n    </div>\n  </div>\n}\n", styles: [".formula-intro{opacity:.85}.contributors-table{background-color:transparent;color:inherit}.contributors-table th,.contributors-table td{border-color:#fff3;color:inherit;padding:.15rem .5rem .15rem 0;vertical-align:top}.contributors-table th{opacity:.7}.contributors-table ::ng-deep .katex{font-size:1em}.aggregated-formulas-rules{max-height:50vh}\n"] }]
         }], propDecorators: { termType: [{ type: i0.Input, args: [{ isSignal: true, alias: "termType", required: false }] }], termId: [{ type: i0.Input, args: [{ isSignal: true, alias: "termId", required: false }] }], nodeKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "nodeKey", required: false }] }], values: [{ type: i0.Input, args: [{ isSignal: true, alias: "values", required: false }] }], worldAggregation: [{ type: i0.Input, args: [{ isSignal: true, alias: "worldAggregation", required: false }] }], subAggregation: [{ type: i0.Input, args: [{ isSignal: true, alias: "subAggregation", required: false }] }], substituted: [{ type: i0.Input, args: [{ isSignal: true, alias: "substituted", required: false }] }, { type: i0.Output, args: ["substitutedChange"] }] } });
 
 // the `.jlog` entries the aggregation records are tagged with its own model name
 const JLOG_MODEL = 'aggregation';
 const LOGS_KEY = 'logs';
 // the table of contributors an aggregated value is recorded with, one row per Cycle it was
-// combined from: `id:<cycle id>_value:<value>_weight:<weight>;...`
+// combined from: `id:<cycle id>_value:<value>_weight:<weight>;...`. The value column is only
+// there where the contributors are sub-aggregations - the Cycles behind one record their
+// weight alone, as there can be tens of thousands of them.
 const WEIGHTS_KEY = 'weights';
 const ID_COLUMN = 'id:';
 /**