@unofficialbox/box-open-elements 0.1.0

package/dist/components/forms/combobox.js

@@ -0,0 +1,234 @@
+import { FormAssociatedElement, boeFormFieldErrorStyles, formErrorMessageMarkup, } from "../../core/index.js";
+import { boeNeutralInteractiveStyles } from "../../foundations/tokens/index.js";
+import { boeMotionDuration, boeMotionEasing } from "../../foundations/motion/index.js";
+import { boeRadius } from "../../foundations/geometry/index.js";
+const DEFAULT_TAG_NAME = "box-combobox";
+const escapeHtml = (value) => value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#39;");
+const comboboxStyles = `
+  :host {
+    display: block;
+    color: inherit;
+    font: inherit;
+  }
+
+  [part="field"] {
+    display: grid;
+    gap: 0.45rem;
+  }
+
+  [part="label"] {
+    font-size: 0.8rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: var(--boe-token-text-text-secondary, #6f6f6f);
+  }
+
+  [part="input"] {
+    appearance: none;
+    font: inherit;
+    color: var(--boe-token-text-text, #222222);
+    padding: 0.45rem 0.7rem;
+    border: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 78%, var(--boe-token-surface-surface, #ffffff) 22%);
+    border-radius: ${boeRadius.control};
+    background: var(--boe-token-surface-surface, #ffffff);
+    transition:
+      border-color ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+      background ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+      box-shadow ${boeMotionDuration.interactive} ${boeMotionEasing.standard};
+  }
+
+  [part="input"]::placeholder {
+    color: var(--boe-token-text-text-placeholder, #909090);
+  }
+
+  ${boeNeutralInteractiveStyles('[part="input"]')}
+
+  [part="input"]:focus-visible {
+    border-color: var(--boe-token-surface-surface-brand, #0061d5);
+  }
+
+  ${boeFormFieldErrorStyles}
+`;
+export class BoxComboboxElement extends FormAssociatedElement {
+    static get observedAttributes() {
+        return [
+            ...FormAssociatedElement.formObservedAttributes,
+            "disabled",
+            "label",
+            "options",
+            "placeholder",
+            "value",
+        ];
+    }
+    valueInternal = "";
+    inputEl;
+    labelEl;
+    datalistEl;
+    errorEl;
+    findOptionByLabel(label) {
+        return this.options.find(option => option.label === label);
+    }
+    findOptionByValue(value) {
+        return this.options.find(option => option.value === value);
+    }
+    getDisplayValue() {
+        const matched = this.findOptionByValue(this.valueInternal);
+        return matched?.label ?? this.valueInternal;
+    }
+    resolveInputValue(rawValue) {
+        const matched = this.findOptionByLabel(rawValue);
+        return matched?.value ?? rawValue;
+    }
+    commitInputValue(rawValue) {
+        const resolvedValue = this.resolveInputValue(rawValue);
+        this.valueInternal = resolvedValue;
+        this.setAttribute("value", resolvedValue);
+        this.syncFormAssociation();
+        this.dispatchEvent(new CustomEvent("value-changed", {
+            bubbles: true,
+            composed: true,
+            detail: { value: resolvedValue },
+        }));
+        if (this.shadowRoot?.activeElement !== this.inputEl) {
+            this.inputEl.value = this.getDisplayValue();
+        }
+    }
+    get disabled() {
+        return this.hasAttribute("disabled");
+    }
+    set disabled(value) {
+        if (value) {
+            this.setAttribute("disabled", "");
+        }
+        else {
+            this.removeAttribute("disabled");
+        }
+    }
+    get label() {
+        return this.getAttribute("label") ?? "Combobox";
+    }
+    set label(value) {
+        this.setAttribute("label", value);
+    }
+    get options() {
+        const raw = this.getAttribute("options");
+        if (!raw) {
+            return [];
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    set options(value) {
+        this.setAttribute("options", JSON.stringify(value));
+    }
+    get placeholder() {
+        return this.getAttribute("placeholder") ?? "";
+    }
+    set placeholder(value) {
+        this.setAttribute("placeholder", value);
+    }
+    get value() {
+        return this.valueInternal;
+    }
+    set value(nextValue) {
+        this.valueInternal = nextValue;
+        this.setAttribute("value", nextValue);
+        if (this.isRendered) {
+            this.update();
+        }
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (name === "value") {
+            this.valueInternal = this.getAttribute("value") ?? "";
+        }
+        super.attributeChangedCallback(name, oldValue, newValue);
+    }
+    getFormValue() {
+        return this.valueInternal;
+    }
+    restoreFormValue(value) {
+        const next = typeof value === "string" ? value : "";
+        this.valueInternal = next;
+        this.setAttribute("value", next);
+        if (this.isRendered) {
+            this.update();
+        }
+    }
+    renderTemplate() {
+        if (!this.shadowRoot) {
+            return;
+        }
+        this.shadowRoot.innerHTML = `
+      <style>${comboboxStyles}</style>
+      <label part="field">
+        <span part="label"></span>
+        <input type="text" part="input" list="combobox-options" />
+        <datalist id="combobox-options"></datalist>
+        ${formErrorMessageMarkup()}
+      </label>
+    `;
+        this.labelEl = this.shadowRoot.querySelector('[part="label"]');
+        this.inputEl = this.shadowRoot.querySelector('[part="input"]');
+        this.datalistEl = this.shadowRoot.querySelector("datalist");
+        this.errorEl = this.shadowRoot.querySelector('[part="error-message"]');
+    }
+    setupListeners() {
+        this.inputEl.addEventListener("input", event => {
+            const rawValue = event.currentTarget.value;
+            this.commitInputValue(rawValue);
+        });
+        this.inputEl.addEventListener("change", event => {
+            const rawValue = event.currentTarget.value;
+            this.commitInputValue(rawValue);
+        });
+        this.inputEl.addEventListener("blur", () => {
+            const rawValue = this.inputEl.value;
+            const resolvedValue = this.resolveInputValue(rawValue);
+            if (resolvedValue !== this.valueInternal) {
+                this.commitInputValue(rawValue);
+            }
+            else if (rawValue !== this.getDisplayValue()) {
+                this.inputEl.value = this.getDisplayValue();
+            }
+        });
+    }
+    update() {
+        if (!this.inputEl || !this.labelEl || !this.datalistEl || !this.errorEl) {
+            return;
+        }
+        this.labelEl.textContent = this.label;
+        this.inputEl.placeholder = this.placeholder;
+        this.datalistEl.innerHTML = this.options
+            .map(option => `<option value="${escapeHtml(option.label)}" data-option-value="${escapeHtml(option.value)}"></option>`)
+            .join("");
+        if (this.shadowRoot?.activeElement !== this.inputEl) {
+            this.inputEl.value = this.getDisplayValue();
+        }
+        if (this.disabled) {
+            this.inputEl.setAttribute("disabled", "");
+        }
+        else {
+            this.inputEl.removeAttribute("disabled");
+        }
+        this.applyInvalidState(this.inputEl, this.errorEl);
+    }
+}
+export const defineBoxComboboxElement = (tagName = DEFAULT_TAG_NAME) => {
+    const existingElement = customElements.get(tagName);
+    if (existingElement) {
+        return existingElement;
+    }
+    customElements.define(tagName, BoxComboboxElement);
+    return BoxComboboxElement;
+};

package/dist/components/forms/date-field.d.ts

@@ -0,0 +1,27 @@
+import { FormAssociatedElement } from "../../core/index.js";
+import type { FormValue } from "../../core/index.js";
+export declare class BoxDateFieldElement extends FormAssociatedElement {
+    static get observedAttributes(): string[];
+    private valueInternal;
+    private inputEl;
+    private labelEl;
+    private errorEl;
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get label(): string;
+    set label(value: string);
+    get max(): string;
+    set max(value: string);
+    get min(): string;
+    set min(value: string);
+    get value(): string;
+    set value(nextValue: string);
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    protected getFormValue(): FormValue;
+    protected restoreFormValue(value: FormValue): void;
+    private syncValue;
+    protected renderTemplate(): void;
+    protected setupListeners(): void;
+    protected update(): void;
+}
+export declare const defineBoxDateFieldElement: (tagName?: string) => typeof BoxDateFieldElement;

package/dist/components/forms/date-field.js

@@ -0,0 +1,187 @@
+import { FormAssociatedElement, boeFormFieldErrorStyles, formErrorMessageMarkup, } from "../../core/index.js";
+import { boeNeutralInteractiveStyles } from "../../foundations/tokens/index.js";
+import { boeMotionDuration, boeMotionEasing } from "../../foundations/motion/index.js";
+import { boeRadius } from "../../foundations/geometry/index.js";
+const DEFAULT_TAG_NAME = "box-date-field";
+const dateFieldStyles = `
+  :host {
+    display: block;
+    color: inherit;
+    font: inherit;
+  }
+
+  [part="field"] {
+    display: grid;
+    gap: 0.45rem;
+  }
+
+  [part="label"] {
+    font-size: 0.8rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: var(--boe-token-text-text-secondary, #6f6f6f);
+  }
+
+  [part="input"] {
+    appearance: none;
+    font: inherit;
+    color: var(--boe-token-text-text, #222222);
+    accent-color: var(--boe-token-surface-surface-brand, #0061d5);
+    padding: 0.45rem 0.7rem;
+    border: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 78%, var(--boe-token-surface-surface, #ffffff) 22%);
+    border-radius: ${boeRadius.control};
+    background: var(--boe-token-surface-surface, #ffffff);
+    transition:
+      border-color ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+      background ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+      box-shadow ${boeMotionDuration.interactive} ${boeMotionEasing.standard};
+  }
+
+  ${boeNeutralInteractiveStyles('[part="input"]')}
+
+  [part="input"]:focus-visible {
+    border-color: var(--boe-token-surface-surface-brand, #0061d5);
+  }
+
+  ${boeFormFieldErrorStyles}
+`;
+export class BoxDateFieldElement extends FormAssociatedElement {
+    static get observedAttributes() {
+        return [
+            ...FormAssociatedElement.formObservedAttributes,
+            "disabled",
+            "label",
+            "max",
+            "min",
+            "value",
+        ];
+    }
+    valueInternal = "";
+    inputEl;
+    labelEl;
+    errorEl;
+    get disabled() {
+        return this.hasAttribute("disabled");
+    }
+    set disabled(value) {
+        if (value) {
+            this.setAttribute("disabled", "");
+        }
+        else {
+            this.removeAttribute("disabled");
+        }
+    }
+    get label() {
+        return this.getAttribute("label") ?? "Date";
+    }
+    set label(value) {
+        this.setAttribute("label", value);
+    }
+    get max() {
+        return this.getAttribute("max") ?? "";
+    }
+    set max(value) {
+        this.setAttribute("max", value);
+    }
+    get min() {
+        return this.getAttribute("min") ?? "";
+    }
+    set min(value) {
+        this.setAttribute("min", value);
+    }
+    get value() {
+        return this.valueInternal;
+    }
+    set value(nextValue) {
+        this.valueInternal = nextValue;
+        this.setAttribute("value", nextValue);
+        if (this.isRendered) {
+            this.update();
+        }
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (name === "value") {
+            this.valueInternal = this.getAttribute("value") ?? "";
+        }
+        super.attributeChangedCallback(name, oldValue, newValue);
+    }
+    getFormValue() {
+        return this.valueInternal;
+    }
+    restoreFormValue(value) {
+        const next = typeof value === "string" ? value : "";
+        this.valueInternal = next;
+        this.setAttribute("value", next);
+        if (this.isRendered) {
+            this.update();
+        }
+    }
+    syncValue(nextValue) {
+        this.valueInternal = nextValue;
+        this.setAttribute("value", nextValue);
+        this.syncFormAssociation();
+        this.dispatchEvent(new CustomEvent("value-changed", {
+            bubbles: true,
+            composed: true,
+            detail: { value: nextValue },
+        }));
+    }
+    renderTemplate() {
+        if (!this.shadowRoot) {
+            return;
+        }
+        this.shadowRoot.innerHTML = `
+      <style>${dateFieldStyles}</style>
+      <label part="field">
+        <span part="label"></span>
+        <input type="date" part="input" />
+        ${formErrorMessageMarkup()}
+      </label>
+    `;
+        this.labelEl = this.shadowRoot.querySelector('[part="label"]');
+        this.inputEl = this.shadowRoot.querySelector('[part="input"]');
+        this.errorEl = this.shadowRoot.querySelector('[part="error-message"]');
+    }
+    setupListeners() {
+        this.inputEl.addEventListener("input", event => {
+            this.syncValue(event.currentTarget.value);
+        });
+    }
+    update() {
+        if (!this.inputEl || !this.labelEl || !this.errorEl) {
+            return;
+        }
+        this.labelEl.textContent = this.label;
+        if (this.min) {
+            this.inputEl.min = this.min;
+        }
+        else {
+            this.inputEl.removeAttribute("min");
+        }
+        if (this.max) {
+            this.inputEl.max = this.max;
+        }
+        else {
+            this.inputEl.removeAttribute("max");
+        }
+        if (this.shadowRoot?.activeElement !== this.inputEl) {
+            this.inputEl.value = this.valueInternal;
+        }
+        if (this.disabled) {
+            this.inputEl.setAttribute("disabled", "");
+        }
+        else {
+            this.inputEl.removeAttribute("disabled");
+        }
+        this.applyInvalidState(this.inputEl, this.errorEl);
+    }
+}
+export const defineBoxDateFieldElement = (tagName = DEFAULT_TAG_NAME) => {
+    const existingElement = customElements.get(tagName);
+    if (existingElement) {
+        return existingElement;
+    }
+    customElements.define(tagName, BoxDateFieldElement);
+    return BoxDateFieldElement;
+};

package/dist/components/forms/dropdown.d.ts

@@ -0,0 +1,38 @@
+import { FormAssociatedElement } from "../../core/index.js";
+import type { FormValue } from "../../core/index.js";
+type BoxDropdownItem = {
+    id: string;
+    label: string;
+};
+export declare class BoxDropdownElement extends FormAssociatedElement {
+    static get observedAttributes(): string[];
+    private open;
+    private valueInternal;
+    private rootEl;
+    private triggerEl;
+    private errorEl;
+    private menuEl;
+    private readonly focusRestore;
+    private readonly onDocumentPointerDown;
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get label(): string;
+    set label(value: string);
+    get items(): BoxDropdownItem[];
+    set items(value: BoxDropdownItem[]);
+    get value(): string;
+    set value(nextValue: string);
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    protected getFormValue(): FormValue;
+    protected restoreFormValue(value: FormValue): void;
+    disconnectedCallback(): void;
+    private openMenu;
+    private closeMenu;
+    private selectItem;
+    private menuItems;
+    protected renderTemplate(): void;
+    protected setupListeners(): void;
+    protected update(): void;
+}
+export declare const defineBoxDropdownElement: (tagName?: string) => typeof BoxDropdownElement;
+export {};