@internetarchive/collection-browser 3.3.2 → 3.3.3

package/dist/src/expanded-date-picker.js

@@ -0,0 +1,182 @@
+import { __decorate } from "tslib";
+import { css, html, LitElement, nothing, } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { ifDefined } from 'lit/directives/if-defined.js';
+import { msg } from '@lit/localize';
+import { analyticsActions, analyticsCategories, } from './utils/analytics-events';
+import '@internetarchive/histogram-date-range';
+let ExpandedDatePicker = class ExpandedDatePicker extends LitElement {
+    constructor() {
+        super(...arguments);
+        this.binSnapping = 'none';
+        this.barScaling = 'logarithmic';
+        /**
+         * Closes the modal dialog if the given event is pressing the Esc key.
+         * Arrow function to ensure `this` remains bound to the current component.
+         */
+        this.boundEscapeListener = (e) => {
+            if (e.key === 'Escape') {
+                this.closeModal();
+            }
+        };
+    }
+    render() {
+        var _a, _b, _c;
+        return html `
+      <div id="container">
+        <histogram-date-range
+          id="date-picker"
+          .minDate=${this.minDate}
+          .maxDate=${this.maxDate}
+          .minSelectedDate=${(_a = this.minSelectedDate) !== null && _a !== void 0 ? _a : this.minDate}
+          .maxSelectedDate=${(_b = this.maxSelectedDate) !== null && _b !== void 0 ? _b : this.maxDate}
+          dateFormat=${ifDefined(this.customDateFormat)}
+          tooltipDateFormat=${ifDefined(this.customTooltipDateFormat)}
+          tooltipLabel=${ifDefined(this.customTooltipLabel)}
+          .binSnapping=${this.binSnapping}
+          .barScaling=${(_c = this.barScaling) !== null && _c !== void 0 ? _c : nothing}
+          .updateDelay=${0}
+          updateWhileFocused
+          missingDataMessage="..."
+          .width=${560}
+          .height=${120}
+          .bins=${this.buckets}
+          @histogramDateRangeUpdated=${this.histogramDateRangeUpdated}
+        >
+          <button
+            id="apply-btn"
+            slot="inputs-right-side"
+            @click=${this.applyBtnClicked}
+          >
+            ${msg('Apply date range')}
+          </button>
+        </histogram-date-range>
+      </div>
+    `;
+    }
+    connectedCallback() {
+        var _a;
+        (_a = super.connectedCallback) === null || _a === void 0 ? void 0 : _a.call(this);
+        this.setupEscapeListener();
+    }
+    disconnectedCallback() {
+        var _a;
+        (_a = super.disconnectedCallback) === null || _a === void 0 ? void 0 : _a.call(this);
+        this.removeEscapeListener();
+    }
+    /**
+     * Add an event listener to close the date picker modal when the Esc key is pressed
+     */
+    setupEscapeListener() {
+        document.addEventListener('keydown', this.boundEscapeListener);
+    }
+    /**
+     * Remove the Esc key listener that was previously added
+     */
+    removeEscapeListener() {
+        document.removeEventListener('keydown', this.boundEscapeListener);
+    }
+    /**
+     * When the histogram is updated, keep track of the newly selected date range.
+     * We don't commit to the new range until the apply button is clicked.
+     */
+    histogramDateRangeUpdated(e) {
+        this.minSelectedDate = e.detail.minDate;
+        this.maxSelectedDate = e.detail.maxDate;
+    }
+    /**
+     * When the Apply button is clicked, emit the current date range and close the modal.
+     */
+    applyBtnClicked() {
+        var _a;
+        const event = new CustomEvent('histogramDateRangeApplied', {
+            detail: {
+                minDate: this.minSelectedDate,
+                maxDate: this.maxSelectedDate,
+            },
+        });
+        this.dispatchEvent(event);
+        this.closeModal();
+        (_a = this.analyticsHandler) === null || _a === void 0 ? void 0 : _a.sendEvent({
+            category: analyticsCategories.default,
+            action: analyticsActions.histogramChangedFromModal,
+            label: window.location.href,
+        });
+    }
+    /**
+     * Closes the modal associated with this component (if it exists) and dispatches a
+     * modalClosed event.
+     */
+    closeModal() {
+        if (this.modalManager) {
+            this.modalManager.closeModal();
+            this.dispatchEvent(new CustomEvent('modalClosed'));
+        }
+    }
+    static get styles() {
+        return css `
+      #container {
+        display: flex;
+        justify-content: center;
+        padding: 40px 10px 10px;
+        overflow: hidden;
+      }
+
+      #date-picker {
+        --histogramDateRangeInputWidth: 50px;
+        --histogramDateRangeInputRowMargin: 5px 0 0 0;
+      }
+
+      #apply-btn {
+        margin: 0 0 0 5px;
+        padding: 8px 10px;
+        border: 0;
+        border-radius: 4px;
+        background: var(--primaryButtonBGColor, #194880);
+        color: white;
+        cursor: pointer;
+      }
+    `;
+    }
+};
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "minDate", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "maxDate", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "minSelectedDate", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "maxSelectedDate", void 0);
+__decorate([
+    property({ type: Array })
+], ExpandedDatePicker.prototype, "buckets", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "customDateFormat", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "customTooltipDateFormat", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "customTooltipLabel", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "binSnapping", void 0);
+__decorate([
+    property({ type: String })
+], ExpandedDatePicker.prototype, "barScaling", void 0);
+__decorate([
+    property({ type: Object, attribute: false })
+], ExpandedDatePicker.prototype, "modalManager", void 0);
+__decorate([
+    property({ type: Object, attribute: false })
+], ExpandedDatePicker.prototype, "analyticsHandler", void 0);
+ExpandedDatePicker = __decorate([
+    customElement('expanded-date-picker')
+], ExpandedDatePicker);
+export { ExpandedDatePicker };
+//# sourceMappingURL=expanded-date-picker.js.map

package/dist/src/expanded-date-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expanded-date-picker.js","sourceRoot":"","sources":["../../src/expanded-date-picker.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  css,\n  html,\n  LitElement,\n  CSSResultGroup,\n  TemplateResult,\n  nothing,\n} from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { msg } from '@lit/localize';\nimport type { ModalManagerInterface } from '@internetarchive/modal-manager';\nimport type { AnalyticsManagerInterface } from '@internetarchive/analytics-manager';\nimport {\n  BarScalingOption,\n  BinSnappingInterval,\n} from '@internetarchive/histogram-date-range';\nimport {\n  analyticsActions,\n  analyticsCategories,\n} from './utils/analytics-events';\n\nimport '@internetarchive/histogram-date-range';\n\n@customElement('expanded-date-picker')\nexport class ExpandedDatePicker extends LitElement {\n  @property({ type: String }) minDate?: string;\n\n  @property({ type: String }) maxDate?: string;\n\n  @property({ type: String }) minSelectedDate?: string;\n\n  @property({ type: String }) maxSelectedDate?: string;\n\n  @property({ type: Array }) buckets?: number[];\n\n  @property({ type: String }) customDateFormat?: string;\n\n  @property({ type: String }) customTooltipDateFormat?: string;\n\n  @property({ type: String }) customTooltipLabel?: string;\n\n  @property({ type: String }) binSnapping: BinSnappingInterval = 'none';\n\n  @property({ type: String }) barScaling: BarScalingOption = 'logarithmic';\n\n  @property({ type: Object, attribute: false })\n  modalManager?: ModalManagerInterface;\n\n  @property({ type: Object, attribute: false })\n  analyticsHandler?: AnalyticsManagerInterface;\n\n  render(): TemplateResult {\n    return html`\n      <div id=\"container\">\n        <histogram-date-range\n          id=\"date-picker\"\n          .minDate=${this.minDate}\n          .maxDate=${this.maxDate}\n          .minSelectedDate=${this.minSelectedDate ?? this.minDate}\n          .maxSelectedDate=${this.maxSelectedDate ?? this.maxDate}\n          dateFormat=${ifDefined(this.customDateFormat)}\n          tooltipDateFormat=${ifDefined(this.customTooltipDateFormat)}\n          tooltipLabel=${ifDefined(this.customTooltipLabel)}\n          .binSnapping=${this.binSnapping}\n          .barScaling=${this.barScaling ?? nothing}\n          .updateDelay=${0}\n          updateWhileFocused\n          missingDataMessage=\"...\"\n          .width=${560}\n          .height=${120}\n          .bins=${this.buckets}\n          @histogramDateRangeUpdated=${this.histogramDateRangeUpdated}\n        >\n          <button\n            id=\"apply-btn\"\n            slot=\"inputs-right-side\"\n            @click=${this.applyBtnClicked}\n          >\n            ${msg('Apply date range')}\n          </button>\n        </histogram-date-range>\n      </div>\n    `;\n  }\n\n  connectedCallback(): void {\n    super.connectedCallback?.();\n    this.setupEscapeListener();\n  }\n\n  disconnectedCallback(): void {\n    super.disconnectedCallback?.();\n    this.removeEscapeListener();\n  }\n\n  /**\n   * Add an event listener to close the date picker modal when the Esc key is pressed\n   */\n  private setupEscapeListener() {\n    document.addEventListener('keydown', this.boundEscapeListener);\n  }\n\n  /**\n   * Remove the Esc key listener that was previously added\n   */\n  private removeEscapeListener() {\n    document.removeEventListener('keydown', this.boundEscapeListener);\n  }\n\n  /**\n   * Closes the modal dialog if the given event is pressing the Esc key.\n   * Arrow function to ensure `this` remains bound to the current component.\n   */\n  private boundEscapeListener = (e: KeyboardEvent) => {\n    if (e.key === 'Escape') {\n      this.closeModal();\n    }\n  };\n\n  /**\n   * When the histogram is updated, keep track of the newly selected date range.\n   * We don't commit to the new range until the apply button is clicked.\n   */\n  private histogramDateRangeUpdated(\n    e: CustomEvent<{\n      minDate: string;\n      maxDate: string;\n    }>,\n  ): void {\n    this.minSelectedDate = e.detail.minDate;\n    this.maxSelectedDate = e.detail.maxDate;\n  }\n\n  /**\n   * When the Apply button is clicked, emit the current date range and close the modal.\n   */\n  private applyBtnClicked(): void {\n    const event = new CustomEvent('histogramDateRangeApplied', {\n      detail: {\n        minDate: this.minSelectedDate,\n        maxDate: this.maxSelectedDate,\n      },\n    });\n    this.dispatchEvent(event);\n    this.closeModal();\n\n    this.analyticsHandler?.sendEvent({\n      category: analyticsCategories.default,\n      action: analyticsActions.histogramChangedFromModal,\n      label: window.location.href,\n    });\n  }\n\n  /**\n   * Closes the modal associated with this component (if it exists) and dispatches a\n   * modalClosed event.\n   */\n  private closeModal(): void {\n    if (this.modalManager) {\n      this.modalManager.closeModal();\n      this.dispatchEvent(new CustomEvent('modalClosed'));\n    }\n  }\n\n  static get styles(): CSSResultGroup {\n    return css`\n      #container {\n        display: flex;\n        justify-content: center;\n        padding: 40px 10px 10px;\n        overflow: hidden;\n      }\n\n      #date-picker {\n        --histogramDateRangeInputWidth: 50px;\n        --histogramDateRangeInputRowMargin: 5px 0 0 0;\n      }\n\n      #apply-btn {\n        margin: 0 0 0 5px;\n        padding: 8px 10px;\n        border: 0;\n        border-radius: 4px;\n        background: var(--primaryButtonBGColor, #194880);\n        color: white;\n        cursor: pointer;\n      }\n    `;\n  }\n}\n"]}

package/dist/src/language-code-handler/language-code-handler.d.ts

@@ -0,0 +1,37 @@
+export interface LanguageCodeHandlerInterface {
+    /**
+     * This takes a list of codes in the format `en-us|en|en-gb` and
+     * returns the first language code in the list.
+     *
+     * The codes in the string should always represent the same language name.
+     * eg `en-us`, `en-gb`, and `en` should always be "English"
+     *
+     * @param languageCodes
+     */
+    getLanguageNameFromCodeString(languageCodes: string): string;
+    /**
+     * This creates a serialized string of language codes for the given language.
+     *
+     * eg. `English` becomes `en-us|en|en-gb|.....`
+     *
+     * @param languageName
+     */
+    getCodeStringFromLanguageName(languageName: string): string;
+    /**
+     * Get an array of langauge codes from a serialized string.
+     *
+     * eg. `en-us|en|en-gb` becomes `['en-us', 'en', 'en-gb']`
+     *
+     * @param languageCodes
+     */
+    getCodeArrayFromCodeString(languageCodes: string): string[];
+}
+export declare class LanguageCodeHandler implements LanguageCodeHandlerInterface {
+    private delimeter;
+    /** @inheritdoc */
+    getLanguageNameFromCodeString(languageCodes: string): string;
+    /** @inheritdoc */
+    getCodeStringFromLanguageName(languageName: string): string;
+    /** @inheritdoc */
+    getCodeArrayFromCodeString(languageCodes: string): string[];
+}

package/dist/src/language-code-handler/language-code-handler.js

@@ -0,0 +1,27 @@
+import { codeToLanguageMap } from './language-code-mapping';
+export class LanguageCodeHandler {
+    constructor() {
+        this.delimeter = '|';
+    }
+    /** @inheritdoc */
+    getLanguageNameFromCodeString(languageCodes) {
+        const split = this.getCodeArrayFromCodeString(languageCodes);
+        if (split.length === 0)
+            return '';
+        const languageCode = split[0];
+        const languageName = codeToLanguageMap[languageCode];
+        return languageName !== null && languageName !== void 0 ? languageName : languageCodes;
+    }
+    /** @inheritdoc */
+    getCodeStringFromLanguageName(languageName) {
+        const languageCodes = Object.keys(codeToLanguageMap).filter(code => codeToLanguageMap[code] === languageName);
+        const stringifiedCodes = languageCodes === null || languageCodes === void 0 ? void 0 : languageCodes.join(this.delimeter);
+        return stringifiedCodes;
+    }
+    /** @inheritdoc */
+    getCodeArrayFromCodeString(languageCodes) {
+        const split = languageCodes.split(this.delimeter);
+        return split;
+    }
+}
+//# sourceMappingURL=language-code-handler.js.map

package/dist/src/language-code-handler/language-code-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-code-handler.js","sourceRoot":"","sources":["../../../src/language-code-handler/language-code-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAqC5D,MAAM,OAAO,mBAAmB;IAAhC;QACU,cAAS,GAAG,GAAG,CAAC;IAyB1B,CAAC;IAvBC,kBAAkB;IAClB,6BAA6B,CAAC,aAAqB;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,0BAA0B,CAAC,aAAa,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,YAAY,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACrD,OAAO,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,aAAa,CAAC;IACvC,CAAC;IAED,kBAAkB;IAClB,6BAA6B,CAAC,YAAoB;QAChD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,CACzD,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,YAAY,CACjD,CAAC;QACF,MAAM,gBAAgB,GAAG,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,kBAAkB;IAClB,0BAA0B,CAAC,aAAqB;QAC9C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;CACF","sourcesContent":["import { codeToLanguageMap } from './language-code-mapping';\n\n// To serialize the list of potential language codes, we store\n// the string in the format `en-us|en|en-gb` with `|` being the separator.\n// This allows us to generate a query of `language:(en-us OR en OR en-gb)`\n// when we deserialize the string.\nexport interface LanguageCodeHandlerInterface {\n  /**\n   * This takes a list of codes in the format `en-us|en|en-gb` and\n   * returns the first language code in the list.\n   *\n   * The codes in the string should always represent the same language name.\n   * eg `en-us`, `en-gb`, and `en` should always be \"English\"\n   *\n   * @param languageCodes\n   */\n  getLanguageNameFromCodeString(languageCodes: string): string;\n\n  /**\n   * This creates a serialized string of language codes for the given language.\n   *\n   * eg. `English` becomes `en-us|en|en-gb|.....`\n   *\n   * @param languageName\n   */\n  getCodeStringFromLanguageName(languageName: string): string;\n\n  /**\n   * Get an array of langauge codes from a serialized string.\n   *\n   * eg. `en-us|en|en-gb` becomes `['en-us', 'en', 'en-gb']`\n   *\n   * @param languageCodes\n   */\n  getCodeArrayFromCodeString(languageCodes: string): string[];\n}\n\nexport class LanguageCodeHandler implements LanguageCodeHandlerInterface {\n  private delimeter = '|';\n\n  /** @inheritdoc */\n  getLanguageNameFromCodeString(languageCodes: string): string {\n    const split = this.getCodeArrayFromCodeString(languageCodes);\n    if (split.length === 0) return '';\n    const languageCode = split[0];\n    const languageName = codeToLanguageMap[languageCode];\n    return languageName ?? languageCodes;\n  }\n\n  /** @inheritdoc */\n  getCodeStringFromLanguageName(languageName: string): string {\n    const languageCodes = Object.keys(codeToLanguageMap).filter(\n      code => codeToLanguageMap[code] === languageName,\n    );\n    const stringifiedCodes = languageCodes?.join(this.delimeter);\n    return stringifiedCodes;\n  }\n\n  /** @inheritdoc */\n  getCodeArrayFromCodeString(languageCodes: string): string[] {\n    const split = languageCodes.split(this.delimeter);\n    return split;\n  }\n}\n"]}

package/dist/src/language-code-handler/language-code-mapping.d.ts

@@ -0,0 +1 @@
+export declare const codeToLanguageMap: Record<string, string>;