@sondor-technology/sondor-components 1.0.0-1165-initial-setup.11 → 1.0.0

package/src/components/form/form.ts

@@ -1,376 +1,376 @@
-import {LitElement, html, css} from "lit";
-import {customElement, property, state, queryAssignedElements, query} from "lit/decorators.js";
-import {resetStyles} from "../../styles/reset.js";
-import type {StFormStep} from "./form-step.js";
-
-export type FormLayout = "vertical" | "horizontal" | "inline";
-
-@customElement("st-form")
-export class StForm extends LitElement {
-  @property({type: String, reflect: true}) layout: FormLayout = "vertical";
-  @property({type: Boolean, reflect: true}) loading = false;
-  @property({type: String}) error = "";
-
-  @state() private _currentStepIndex = 0;
-
-  @queryAssignedElements({selector: "st-form-step"})
-  private _stepElements!: StFormStep[];
-
-  @query("form") private _formEl!: HTMLFormElement;
-
-  static styles = [
-    resetStyles,
-    css`
-      :host {
-        display: block;
-        position: relative;
-      }
-
-      form {
-        display: flex;
-        gap: var(--st-spacing-md);
-      }
-
-      /* ==========================================================
-         Layouts
-         ========================================================== */
-      :host([layout="vertical"]) form {
-        flex-direction: column;
-      }
-
-      :host([layout="horizontal"]) form {
-        display: grid;
-        grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
-        align-items: start;
-      }
-
-      :host([layout="inline"]) form {
-        flex-direction: row;
-        align-items: flex-end;
-        flex-wrap: wrap;
-      }
-
-      .has-steps form {
-        display: flex;
-        flex-direction: column;
-      }
-
-      /* ==========================================================
-         Progress Navigation
-         ========================================================== */
-      .progress-nav {
-        display: flex;
-        align-items: center;
-        margin-bottom: var(--st-spacing-xl);
-        padding-bottom: var(--st-spacing-md);
-        overflow-x: auto;
-        scrollbar-width: none;
-      }
-
-      .step-indicator {
-        display: flex;
-        align-items: center;
-        gap: var(--st-spacing-sm);
-        color: var(--st-color-text-muted);
-        font-size: var(--st-font-size-sm);
-        font-weight: var(--st-font-weight-medium);
-        transition: color 0.2s ease;
-      }
-
-      .step-indicator.active {
-        color: var(--st-color-text);
-      }
-      .step-indicator.completed {
-        color: var(--st-color-success);
-      }
-
-      .step-circle {
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        width: 1.75rem;
-        height: 1.75rem;
-        border-radius: 50%;
-        border: 2px solid currentColor;
-        font-size: 0.875rem;
-        background-color: var(--st-color-bg);
-        transition: all 0.2s ease;
-      }
-
-      .step-indicator.active .step-circle {
-        background-color: var(--st-color-primary);
-        border-color: var(--st-color-primary);
-        color: var(--st-color-bg);
-      }
-
-      .step-indicator.completed .step-circle {
-        border-color: var(--st-color-success);
-        background-color: var(--st-color-success-bg, transparent);
-      }
-
-      .step-connector {
-        flex: 1;
-        height: 2px;
-        min-width: 24px;
-        margin: 0 var(--st-spacing-sm);
-        background-color: var(--st-color-border);
-        transition: background-color 0.2s ease;
-      }
-
-      .step-connector.completed {
-        background-color: var(--st-color-success);
-      }
-
-      /* ==========================================================
-         Actions & States
-         ========================================================== */
-      .form-actions {
-        display: flex;
-        gap: var(--st-spacing-md);
-        margin-top: var(--st-spacing-lg);
-        justify-content: flex-end;
-      }
-
-      .loading-overlay {
-        position: absolute;
-        inset: 0;
-        background: rgba(var(--st-color-bg-rgb, 255, 255, 255), 0.7);
-        backdrop-filter: blur(2px);
-        display: flex;
-        align-items: center;
-        justify-content: center;
-        z-index: 10;
-        border-radius: inherit;
-        color: var(--st-color-text);
-        font-weight: var(--st-font-weight-medium);
-        gap: var(--st-spacing-sm);
-      }
-
-      @keyframes pulse {
-        0%,
-        100% {
-          opacity: 1;
-        }
-        50% {
-          opacity: 0.5;
-        }
-      }
-
-      .loading-overlay st-icon {
-        animation: pulse 1.5s cubic-bezier(0.4, 0, 0.6, 1) infinite;
-      }
-    `,
-  ];
-
-  private _handleSlotChange() {
-    if (this._stepElements.length > 0) {
-      this._updateStepVisibility();
-    }
-  }
-
-  private _updateStepVisibility() {
-    this._stepElements.forEach((step, index) => {
-      step.active = index === this._currentStepIndex;
-    });
-    this.requestUpdate();
-  }
-
-  private _validateCurrentContext(): boolean {
-    if (this._stepElements.length === 0) {
-      return this._formEl.checkValidity();
-    }
-
-    const currentStep = this._stepElements[this._currentStepIndex];
-    let isValid = true;
-
-    // Find all custom and native form inputs assigned to the current step
-    const inputs = Array.from(
-      currentStep.querySelectorAll<
-        HTMLElement & {checkValidity?: () => boolean; reportValidity?: () => void}
-      >("*"),
-    );
-
-    for (const input of inputs) {
-      if (typeof input.checkValidity === "function") {
-        if (!input.checkValidity()) {
-          // Focus and report on the first invalid element encountered
-          if (isValid && typeof input.reportValidity === "function") {
-            input.reportValidity();
-          }
-          isValid = false;
-        }
-      }
-    }
-
-    return isValid;
-  }
-
-  private _triggerSubmission() {
-    // HTML5 method that triggers form validation and fires the native submit event
-    this._formEl.requestSubmit();
-  }
-
-  private _prevStep() {
-    if (this._currentStepIndex > 0) {
-      this._currentStepIndex--;
-      this._updateStepVisibility();
-    }
-  }
-
-  private _extractFormData(): FormData {
-    const formData = new FormData();
-
-    // Query all light-DOM children that have a 'name' attribute
-    const fields = this.querySelectorAll<
-      HTMLElement & {name: string; value: any; checked?: boolean; files?: FileList}
-    >("[name]");
-
-    fields.forEach((field) => {
-      // Standard HTML form behavior: ignore disabled fields
-      if (field.hasAttribute("disabled")) return;
-
-      const isToggle =
-        field.tagName === "ST-RADIO" ||
-        field.tagName === "ST-CHECKBOX" ||
-        field.getAttribute("type") === "radio" ||
-        field.getAttribute("type") === "checkbox";
-
-      if (isToggle) {
-        // Only append radios/checkboxes if they are actively checked
-        if (field.checked) {
-          formData.append(field.name, field.value || "on");
-        }
-      } else if (
-        field.tagName === "INPUT" &&
-        field.getAttribute("type") === "file" &&
-        field.files
-      ) {
-        // Handle native file uploads
-        Array.from(field.files).forEach((file) => formData.append(field.name, file));
-      } else if (field.value !== undefined) {
-        // Handle st-input, st-select, st-textarea, and standard inputs
-        formData.append(field.name, field.value);
-      }
-    });
-
-    return formData;
-  }
-
-  private _handleSubmit(e: Event) {
-    e.preventDefault();
-    e.stopPropagation();
-
-    if (!this._validateCurrentContext()) return;
-
-    const hasSteps = this._stepElements.length > 0;
-    const isLastStep = hasSteps ? this._currentStepIndex === this._stepElements.length - 1 : true;
-
-    if (hasSteps && !isLastStep) {
-      this._currentStepIndex++;
-      this._updateStepVisibility();
-      return;
-    }
-
-    // Use our custom extractor to pierce the Shadow DOM boundary
-    const formData = this._extractFormData();
-
-    this.dispatchEvent(
-      new CustomEvent("submit", {
-        bubbles: true,
-        composed: true,
-        cancelable: true,
-        detail: {formData},
-      }),
-    );
-  }
-
-  render() {
-    const hasSteps = this._stepElements?.length > 0;
-    const isLastStep = hasSteps ? this._currentStepIndex === this._stepElements.length - 1 : true;
-
-    return html`
-      <div class="${hasSteps ? "has-steps" : ""}" aria-busy=${this.loading}>
-        ${this.loading
-          ? html`
-              <div class="loading-overlay">
-                <st-icon name="cloud-download" color="primary"></st-icon> Processing...
-              </div>
-            `
-          : ""}
-        ${hasSteps
-          ? html`
-              <div class="progress-nav" role="tablist">
-                ${this._stepElements.map((step, index) => {
-                  const isActive = index === this._currentStepIndex;
-                  const isCompleted = index < this._currentStepIndex;
-
-                  return html`
-                    <div
-                      class="step-indicator ${isActive ? "active" : ""} ${isCompleted
-                        ? "completed"
-                        : ""}"
-                      role="tab"
-                      aria-selected=${isActive}
-                    >
-                      <div class="step-circle">
-                        ${isCompleted
-                          ? html`<st-icon name="check-circle" size="sm"></st-icon>`
-                          : html`${index + 1}`}
-                      </div>
-                      <span>${step.title || `Step ${index + 1}`}</span>
-                    </div>
-                    ${index < this._stepElements.length - 1
-                      ? html` <div class="step-connector ${isCompleted ? "completed" : ""}"></div> `
-                      : ""}
-                  `;
-                })}
-              </div>
-            `
-          : ""}
-        ${this.error
-          ? html`
-              <st-alert color="error" style="margin-bottom: var(--st-spacing-lg);">
-                <st-icon slot="icon" name="alert-triangle"></st-icon>
-                ${this.error}
-              </st-alert>
-            `
-          : ""}
-
-        <form @submit=${this._handleSubmit}>
-          <slot @slotchange=${this._handleSlotChange}></slot>
-
-          <div class="form-actions">
-            ${hasSteps && this._currentStepIndex > 0
-              ? html`
-                  <st-button
-                    variant="secondary"
-                    type="button"
-                    @click=${this._prevStep}
-                    ?disabled=${this.loading}
-                  >
-                    Back
-                  </st-button>
-                `
-              : ""}
-
-            <!-- Type is "button", but click triggers requestSubmit() on the internal form -->
-            <st-button
-              color="primary"
-              type="button"
-              @click=${this._triggerSubmission}
-              ?disabled=${this.loading}
-            >
-              ${this.loading ? "Submitting..." : isLastStep ? "Submit" : "Continue"}
-            </st-button>
-          </div>
-        </form>
-      </div>
-    `;
-  }
-}
-
-declare global {
-  interface HTMLElementTagNameMap {
-    "st-form": StForm;
-  }
-}
+import {LitElement, html, css} from "lit";
+import {customElement, property, state, queryAssignedElements, query} from "lit/decorators.js";
+import {resetStyles} from "../../styles/reset.js";
+import type {StFormStep} from "./form-step.js";
+
+export type FormLayout = "vertical" | "horizontal" | "inline";
+
+@customElement("st-form")
+export class StForm extends LitElement {
+  @property({type: String, reflect: true}) layout: FormLayout = "vertical";
+  @property({type: Boolean, reflect: true}) loading = false;
+  @property({type: String}) error = "";
+
+  @state() private _currentStepIndex = 0;
+
+  @queryAssignedElements({selector: "st-form-step"})
+  private _stepElements!: StFormStep[];
+
+  @query("form") private _formEl!: HTMLFormElement;
+
+  static styles = [
+    resetStyles,
+    css`
+      :host {
+        display: block;
+        position: relative;
+      }
+
+      form {
+        display: flex;
+        gap: var(--st-spacing-md);
+      }
+
+      /* ==========================================================
+         Layouts
+         ========================================================== */
+      :host([layout="vertical"]) form {
+        flex-direction: column;
+      }
+
+      :host([layout="horizontal"]) form {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+        align-items: start;
+      }
+
+      :host([layout="inline"]) form {
+        flex-direction: row;
+        align-items: flex-end;
+        flex-wrap: wrap;
+      }
+
+      .has-steps form {
+        display: flex;
+        flex-direction: column;
+      }
+
+      /* ==========================================================
+         Progress Navigation
+         ========================================================== */
+      .progress-nav {
+        display: flex;
+        align-items: center;
+        margin-bottom: var(--st-spacing-xl);
+        padding-bottom: var(--st-spacing-md);
+        overflow-x: auto;
+        scrollbar-width: none;
+      }
+
+      .step-indicator {
+        display: flex;
+        align-items: center;
+        gap: var(--st-spacing-sm);
+        color: var(--st-color-text-muted);
+        font-size: var(--st-font-size-sm);
+        font-weight: var(--st-font-weight-medium);
+        transition: color 0.2s ease;
+      }
+
+      .step-indicator.active {
+        color: var(--st-color-text);
+      }
+      .step-indicator.completed {
+        color: var(--st-color-success);
+      }
+
+      .step-circle {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        width: 1.75rem;
+        height: 1.75rem;
+        border-radius: 50%;
+        border: 2px solid currentColor;
+        font-size: 0.875rem;
+        background-color: var(--st-color-bg);
+        transition: all 0.2s ease;
+      }
+
+      .step-indicator.active .step-circle {
+        background-color: var(--st-color-primary);
+        border-color: var(--st-color-primary);
+        color: var(--st-color-bg);
+      }
+
+      .step-indicator.completed .step-circle {
+        border-color: var(--st-color-success);
+        background-color: var(--st-color-success-bg, transparent);
+      }
+
+      .step-connector {
+        flex: 1;
+        height: 2px;
+        min-width: 24px;
+        margin: 0 var(--st-spacing-sm);
+        background-color: var(--st-color-border);
+        transition: background-color 0.2s ease;
+      }
+
+      .step-connector.completed {
+        background-color: var(--st-color-success);
+      }
+
+      /* ==========================================================
+         Actions & States
+         ========================================================== */
+      .form-actions {
+        display: flex;
+        gap: var(--st-spacing-md);
+        margin-top: var(--st-spacing-lg);
+        justify-content: flex-end;
+      }
+
+      .loading-overlay {
+        position: absolute;
+        inset: 0;
+        background: rgba(var(--st-color-bg-rgb, 255, 255, 255), 0.7);
+        backdrop-filter: blur(2px);
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        z-index: 10;
+        border-radius: inherit;
+        color: var(--st-color-text);
+        font-weight: var(--st-font-weight-medium);
+        gap: var(--st-spacing-sm);
+      }
+
+      @keyframes pulse {
+        0%,
+        100% {
+          opacity: 1;
+        }
+        50% {
+          opacity: 0.5;
+        }
+      }
+
+      .loading-overlay st-icon {
+        animation: pulse 1.5s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+      }
+    `,
+  ];
+
+  private _handleSlotChange() {
+    if (this._stepElements.length > 0) {
+      this._updateStepVisibility();
+    }
+  }
+
+  private _updateStepVisibility() {
+    this._stepElements.forEach((step, index) => {
+      step.active = index === this._currentStepIndex;
+    });
+    this.requestUpdate();
+  }
+
+  private _validateCurrentContext(): boolean {
+    if (this._stepElements.length === 0) {
+      return this._formEl.checkValidity();
+    }
+
+    const currentStep = this._stepElements[this._currentStepIndex];
+    let isValid = true;
+
+    // Find all custom and native form inputs assigned to the current step
+    const inputs = Array.from(
+      currentStep.querySelectorAll<
+        HTMLElement & {checkValidity?: () => boolean; reportValidity?: () => void}
+      >("*"),
+    );
+
+    for (const input of inputs) {
+      if (typeof input.checkValidity === "function") {
+        if (!input.checkValidity()) {
+          // Focus and report on the first invalid element encountered
+          if (isValid && typeof input.reportValidity === "function") {
+            input.reportValidity();
+          }
+          isValid = false;
+        }
+      }
+    }
+
+    return isValid;
+  }
+
+  private _triggerSubmission() {
+    // HTML5 method that triggers form validation and fires the native submit event
+    this._formEl.requestSubmit();
+  }
+
+  private _prevStep() {
+    if (this._currentStepIndex > 0) {
+      this._currentStepIndex--;
+      this._updateStepVisibility();
+    }
+  }
+
+  private _extractFormData(): FormData {
+    const formData = new FormData();
+
+    // Query all light-DOM children that have a 'name' attribute
+    const fields = this.querySelectorAll<
+      HTMLElement & {name: string; value: any; checked?: boolean; files?: FileList}
+    >("[name]");
+
+    fields.forEach((field) => {
+      // Standard HTML form behavior: ignore disabled fields
+      if (field.hasAttribute("disabled")) return;
+
+      const isToggle =
+        field.tagName === "ST-RADIO" ||
+        field.tagName === "ST-CHECKBOX" ||
+        field.getAttribute("type") === "radio" ||
+        field.getAttribute("type") === "checkbox";
+
+      if (isToggle) {
+        // Only append radios/checkboxes if they are actively checked
+        if (field.checked) {
+          formData.append(field.name, field.value || "on");
+        }
+      } else if (
+        field.tagName === "INPUT" &&
+        field.getAttribute("type") === "file" &&
+        field.files
+      ) {
+        // Handle native file uploads
+        Array.from(field.files).forEach((file) => formData.append(field.name, file));
+      } else if (field.value !== undefined) {
+        // Handle st-input, st-select, st-textarea, and standard inputs
+        formData.append(field.name, field.value);
+      }
+    });
+
+    return formData;
+  }
+
+  private _handleSubmit(e: Event) {
+    e.preventDefault();
+    e.stopPropagation();
+
+    if (!this._validateCurrentContext()) return;
+
+    const hasSteps = this._stepElements.length > 0;
+    const isLastStep = hasSteps ? this._currentStepIndex === this._stepElements.length - 1 : true;
+
+    if (hasSteps && !isLastStep) {
+      this._currentStepIndex++;
+      this._updateStepVisibility();
+      return;
+    }
+
+    // Use our custom extractor to pierce the Shadow DOM boundary
+    const formData = this._extractFormData();
+
+    this.dispatchEvent(
+      new CustomEvent("submit", {
+        bubbles: true,
+        composed: true,
+        cancelable: true,
+        detail: {formData},
+      }),
+    );
+  }
+
+  render() {
+    const hasSteps = this._stepElements?.length > 0;
+    const isLastStep = hasSteps ? this._currentStepIndex === this._stepElements.length - 1 : true;
+
+    return html`
+      <div class="${hasSteps ? "has-steps" : ""}" aria-busy=${this.loading}>
+        ${this.loading
+          ? html`
+              <div class="loading-overlay">
+                <st-icon name="cloud-download" color="primary"></st-icon> Processing...
+              </div>
+            `
+          : ""}
+        ${hasSteps
+          ? html`
+              <div class="progress-nav" role="tablist">
+                ${this._stepElements.map((step, index) => {
+                  const isActive = index === this._currentStepIndex;
+                  const isCompleted = index < this._currentStepIndex;
+
+                  return html`
+                    <div
+                      class="step-indicator ${isActive ? "active" : ""} ${isCompleted
+                        ? "completed"
+                        : ""}"
+                      role="tab"
+                      aria-selected=${isActive}
+                    >
+                      <div class="step-circle">
+                        ${isCompleted
+                          ? html`<st-icon name="check-circle" size="sm"></st-icon>`
+                          : html`${index + 1}`}
+                      </div>
+                      <span>${step.title || `Step ${index + 1}`}</span>
+                    </div>
+                    ${index < this._stepElements.length - 1
+                      ? html` <div class="step-connector ${isCompleted ? "completed" : ""}"></div> `
+                      : ""}
+                  `;
+                })}
+              </div>
+            `
+          : ""}
+        ${this.error
+          ? html`
+              <st-alert color="error" style="margin-bottom: var(--st-spacing-lg);">
+                <st-icon slot="icon" name="alert-triangle"></st-icon>
+                ${this.error}
+              </st-alert>
+            `
+          : ""}
+
+        <form @submit=${this._handleSubmit}>
+          <slot @slotchange=${this._handleSlotChange}></slot>
+
+          <div class="form-actions">
+            ${hasSteps && this._currentStepIndex > 0
+              ? html`
+                  <st-button
+                    variant="secondary"
+                    type="button"
+                    @click=${this._prevStep}
+                    ?disabled=${this.loading}
+                  >
+                    Back
+                  </st-button>
+                `
+              : ""}
+
+            <!-- Type is "button", but click triggers requestSubmit() on the internal form -->
+            <st-button
+              color="primary"
+              type="button"
+              @click=${this._triggerSubmission}
+              ?disabled=${this.loading}
+            >
+              ${this.loading ? "Submitting..." : isLastStep ? "Submit" : "Continue"}
+            </st-button>
+          </div>
+        </form>
+      </div>
+    `;
+  }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    "st-form": StForm;
+  }
+}