npm - stimeo-ui - Versions diffs - 0.8.0 → 0.10.0 - Mend

stimeo-ui 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (167) hide show

package/dist/controllers/editable_controller.js CHANGED Viewed

@@ -55,33 +55,64 @@ var EditableController = class extends Controller {
   static values = {
     submitOnBlur: { type: Boolean, default: true }
   };
-  static actions = ["edit", "onBlur", "onDisplayKeydown", "onKeydown"];
+  static actions = ["cancel", "edit", "onDisplayKeydown", "onKeydown", "revert", "save"];
   static events = ["cancel", "change"];
   /** The value captured when edit mode began, used to detect real changes. */
   #previousValue = "";
+  /**
+   * The value the last save replaced, or `null` when there is nothing to undo.
+   * Cleared on connect: a value from before a page restore is unrecoverable, so
+   * `revert()` must not resurrect one.
+   */
+  #revertValue = null;
   /**
    * Owns IME lifecycle state for the edit surface, so a keydown that belongs to
    * a composition (cancel or confirm) is never treated as an edit command.
    */
   #composition = new CompositionTracker();
+  /**
+   * Watches focus leaving the editor from wherever it currently sits.
+   *
+   * `focusout` bubbles where `blur` does not, so one listener on the root sees
+   * every departure — including one from a Save or Cancel button the consumer
+   * placed beside the input. Binding the input alone would make the promise
+   * "saves wherever focus moved" true only for focus that leaves the input
+   * itself, and tabbing straight past an inner button would strand the editor
+   * open.
+   */
+  #onFocusOut = (event) => {
+    const from = event.target;
+    if (this.hasDisplayTarget && from instanceof Node && this.displayTarget.contains(from)) return;
+    const next = event.relatedTarget;
+    if (next instanceof Node && this.element.contains(next)) return;
+    if (this.submitOnBlurValue) this.#commit(false);
+  };
   /** Establishes the initial display mode (display shown, input hidden). */
   connect() {
     if (this.hasInputTarget) this.#composition.observe(this.inputTarget);
+    this.element.addEventListener("focusout", this.#onFocusOut);
+    this.#revertValue = null;
     this.#setMode("display");
   }
-  /** Releases the composition listeners so nothing outlives the element. */
+  /** Releases the composition and focus listeners so nothing outlives the element. */
   disconnect() {
     this.#composition.disconnect();
+    this.element.removeEventListener("focusout", this.#onFocusOut);
   }
   /** Tracks an input added initially or after connect (e.g. a Turbo swap). */
   inputTargetConnected(input) {
     this.#composition.observe(input);
+    this.#applyMode();
   }
   /** Removes composition listeners when the active input is replaced or removed. */
   inputTargetDisconnected(input) {
     this.#composition.unobserve(input);
   }
-  /** Enters edit mode: seeds the input from the display text, focuses, selects. */
+  /** Re-hides or re-shows a display element that arrived after the mode was set. */
+  displayTargetConnected() {
+    this.#applyMode();
+  }
+  /** Enters edit mode: seeds the input from the declared value, focuses, selects. */
   edit() {
     if (this.#isEditing || !this.hasInputTarget || !this.hasDisplayTarget) return;
     this.#previousValue = this.#currentValue;
@@ -90,6 +121,27 @@ var EditableController = class extends Controller {
     this.inputTarget.focus();
     this.inputTarget.select();
   }
+  /** Commits the edit and returns focus to the display element. */
+  save() {
+    this.#commit(true);
+  }
+  /** Discards edits, returns to display mode, and dispatches `cancel`. */
+  cancel() {
+    if (!this.#isEditing) return;
+    this.#setMode("display");
+    if (this.hasDisplayTarget) this.displayTarget.focus();
+    this.dispatch("cancel", { detail: {} });
+  }
+  /**
+   * Puts back the value the last save replaced — for a consumer whose server
+   * rejected it. Silent by design: a `change` here would re-enter the same
+   * handler that asked for the undo. One save, one undo.
+   */
+  revert() {
+    if (this.#revertValue === null || this.#isEditing) return;
+    this.#writeValue(this.#revertValue);
+    this.#revertValue = null;
+  }
   /** Adds `F2` as an editing entry point alongside the button's native activation. */
   onDisplayKeydown(event) {
     if (event.key === "F2") {
@@ -103,56 +155,57 @@ var EditableController = class extends Controller {
     if (event.key === "Escape") {
       if (event.defaultPrevented) return;
       event.preventDefault();
-      this.#cancel();
+      this.cancel();
       return;
     }
     if (event.key === "Enter") {
       if (event.defaultPrevented) return;
       if (this.#isMultiline && !(event.ctrlKey || event.metaKey)) return;
       event.preventDefault();
-      this.#save(true);
+      this.#commit(true);
     }
   }
-  /** Saves on blur when `submitOnBlur` is set; otherwise keeps editing. */
-  onBlur() {
-    if (!this.#isEditing) return;
-    if (this.submitOnBlurValue) this.#save(false);
-  }
   /**
-   * Returns to display mode, reflecting the input into the display text and
-   * dispatching `change` when the value differs from where editing began.
+   * Returns to display mode, storing the input's value and dispatching `change`
+   * when it differs from where editing began.
    *
    * @param restoreFocus - Move focus back to the display element (explicit
-   *   keyboard commit) rather than honoring the user's new focus target (blur).
+   *   commit) rather than honoring the user's new focus target (blur).
    */
-  #save(restoreFocus) {
-    if (!this.#isEditing) return;
-    const value = this.inputTarget.value;
+  #commit(restoreFocus) {
+    if (!this.#isEditing || !this.hasInputTarget) return;
+    const value = this.inputTarget.value.trim();
     const previous = this.#previousValue;
-    this.displayTarget.textContent = value;
+    this.#writeValue(value);
     this.#setMode("display");
-    if (restoreFocus) this.displayTarget.focus();
+    if (restoreFocus && this.hasDisplayTarget) this.displayTarget.focus();
     if (value !== previous) {
+      this.#revertValue = previous;
       this.dispatch("change", { detail: { value, previous } });
     }
   }
-  /** Discards edits, returns to display mode, and dispatches `cancel`. */
-  #cancel() {
-    if (!this.#isEditing) return;
-    this.#setMode("display");
-    this.displayTarget.focus();
-    this.dispatch("cancel", { detail: {} });
+  /** Stores `value` wherever the display element declares it. */
+  #writeValue(value) {
+    if (!this.hasDisplayTarget) return;
+    const display = this.displayTarget;
+    if (display.hasAttribute("data-value")) display.dataset.value = value;
+    else display.textContent = value;
   }
-  /** Toggles the `data-mode` flag and the `hidden` state of both elements. */
-  #setMode(mode) {
-    this.element.dataset.mode = mode;
-    const editing = mode === "editing";
+  /** Derives both elements' visibility from the mode currently in the DOM. */
+  #applyMode() {
+    const editing = this.#isEditing;
     if (this.hasDisplayTarget) this.displayTarget.hidden = editing;
     if (this.hasInputTarget) this.inputTarget.hidden = !editing;
   }
-  /** Current display text, trimmed — the value shown when not editing. */
+  /** Records the mode, then brings both elements in line with it. */
+  #setMode(mode) {
+    this.element.dataset.mode = mode;
+    this.#applyMode();
+  }
+  /** The value the display element declares, trimmed. */
   get #currentValue() {
-    return (this.displayTarget.textContent ?? "").trim();
+    const display = this.displayTarget;
+    return (display.dataset.value ?? display.textContent ?? "").trim();
   }
   /** Whether the editing control is a multi-line `<textarea>`. */
   get #isMultiline() {

package/dist/controllers/editable_controller.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/utils/composition_tracker.ts","../../src/controllers/editable_controller.ts"],"names":[],"mappings":"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","file":"editable_controller.js","sourcesContent":["/** Minimal event shape carrying the platform's per-event composition signal. /\nexport interface CompositionSignal {\n readonly isComposing?: boolean;\n}\n\n/* Hooks that keep component-specific work outside {@link CompositionTracker}. /\nexport interface CompositionTrackerOptions {\n /* Runs after lifecycle state is set for a `compositionstart` event. /\n readonly onStart?: (event: Event) => void;\n /* Runs after lifecycle state is cleared for a `compositionend` event. /\n readonly onEnd?: (event: Event) => void;\n}\n\n/\n Owns IME composition listeners and transient state for one or more event targets.\n \n Some browsers omit `KeyboardEvent.isComposing` on the keydown that confirms a\n * conversion. Tracking `compositionstart` through `compositionend` supplies the\n * missing lifecycle signal without relying on deprecated numeric key codes.\n * Component policy stays with the consumer: filtering, validation, and submission\n * belong in the optional {@link CompositionTrackerOptions.onEnd} callback.\n \n @example\n * ```ts\n * #composition = new CompositionTracker({ onEnd: () => this.filter() });\n \n connect(): void {\n * this.#composition.observe(this.inputTarget);\n * }\n \n disconnect(): void {\n * this.#composition.disconnect();\n * }\n \n onKeydown(event: KeyboardEvent): void {\n * if (this.#composition.isComposing(event)) return;\n * }\n * ```\n /\nexport class CompositionTracker {\n readonly #observedTargets = new Set<EventTarget>();\n readonly #activeTargets = new Set<EventTarget>();\n readonly #onStart: ((event: Event) => void) \| undefined;\n readonly #onEnd: ((event: Event) => void) \| undefined;\n\n constructor(options: CompositionTrackerOptions = {}) {\n this.#onStart = options.onStart;\n this.#onEnd = options.onEnd;\n }\n\n /* Starts lifecycle tracking for `target`; repeated calls are idempotent. /\n observe(target: EventTarget): void {\n if (this.#observedTargets.has(target)) return;\n target.addEventListener(\"compositionstart\", this.#handleStart);\n target.addEventListener(\"compositionend\", this.#handleEnd);\n this.#observedTargets.add(target);\n }\n\n /* Stops tracking one target and clears any active composition it owned. /\n unobserve(target: EventTarget): void {\n if (!this.#observedTargets.delete(target)) return;\n target.removeEventListener(\"compositionstart\", this.#handleStart);\n target.removeEventListener(\"compositionend\", this.#handleEnd);\n this.#activeTargets.delete(target);\n }\n\n /* Releases every listener and clears state so reconnect starts cleanly. /\n disconnect(): void {\n for (const target of this.#observedTargets) {\n target.removeEventListener(\"compositionstart\", this.#handleStart);\n target.removeEventListener(\"compositionend\", this.#handleEnd);\n }\n this.#observedTargets.clear();\n this.#activeTargets.clear();\n }\n\n /* True when lifecycle tracking or the current event reports composition. /\n isComposing(event?: CompositionSignal): boolean {\n return this.#activeTargets.size > 0 \|\| event?.isComposing === true;\n }\n\n readonly #handleStart = (event: Event): void => {\n if (event.currentTarget) this.#activeTargets.add(event.currentTarget);\n this.#onStart?.(event);\n };\n\n readonly #handleEnd = (event: Event): void => {\n if (event.currentTarget) this.#activeTargets.delete(event.currentTarget);\n this.#onEnd?.(event);\n };\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { CompositionTracker } from \"../utils/composition_tracker\";\n\n/\n Headless, accessible inline-editing behavior.\n \n Markup contract (identifier: `stimeo--editable`):\n * <div data-controller=\"stimeo--editable\"\n * data-stimeo--editable-submit-on-blur-value=\"true\">\n * <button type=\"button\" aria-label=\"Edit title\"\n * data-stimeo--editable-target=\"display\"\n * data-action=\"click->stimeo--editable#edit\n * keydown->stimeo--editable#onDisplayKeydown\">Current title</button>\n * <input type=\"text\" aria-label=\"Title\" hidden\n * data-stimeo--editable-target=\"input\"\n * data-action=\"keydown->stimeo--editable#onKeydown\n * blur->stimeo--editable#onBlur\" />\n * </div>\n \n There is no dedicated APG pattern; this implements a display ⇄ edit toggle with\n * focus management and keyboard commit/cancel, leaning on native form-control\n * labeling (WCAG 1.3.1 / 4.1.2). The look is the consumer's CSS, keyed off\n * `data-mode`.\n \n Behavior provided:\n * - Activating the display element (`Enter`/`Space` via the `<button>`, or `F2`)\n * enters edit mode, focuses the input, and selects its text.\n * - `Enter` (single-line) or `Ctrl+Enter` / `Cmd+Enter` (multiline `<textarea>`)\n * saves; `Escape` cancels. Both return focus to the display element. Keys\n * pressed during an IME composition act on the composition, never the edit:\n * a conversion-cancelling `Escape` keeps editing and a conversion-confirming\n * `Enter` never saves (lifecycle-tracked, covering events that omit\n * `isComposing`).\n * - Losing focus while editing saves when `submitOnBlur` is true (the default),\n * honoring wherever focus moved; when false, editing is kept.\n * - Saving dispatches `stimeo--editable:change` with `{ value, previous }` only\n * when the value actually changed; cancelling dispatches\n * `stimeo--editable:cancel`.\n /\nexport class EditableController extends Controller<HTMLElement> {\n static override targets = [\"display\", \"input\"];\n static override values = {\n submitOnBlur: { type: Boolean, default: true },\n };\n static actions = [\"edit\", \"onBlur\", \"onDisplayKeydown\", \"onKeydown\"] as const;\n static events = [\"cancel\", \"change\"] as const;\n\n declare readonly displayTarget: HTMLElement;\n declare readonly inputTarget: HTMLInputElement \| HTMLTextAreaElement;\n declare readonly hasDisplayTarget: boolean;\n declare readonly hasInputTarget: boolean;\n\n declare submitOnBlurValue: boolean;\n\n /* The value captured when edit mode began, used to detect real changes. /\n #previousValue = \"\";\n\n /\n Owns IME lifecycle state for the edit surface, so a keydown that belongs to\n * a composition (cancel or confirm) is never treated as an edit command.\n /\n readonly #composition = new CompositionTracker();\n\n /* Establishes the initial display mode (display shown, input hidden). /\n override connect(): void {\n if (this.hasInputTarget) this.#composition.observe(this.inputTarget);\n this.#setMode(\"display\");\n }\n\n /* Releases the composition listeners so nothing outlives the element. /\n override disconnect(): void {\n this.#composition.disconnect();\n }\n\n /* Tracks an input added initially or after connect (e.g. a Turbo swap). /\n inputTargetConnected(input: HTMLElement): void {\n this.#composition.observe(input);\n }\n\n /* Removes composition listeners when the active input is replaced or removed. /\n inputTargetDisconnected(input: HTMLElement): void {\n this.#composition.unobserve(input);\n }\n\n /* Enters edit mode: seeds the input from the display text, focuses, selects. /\n edit(): void {\n if (this.#isEditing \|\| !this.hasInputTarget \|\| !this.hasDisplayTarget) return;\n this.#previousValue = this.#currentValue;\n this.inputTarget.value = this.#previousValue;\n this.#setMode(\"editing\");\n this.inputTarget.focus();\n this.inputTarget.select();\n }\n\n /* Adds `F2` as an editing entry point alongside the button's native activation. /\n onDisplayKeydown(event: KeyboardEvent): void {\n if (event.key === \"F2\") {\n event.preventDefault();\n this.edit();\n }\n }\n\n /* Commits on `Enter` (or `Ctrl+Enter` when multiline) and cancels on `Escape`. /\n onKeydown(event: KeyboardEvent): void {\n // Keys fired during IME composition steer the composition (cancel a\n // conversion, confirm a candidate) and must never cancel or save the edit.\n if (this.#composition.isComposing(event)) return;\n if (event.key === \"Escape\") {\n // Leave a press an inner handler already owned.\n if (event.defaultPrevented) return;\n event.preventDefault();\n this.#cancel();\n return;\n }\n if (event.key === \"Enter\") {\n // A descendant widget that already claimed the key (a completion popup\n // confirming its candidate) must not ALSO commit the edit — composition\n // depends on this yield. Kept separate from the Escape guard above, which\n // answers a different question: who owns an Escape press.\n if (event.defaultPrevented) return;\n // A bare Enter inserts a newline in a textarea; only Ctrl+Enter (or Cmd+Enter on\n // macOS, the platform-conventional commit chord) saves there.\n if (this.#isMultiline && !(event.ctrlKey \|\| event.metaKey)) return;\n event.preventDefault();\n this.#save(true);\n }\n }\n\n /* Saves on blur when `submitOnBlur` is set; otherwise keeps editing. /\n onBlur(): void {\n if (!this.#isEditing) return;\n if (this.submitOnBlurValue) this.#save(false);\n }\n\n /\n Returns to display mode, reflecting the input into the display text and\n * dispatching `change` when the value differs from where editing began.\n \n @param restoreFocus - Move focus back to the display element (explicit\n * keyboard commit) rather than honoring the user's new focus target (blur).\n /\n #save(restoreFocus: boolean): void {\n if (!this.#isEditing) return;\n const value = this.inputTarget.value;\n const previous = this.#previousValue;\n this.displayTarget.textContent = value;\n this.#setMode(\"display\");\n if (restoreFocus) this.displayTarget.focus();\n if (value !== previous) {\n this.dispatch(\"change\", { detail: { value, previous } });\n }\n }\n\n /* Discards edits, returns to display mode, and dispatches `cancel`. /\n #cancel(): void {\n if (!this.#isEditing) return;\n this.#setMode(\"display\");\n this.displayTarget.focus();\n this.dispatch(\"cancel\", { detail: {} });\n }\n\n /* Toggles the `data-mode` flag and the `hidden` state of both elements. /\n #setMode(mode: \"display\" \| \"editing\"): void {\n this.element.dataset.mode = mode;\n const editing = mode === \"editing\";\n if (this.hasDisplayTarget) this.displayTarget.hidden = editing;\n if (this.hasInputTarget) this.inputTarget.hidden = !editing;\n }\n\n /* Current display text, trimmed — the value shown when not editing. /\n get #currentValue(): string {\n return (this.displayTarget.textContent ?? \"\").trim();\n }\n\n /* Whether the editing control is a multi-line `<textarea>`. /\n get #isMultiline(): boolean {\n return this.inputTarget.tagName === \"TEXTAREA\";\n }\n\n /* Whether the controller is currently in edit mode. */\n get #isEditing(): boolean {\n return this.element.dataset.mode === \"editing\";\n }\n}\n"]}
1	+ {"version":3,"sources":["../../src/utils/composition_tracker.ts","../../src/controllers/editable_controller.ts"],"names":[],"mappings":"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","file":"editable_controller.js","sourcesContent":["/** Minimal event shape carrying the platform's per-event composition signal. /\nexport interface CompositionSignal {\n readonly isComposing?: boolean;\n}\n\n/* Hooks that keep component-specific work outside {@link CompositionTracker}. /\nexport interface CompositionTrackerOptions {\n /* Runs after lifecycle state is set for a `compositionstart` event. /\n readonly onStart?: (event: Event) => void;\n /* Runs after lifecycle state is cleared for a `compositionend` event. /\n readonly onEnd?: (event: Event) => void;\n}\n\n/\n Owns IME composition listeners and transient state for one or more event targets.\n \n Some browsers omit `KeyboardEvent.isComposing` on the keydown that confirms a\n * conversion. Tracking `compositionstart` through `compositionend` supplies the\n * missing lifecycle signal without relying on deprecated numeric key codes.\n * Component policy stays with the consumer: filtering, validation, and submission\n * belong in the optional {@link CompositionTrackerOptions.onEnd} callback.\n \n @example\n * ```ts\n * #composition = new CompositionTracker({ onEnd: () => this.filter() });\n \n connect(): void {\n * this.#composition.observe(this.inputTarget);\n * }\n \n disconnect(): void {\n * this.#composition.disconnect();\n * }\n \n onKeydown(event: KeyboardEvent): void {\n * if (this.#composition.isComposing(event)) return;\n * }\n * ```\n /\nexport class CompositionTracker {\n readonly #observedTargets = new Set<EventTarget>();\n readonly #activeTargets = new Set<EventTarget>();\n readonly #onStart: ((event: Event) => void) \| undefined;\n readonly #onEnd: ((event: Event) => void) \| undefined;\n\n constructor(options: CompositionTrackerOptions = {}) {\n this.#onStart = options.onStart;\n this.#onEnd = options.onEnd;\n }\n\n /* Starts lifecycle tracking for `target`; repeated calls are idempotent. /\n observe(target: EventTarget): void {\n if (this.#observedTargets.has(target)) return;\n target.addEventListener(\"compositionstart\", this.#handleStart);\n target.addEventListener(\"compositionend\", this.#handleEnd);\n this.#observedTargets.add(target);\n }\n\n /* Stops tracking one target and clears any active composition it owned. /\n unobserve(target: EventTarget): void {\n if (!this.#observedTargets.delete(target)) return;\n target.removeEventListener(\"compositionstart\", this.#handleStart);\n target.removeEventListener(\"compositionend\", this.#handleEnd);\n this.#activeTargets.delete(target);\n }\n\n /* Releases every listener and clears state so reconnect starts cleanly. /\n disconnect(): void {\n for (const target of this.#observedTargets) {\n target.removeEventListener(\"compositionstart\", this.#handleStart);\n target.removeEventListener(\"compositionend\", this.#handleEnd);\n }\n this.#observedTargets.clear();\n this.#activeTargets.clear();\n }\n\n /* True when lifecycle tracking or the current event reports composition. /\n isComposing(event?: CompositionSignal): boolean {\n return this.#activeTargets.size > 0 \|\| event?.isComposing === true;\n }\n\n readonly #handleStart = (event: Event): void => {\n if (event.currentTarget) this.#activeTargets.add(event.currentTarget);\n this.#onStart?.(event);\n };\n\n readonly #handleEnd = (event: Event): void => {\n if (event.currentTarget) this.#activeTargets.delete(event.currentTarget);\n this.#onEnd?.(event);\n };\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { CompositionTracker } from \"../utils/composition_tracker\";\n\n/\n Headless, accessible inline-editing behavior.\n \n Markup contract (identifier: `stimeo--editable`):\n * <div data-controller=\"stimeo--editable\"\n * data-stimeo--editable-submit-on-blur-value=\"true\">\n * <button type=\"button\" aria-label=\"Edit title\"\n * data-stimeo--editable-target=\"display\"\n * data-action=\"click->stimeo--editable#edit\n * keydown->stimeo--editable#onDisplayKeydown\">Current title</button>\n * <input type=\"text\" aria-label=\"Title\" hidden\n * data-stimeo--editable-target=\"input\"\n * data-action=\"keydown->stimeo--editable#onKeydown\" />\n * </div>\n \n There is no dedicated APG pattern; this implements a display ⇄ edit toggle with\n * focus management and keyboard commit/cancel, leaning on native form-control\n * labeling (WCAG 1.3.1 / 4.1.2). The look is the consumer's CSS, keyed off\n * `data-mode`.\n \n Behavior provided:\n * - Activating the display element (`Enter`/`Space` via the `<button>`, or `F2`)\n * enters edit mode, focuses the input, and selects its text.\n * - `Enter` (single-line) or `Ctrl+Enter` / `Cmd+Enter` (multiline `<textarea>`)\n * saves; `Escape` cancels. Both return focus to the display element. Keys\n * pressed during an IME composition act on the composition, never the edit:\n * a conversion-cancelling `Escape` keeps editing and a conversion-confirming\n * `Enter` never saves (lifecycle-tracked, covering events that omit\n * `isComposing`).\n * - Losing focus while editing saves when `submitOnBlur` is true (the default),\n * honoring wherever focus moved. The departure is watched on the controller\n * element, so it is seen from wherever focus sat — the input, or a Save or\n * Cancel button beside it — and no per-control wiring is required. Focus\n * landing on another element inside this controller has not left the edit, so\n * it commits nothing. When `submitOnBlur` is false, editing is kept.\n * - `save()`, `cancel()`, and `revert()` are actions, so a pointer-only user\n * reaches every path a keyboard user does. `revert()` restores the value from\n * before the last save once, for a consumer whose server rejected it.\n * - Saving dispatches `stimeo--editable:change` with `{ value, previous }` only\n * when the value actually changed; cancelling dispatches\n * `stimeo--editable:cancel` with an empty `{}` detail.\n \n The value is whatever the display element declares. A `data-value` attribute\n * holds it when the element's text is a rendering of the value rather than the\n * value itself — a formatted date, a grouped number, an icon beside a label.\n * Without that attribute the trimmed text is the value, and it must then be a\n * string the editing control accepts: `<input type=\"date\">` keeps `2026-08-23`\n * but sanitizes `August 23, 2026` away to an empty string. Saving updates\n * whichever of the two carries the value, so a rendered display keeps its markup\n * and the consumer re-renders it from the `change` event.\n /\nexport class EditableController extends Controller<HTMLElement> {\n static override targets = [\"display\", \"input\"];\n static override values = {\n submitOnBlur: { type: Boolean, default: true },\n };\n static actions = [\"cancel\", \"edit\", \"onDisplayKeydown\", \"onKeydown\", \"revert\", \"save\"] as const;\n static events = [\"cancel\", \"change\"] as const;\n\n declare readonly displayTarget: HTMLElement;\n declare readonly inputTarget: HTMLInputElement \| HTMLTextAreaElement;\n declare readonly hasDisplayTarget: boolean;\n declare readonly hasInputTarget: boolean;\n\n declare submitOnBlurValue: boolean;\n\n /* The value captured when edit mode began, used to detect real changes. /\n #previousValue = \"\";\n\n /\n The value the last save replaced, or `null` when there is nothing to undo.\n * Cleared on connect: a value from before a page restore is unrecoverable, so\n * `revert()` must not resurrect one.\n /\n #revertValue: string \| null = null;\n\n /\n Owns IME lifecycle state for the edit surface, so a keydown that belongs to\n * a composition (cancel or confirm) is never treated as an edit command.\n /\n readonly #composition = new CompositionTracker();\n\n /\n Watches focus leaving the editor from wherever it currently sits.\n \n `focusout` bubbles where `blur` does not, so one listener on the root sees\n * every departure — including one from a Save or Cancel button the consumer\n * placed beside the input. Binding the input alone would make the promise\n * \"saves wherever focus moved\" true only for focus that leaves the input\n * itself, and tabbing straight past an inner button would strand the editor\n * open.\n /\n readonly #onFocusOut = (event: FocusEvent): void => {\n // Entering edit mode hides the display element, and hiding the element that\n // holds focus reports a departure with nowhere to go. That hand-off is the\n // edit starting, not the user leaving it, and the input is focused moments\n // later in the same task. The display is hidden for the whole edit, so it\n // can never be the source of a real departure from one.\n const from = event.target;\n if (this.hasDisplayTarget && from instanceof Node && this.displayTarget.contains(from)) return;\n // Focus reaching another element inside this controller has not left the\n // edit. Without this the commit would beat an inner button's own click —\n // and a Cancel button would save what it promises to discard.\n const next = event.relatedTarget;\n if (next instanceof Node && this.element.contains(next)) return;\n if (this.submitOnBlurValue) this.#commit(false);\n };\n\n /* Establishes the initial display mode (display shown, input hidden). /\n override connect(): void {\n // The tracker is idempotent, so observing here and in the target callback\n // keeps IME tracking correct whichever of the two the framework runs first.\n if (this.hasInputTarget) this.#composition.observe(this.inputTarget);\n this.element.addEventListener(\"focusout\", this.#onFocusOut);\n this.#revertValue = null;\n this.#setMode(\"display\");\n }\n\n /* Releases the composition and focus listeners so nothing outlives the element. /\n override disconnect(): void {\n this.#composition.disconnect();\n this.element.removeEventListener(\"focusout\", this.#onFocusOut);\n }\n\n /* Tracks an input added initially or after connect (e.g. a Turbo swap). /\n inputTargetConnected(input: HTMLElement): void {\n this.#composition.observe(input);\n this.#applyMode();\n }\n\n /* Removes composition listeners when the active input is replaced or removed. /\n inputTargetDisconnected(input: HTMLElement): void {\n this.#composition.unobserve(input);\n }\n\n /* Re-hides or re-shows a display element that arrived after the mode was set. /\n displayTargetConnected(): void {\n this.#applyMode();\n }\n\n /* Enters edit mode: seeds the input from the declared value, focuses, selects. /\n edit(): void {\n if (this.#isEditing \|\| !this.hasInputTarget \|\| !this.hasDisplayTarget) return;\n this.#previousValue = this.#currentValue;\n this.inputTarget.value = this.#previousValue;\n this.#setMode(\"editing\");\n this.inputTarget.focus();\n this.inputTarget.select();\n }\n\n /* Commits the edit and returns focus to the display element. /\n save(): void {\n this.#commit(true);\n }\n\n /* Discards edits, returns to display mode, and dispatches `cancel`. /\n cancel(): void {\n if (!this.#isEditing) return;\n this.#setMode(\"display\");\n if (this.hasDisplayTarget) this.displayTarget.focus();\n this.dispatch(\"cancel\", { detail: {} });\n }\n\n /\n Puts back the value the last save replaced — for a consumer whose server\n * rejected it. Silent by design: a `change` here would re-enter the same\n * handler that asked for the undo. One save, one undo.\n /\n revert(): void {\n if (this.#revertValue === null \|\| this.#isEditing) return;\n this.#writeValue(this.#revertValue);\n this.#revertValue = null;\n }\n\n /* Adds `F2` as an editing entry point alongside the button's native activation. /\n onDisplayKeydown(event: KeyboardEvent): void {\n if (event.key === \"F2\") {\n event.preventDefault();\n this.edit();\n }\n }\n\n /* Commits on `Enter` (or `Ctrl+Enter` when multiline) and cancels on `Escape`. /\n onKeydown(event: KeyboardEvent): void {\n // Keys fired during IME composition steer the composition (cancel a\n // conversion, confirm a candidate) and must never cancel or save the edit.\n if (this.#composition.isComposing(event)) return;\n if (event.key === \"Escape\") {\n // Leave a press an inner handler already owned.\n if (event.defaultPrevented) return;\n event.preventDefault();\n this.cancel();\n return;\n }\n if (event.key === \"Enter\") {\n // A descendant widget that already claimed the key (a completion popup\n // confirming its candidate) must not ALSO commit the edit — composition\n // depends on this yield. Kept separate from the Escape guard above, which\n // answers a different question: who owns an Escape press.\n if (event.defaultPrevented) return;\n // A bare Enter inserts a newline in a textarea; only Ctrl+Enter (or Cmd+Enter on\n // macOS, the platform-conventional commit chord) saves there.\n if (this.#isMultiline && !(event.ctrlKey \|\| event.metaKey)) return;\n event.preventDefault();\n this.#commit(true);\n }\n }\n\n /\n Returns to display mode, storing the input's value and dispatching `change`\n * when it differs from where editing began.\n \n @param restoreFocus - Move focus back to the display element (explicit\n * commit) rather than honoring the user's new focus target (blur).\n /\n #commit(restoreFocus: boolean): void {\n if (!this.#isEditing \|\| !this.hasInputTarget) return;\n // One normalization for all three consumers below, so the stored value, the\n // comparison, and the detail can never disagree about what was saved.\n const value = this.inputTarget.value.trim();\n const previous = this.#previousValue;\n this.#writeValue(value);\n this.#setMode(\"display\");\n if (restoreFocus && this.hasDisplayTarget) this.displayTarget.focus();\n if (value !== previous) {\n this.#revertValue = previous;\n this.dispatch(\"change\", { detail: { value, previous } });\n }\n }\n\n /* Stores `value` wherever the display element declares it. /\n #writeValue(value: string): void {\n if (!this.hasDisplayTarget) return;\n const display = this.displayTarget;\n // Text that renders the value is the consumer's to compose; overwriting it\n // with the raw value would destroy a rendering this controller cannot rebuild.\n if (display.hasAttribute(\"data-value\")) display.dataset.value = value;\n else display.textContent = value;\n }\n\n /* Derives both elements' visibility from the mode currently in the DOM. /\n #applyMode(): void {\n const editing = this.#isEditing;\n if (this.hasDisplayTarget) this.displayTarget.hidden = editing;\n if (this.hasInputTarget) this.inputTarget.hidden = !editing;\n }\n\n /* Records the mode, then brings both elements in line with it. /\n #setMode(mode: \"display\" \| \"editing\"): void {\n this.element.dataset.mode = mode;\n this.#applyMode();\n }\n\n /* The value the display element declares, trimmed. /\n get #currentValue(): string {\n const display = this.displayTarget;\n return (display.dataset.value ?? display.textContent ?? \"\").trim();\n }\n\n /* Whether the editing control is a multi-line `<textarea>`. /\n get #isMultiline(): boolean {\n return this.inputTarget.tagName === \"TEXTAREA\";\n }\n\n /* Whether the controller is currently in edit mode. */\n get #isEditing(): boolean {\n return this.element.dataset.mode === \"editing\";\n }\n}\n"]}

package/dist/controllers/file_dropzone_controller.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/before_cache_reset.ts","../../src/utils/detach_gate.ts","../../src/utils/focus_candidate.ts","../../src/controllers/file_dropzone_controller.ts"],"names":[],"mappings":"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","file":"file_dropzone_controller.js","sourcesContent":["/*\n Sends one message to the page's shared `stimeo--announcer`.\n \n A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes after assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n \n The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n \n Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n \n @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n /\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n const text = message.trim();\n if (text.length === 0) return;\n window.dispatchEvent(\n new CustomEvent(\"stimeo--announcer:announce\", {\n detail: { message: text, assertive: options.assertive === true },\n }),\n );\n}\n\n/\n Fills `{name}` placeholders in an announcement template from `values`.\n \n The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n /\nexport function fillTemplate(template: string, values: Record<string, string \| number>): string {\n return template.replace(/\\{([a-zA-Z][a-zA-Z0-9])\\}/g, (match, name: string) => {\n const replacement = values[name];\n return replacement === undefined ? match : String(replacement);\n });\n}\n","/*\n Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n \n `disconnect()` cannot do this job, for two independent reasons. Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n \n Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. What to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way (the `MicrotaskCoalescer` split).\n \n Rewind state, not appearance. The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n \n Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n \n This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n \n @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n \n connect() { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n /\nexport class BeforeCacheReset {\n /* Every subscribed instance, iterated by the one shared document listener. /\n static readonly #subscribers = new Set<BeforeCacheReset>();\n\n /* The shared listener; installed while at least one instance is subscribed. /\n static readonly #onBeforeCache = (): void => {\n for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n };\n\n readonly #rewind: () => void;\n\n /* @param rewind - the pass that returns this controller's state to its initial form. /\n constructor(rewind: () => void) {\n this.#rewind = rewind;\n }\n\n /* Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. /\n activate(): void {\n const first = BeforeCacheReset.#subscribers.size === 0;\n BeforeCacheReset.#subscribers.add(this);\n if (first) {\n document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n }\n }\n\n /* Unsubscribes; call from `disconnect()`. Safe when never subscribed. /\n deactivate(): void {\n BeforeCacheReset.#subscribers.delete(this);\n if (BeforeCacheReset.#subscribers.size > 0) return;\n document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n }\n}\n","/\n Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n \n A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n \n - an in-page move — a consumer (sortable, a teleport) re-inserted the\n * element; Stimulus reconnects the SAME instance in the same mutation batch\n * and the controller's runtime state must survive;\n * - a detach that keeps the element — `data-controller` no longer lists the\n * identifier (a Turbo 8 morph), or the element moved outside the observed\n * root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n * ever come and the controller must tear down or it leaks its sessions,\n * document listeners, and moved nodes.\n \n Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n \n Policy stays with the consumer (the `SafeTimeout` / `FocusTrap` lineage —\n * this util owns the discrimination only):\n \n - Probe ({@link disconnected}) when the teardown must eventually happen —\n * live drag sessions, document listeners, teleported content. Call\n * {@link cancel} from `connect()` (a reconnect means in-page move) and from\n * the head of any direct teardown path (see below).\n * - Keep (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n * case would fight the controller's own effect: a controller that moves its\n * OWN element (portal's no-`content` form) exits a scoped observed root as\n * its normal job — a probe-driven teardown would restore the element into\n * the root, reconnect, re-teleport, and disconnect again, forever. Such\n * controllers keep their state on an ambiguous disconnect and tear down only\n * on {@link DetachGate.isDetached}.\n \n Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n /\n\n/* The slice of a Stimulus controller the gate inspects. /\nexport interface DetachGateHost {\n readonly element: Element;\n readonly identifier: string;\n}\n\n/\n Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n \n @example\n * ```ts\n * #gate = new DetachGate();\n \n connect(): void {\n * this.#gate.cancel(); // a reconnect: the element moved in-page\n * // …\n * }\n \n disconnect(): void {\n * this.#gate.disconnected(this, () => this.#teardown());\n * }\n \n #teardown(): void {\n * this.#gate.cancel(); // disarm a still-queued probe (double-run guard)\n * // …\n * }\n * ```\n /\nexport class DetachGate {\n /* Set while a probe is queued, waiting for a reconnect to cancel it. /\n #pending = false;\n\n /\n True while a probe is queued — the last disconnect was ambiguous and no\n * reconnect has cancelled it yet. Read it from `connect()` to tell the\n * reconnect half of an in-page move from a first connect: a controller whose\n * initialisation restarts a measurement (a min-duration floor, an elapsed\n * counter) must skip it for the move, where nothing actually restarted.\n /\n get pending(): boolean {\n return this.#pending;\n }\n\n /\n True when the disconnect is definitely a real detach — the element left\n * the document, or `data-controller` no longer lists the identifier. False\n * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n /\n static isDetached(host: DetachGateHost): boolean {\n if (!host.element.isConnected) return true;\n const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n return !tokens.includes(host.identifier);\n }\n\n /\n Call from `disconnect()`: runs `teardown` synchronously on a definite\n * detach (fast path), otherwise defers it one microtask — a reconnect\n * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n * One microtask is the whole probe window: Stimulus reconnects a moved\n * element within the same mutation batch, before the checkpoint drains.\n /\n disconnected(host: DetachGateHost, teardown: () => void): void {\n if (DetachGate.isDetached(host)) {\n // Also disarms a probe a previous ambiguous disconnect left queued\n // (defer, element removed, disconnect again) — exactly one teardown.\n this.#pending = false;\n teardown();\n return;\n }\n this.#pending = true;\n queueMicrotask(() => {\n if (!this.#pending) return;\n this.#pending = false;\n teardown();\n });\n }\n\n /\n Disarms a pending probe. Call from `connect()` (the reconnect that proves\n * an in-page move) and from the head of any teardown path not routed through\n * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n * never run the teardown a second time.\n /\n cancel(): void {\n this.#pending = false;\n }\n}\n","/\n Whether a disabled `<fieldset>` ancestor actually reaches `control`.\n \n HTML exempts the contents of a fieldset's first direct-child `<legend>`, and\n * the exemption is per fieldset — a control legal in one legend can still be\n * disabled by a second, outer fieldset, so the walk continues upward.\n \n Exported for the consumer that needs this rule without the rest of\n * {@link canTakeFocus}: `toolbar` bounds its own `hidden` walk at the toolbar\n * root, which is a different rule, so it composes the two itself.\n /\nexport function inheritsFieldsetDisabled(control: HTMLElement): boolean {\n let fieldset: Element \| null = control.closest(\"fieldset[disabled]\");\n while (fieldset) {\n const legend = Array.from(fieldset.children).find((child) => child.tagName === \"LEGEND\");\n if (!legend?.contains(control)) return true;\n fieldset = fieldset.parentElement?.closest(\"fieldset[disabled]\") ?? null;\n }\n return false;\n}\n\n/\n Whether an element can actually take focus, checked before `focus()` runs.\n \n A controller that must move focus off a control it is about to disable or hide\n * picks a destination and calls `focus()` on it. If that destination cannot take\n * focus, the call fails silently: `hidden` and natively `disabled` elements\n * swallow it, so the caret stays in the subtree that is disappearing and lands on\n * `<body>` a frame later — the exact outcome the rescue exists to prevent, minus\n * any signal that it happened.\n \n Testing after the fact is the obvious alternative and is deliberately not the\n * rule. Reading `document.activeElement` back only works in a real browser, and\n * looping over candidates that way performs a real focus move per failure —\n * observable to assistive technology. Checking first costs nothing and catches\n * the cases that actually occur.\n \n `aria-disabled` is not disqualifying. It is the attribute an author uses\n * for a control that must stay discoverable, and the roving contract keeps\n * such items reachable. Only the three conditions that make the platform refuse\n * focus are checked: `hidden` / `inert` (an ancestor's counts),\n * `input[type=\"hidden\"]`, the native `disabled` property, and `disabled`\n * inherited from an ancestor `fieldset`. CSS-only invisibility is handled by\n * {@link isRenderedForFocus} when a consumer needs sequential-focus semantics.\n \n Reading `:disabled` instead of walking the fieldset chain would be shorter, but\n * that pseudo-class is not evaluated consistently outside real browsers and this\n * has to be right headlessly too. happy-dom in particular focuses a `<button>`\n * inside a disabled fieldset where a real engine refuses, so the inheritance is\n * spelled out rather than delegated.\n \n What a consumer does when nothing survives is its own call: some fall back to\n * their landmark, while a widget whose caret already sits somewhere legitimate\n * refuses the move outright rather than relocating it.\n \n @example\n * ```ts\n * const target = candidates.find(canTakeFocus);\n * if (target) target.focus();\n * else {\n * this.#tabindex.lend(this.element); // nothing left: fall back to the landmark\n * this.element.focus();\n * }\n * ```\n \n @param element - the candidate destination\n /\nexport function canTakeFocus(element: HTMLElement): boolean {\n if (element.closest(\"[hidden], [inert]\")) return false;\n if (element instanceof HTMLInputElement && element.type === \"hidden\") return false;\n if (!(\"disabled\" in element)) return true;\n if ((element as HTMLElement & { disabled: boolean }).disabled) return false;\n return !inheritsFieldsetDisabled(element);\n}\n\n/* Elements whose semantics or authored attributes can place them in sequential focus order. /\nexport const TAB_STOP_CANDIDATE_SELECTOR = [\n \"a[href]\",\n \"area[href]\",\n \"button\",\n \"input\",\n \"select\",\n \"textarea\",\n \"summary\",\n \"iframe\",\n \"audio[controls]\",\n \"video[controls]\",\n \"[tabindex]\",\n \"[contenteditable]\",\n].join(\",\");\n\n/* Optional browser visibility API used to exclude CSS-hidden candidates. /\ninterface VisibilityCheckable {\n checkVisibility?: (options?: { visibilityProperty?: boolean }) => boolean;\n}\n\n/* Whether CSS visibility allows an otherwise eligible element to participate in focus order. /\nexport function isRenderedForFocus(element: HTMLElement): boolean {\n const check = (element as HTMLElement & VisibilityCheckable).checkVisibility;\n return typeof check === \"function\" ? check.call(element, { visibilityProperty: true }) : true;\n}\n\n/* Parses an authored `tabindex`; invalid syntax has no explicit focus-order meaning. /\nfunction authoredTabindex(element: HTMLElement): number \| null {\n const value = element.getAttribute(\"tabindex\");\n if (value === null \|\| !/^[+-]?\\d+$/.test(value.trim())) return null;\n return Number(value);\n}\n\n/* Whether the element's native semantics place it in sequential focus order. /\nfunction hasNativeTabStop(element: HTMLElement): boolean {\n if (element instanceof HTMLAnchorElement \|\| element instanceof HTMLAreaElement) {\n return element.hasAttribute(\"href\");\n }\n if (\n element instanceof HTMLButtonElement \|\|\n element instanceof HTMLSelectElement \|\|\n element instanceof HTMLTextAreaElement\n ) {\n return true;\n }\n if (element instanceof HTMLInputElement) return element.type !== \"hidden\";\n if (element instanceof HTMLIFrameElement) return true;\n if (element.tagName === \"AUDIO\" \|\| element.tagName === \"VIDEO\") {\n return element.hasAttribute(\"controls\");\n }\n if (element instanceof HTMLElement && element.tagName === \"SUMMARY\") {\n const details = element.parentElement;\n return (\n details instanceof HTMLDetailsElement &&\n Array.from(details.children).find((child) => child.tagName === \"SUMMARY\") === element\n );\n }\n return false;\n}\n\n/* Whether an explicit `contenteditable` value creates an editable tab stop. /\nfunction hasEditableTabStop(element: HTMLElement): boolean {\n const value = element.getAttribute(\"contenteditable\")?.toLowerCase();\n return value === \"\" \|\| value === \"true\" \|\| value === \"plaintext-only\";\n}\n\n/\n Whether an element is a usable sequential Tab stop right now.\n \n Native semantics, authored `tabindex`, editable hosts, inherited disabled state,\n * HTML `hidden`/`inert`, and CSS visibility are evaluated together. `aria-disabled`\n * remains focusable because it communicates unavailability without removing the\n * control from discovery order.\n /\nexport function isTabStop(element: HTMLElement): boolean {\n if (!canTakeFocus(element) \|\| !isRenderedForFocus(element)) return false;\n\n const tabindex = authoredTabindex(element);\n if (tabindex !== null) return tabindex >= 0;\n return hasNativeTabStop(element) \|\| hasEditableTabStop(element);\n}\n\n/* Returns every usable sequential Tab stop below `root` in document order. /\nexport function tabStopsWithin(root: ParentNode): HTMLElement[] {\n return Array.from(root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)).filter(\n isTabStop,\n );\n}\n\n/* Returns the first usable sequential Tab stop below `root`, if one exists. /\nexport function firstTabStop(root: ParentNode): HTMLElement \| null {\n for (const candidate of root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)) {\n if (isTabStop(candidate)) return candidate;\n }\n return null;\n}\n\n/* Whether `root` contains at least one usable sequential Tab stop. /\nexport function hasTabStop(root: ParentNode): boolean {\n return firstTabStop(root) !== null;\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { inheritsFieldsetDisabled } from \"../utils/focus_candidate\";\n\n/* Why one file was turned away, in the order the checks run. /\ntype RejectReason = \"type\" \| \"size\" \| \"duplicate\" \| \"count\";\n\n/* Present on the zone while a drag hovers it. /\nconst DRAGOVER_ATTRIBUTE = \"data-dragover\";\n\n/* Present on the zone from the first rejection of a batch until the next batch. /\nconst INVALID_ATTRIBUTE = \"data-stimeo--file-dropzone-invalid\";\n\n/* One selected file paired with its rendered item and any preview objectURL. /\ninterface Entry {\n readonly file: File;\n readonly item: HTMLElement;\n readonly url?: string;\n}\n\n/* One batch's rejections for a single reason, condensed into one announcement. /\ninterface RejectBatch {\n readonly name: string;\n count: number;\n}\n\n/\n Headless, accessible file drag-and-drop / upload field.\n \n Markup contract (identifier: `stimeo--file-dropzone`):\n * <div data-controller=\"stimeo--file-dropzone\"\n * data-stimeo--file-dropzone-max-size-value=\"5242880\"\n * data-stimeo--file-dropzone-announce-added-text-value=\"{name} added; {total} selected\">\n * <div data-stimeo--file-dropzone-target=\"zone\"\n * data-action=\"dragover->stimeo--file-dropzone#onDragOver\n * dragleave->stimeo--file-dropzone#onDragLeave\n * drop->stimeo--file-dropzone#onDrop\">\n * <button type=\"button\" data-stimeo--file-dropzone-target=\"trigger\"\n * data-action=\"click->stimeo--file-dropzone#openDialog\">Choose…</button>\n * <input type=\"file\" accept=\"image/\" multiple class=\"visually-hidden\"\n data-stimeo--file-dropzone-target=\"input\"\n * data-action=\"change->stimeo--file-dropzone#onChange\" />\n * </div>\n * <ul data-stimeo--file-dropzone-target=\"list\" aria-label=\"Selected files\"></ul>\n * <template data-stimeo--file-dropzone-target=\"itemTemplate\">\n * <li data-stimeo--file-dropzone-target=\"item\">\n * <img data-stimeo--file-dropzone-target=\"thumb\" alt=\"\" hidden />\n * <span data-stimeo--file-dropzone-target=\"name\"></span>\n * <button type=\"button\" aria-label=\"Remove {name}\"\n * data-stimeo--file-dropzone-target=\"remove\">×</button>\n * </li>\n * </template>\n * </div>\n \n There is no single APG pattern; the native `<input type=\"file\">` stays the\n * primary, keyboard-operable path and the drop zone is an enhancement, mapping to\n * WCAG 2.1.1, 2.4.7, 4.1.2, 4.1.3, and 1.4.1 (drag state is conveyed in words,\n * not color alone).\n \n Behavior provided:\n * - Click / keyboard via the `trigger` opens the native file dialog; drag-and-drop\n * over the `zone` adds files. The zone carries `data-dragover` for as long as the\n * pointer is anywhere inside it, descendants included — a `dragleave` whose\n * `relatedTarget` is still in the zone is the pointer crossing an inner element,\n * not leaving.\n * - Each file is validated in order against `accept`, `maxSize`, duplication, and\n * the file count (`maxFiles`, or 1 when the input is not `multiple`). The reason\n * is therefore the most specific one: a file the zone would refuse whatever the\n * count says reports its own defect rather than `count`. Rejects fire\n * `stimeo--file-dropzone:reject` and set `data-…-invalid`, which the next batch\n * clears.\n * - Two files count as the same when name, size, and last-modified time all match;\n * `allowDuplicates` turns the check off.\n * - Accepted files render from `itemTemplate`; the template's own remove-button\n * `aria-label` is kept and its `{name}` expanded, so the accessible name stays in\n * the consumer's language. A template missing a part renders nothing, changes no\n * state, and reports itself once per connection.\n * - The accepted set is mirrored onto the native input, so a plain form submit\n * carries the dropped files with no JavaScript from the consumer. Where\n * `DataTransfer` cannot be constructed the previews and events still work and the\n * input keeps whatever the native dialog last put there.\n * - Removing a file revokes its `objectURL` and moves focus to the next (else\n * previous) remove button, falling back to the trigger.\n * - Additions, rejections, removals, and the drag affordance are handed to the\n * page's shared `stimeo--announcer` as one polite message each, worded by the\n * consumer (`{name}` is the file this message is about, `{count}` how many files\n * it covers, `{total}` how many are selected afterwards). Empty templates stay\n * silent, keeping announcements opt-in and i18n-neutral. One batch produces at\n * most one message per outcome, so dropping twenty files never reads twenty lines.\n * - A drop into a disabled field is refused: with the input `disabled` or inside a\n * disabled `fieldset` the zone never becomes a drop target, matching what the\n * native click and keyboard paths already do.\n * - Replacing the `list` target rebinds delegated removal and moves the\n * client-only previews into the replacement; a morph that empties the list in\n * place moves them back on the next interaction.\n * `reject` dispatches `{ file: File, reason: \"type\" \| \"size\" \| \"duplicate\" \| \"count\" }`.\n * `change` and `reconcile` dispatch `{ files: File[] }`.\n \n @remarks\n * Previews are client-only state that no restored snapshot can revive — the `File`\n * objects and their `blob:` URLs die with the page. Just before Turbo caches the\n * page the generated items are removed, every `objectURL` revoked, and both state\n * attributes withdrawn, so a restored snapshot starts pristine instead of showing\n * rows that cannot be removed and do not count towards `maxFiles`. A `disconnect()`\n * that turns out to be an in-page move keeps the selection intact.\n /\nexport class FileDropzoneController extends Controller<HTMLElement> {\n static override targets = [\n \"zone\",\n \"trigger\",\n \"input\",\n \"list\",\n \"item\",\n \"itemTemplate\",\n \"name\",\n \"thumb\",\n \"remove\",\n ];\n static override values = {\n maxSize: { type: Number, default: 0 },\n maxFiles: { type: Number, default: 0 },\n allowDuplicates: { type: Boolean, default: false },\n announceDragText: { type: String, default: \"\" },\n announceAddedText: { type: String, default: \"\" },\n announceRemovedText: { type: String, default: \"\" },\n announceRejectedTypeText: { type: String, default: \"\" },\n announceRejectedSizeText: { type: String, default: \"\" },\n announceRejectedDuplicateText: { type: String, default: \"\" },\n announceRejectedCountText: { type: String, default: \"\" },\n };\n static actions = [\"onChange\", \"onDragLeave\", \"onDragOver\", \"onDrop\", \"openDialog\"] as const;\n static events = [\"change\", \"reject\", \"reconcile\"] as const;\n\n declare readonly inputTarget: HTMLInputElement;\n declare readonly listTarget: HTMLElement;\n declare readonly listTargets: HTMLElement[];\n declare readonly triggerTarget: HTMLElement;\n declare readonly itemTemplateTarget: HTMLTemplateElement;\n declare readonly hasInputTarget: boolean;\n declare readonly hasListTarget: boolean;\n declare readonly hasTriggerTarget: boolean;\n declare readonly hasItemTemplateTarget: boolean;\n declare readonly hasZoneTarget: boolean;\n declare readonly zoneTarget: HTMLElement;\n\n declare maxSizeValue: number;\n declare maxFilesValue: number;\n declare allowDuplicatesValue: boolean;\n declare announceDragTextValue: string;\n declare announceAddedTextValue: string;\n declare announceRemovedTextValue: string;\n declare announceRejectedTypeTextValue: string;\n declare announceRejectedSizeTextValue: string;\n declare announceRejectedDuplicateTextValue: string;\n declare announceRejectedCountTextValue: string;\n\n /* Selected files paired with their rendered item and any preview objectURL. /\n readonly #entries: Entry[] = [];\n /* Whether a drag is currently over the zone; the source for `data-dragover`. /\n #dragging = false;\n /* Whether this connection already reported its unusable item template. /\n #warnedTemplate = false;\n readonly #gate = new DetachGate();\n readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n\n /* Subscribes to the Turbo cache rewind and re-arms the template diagnostic. /\n override connect(): void {\n this.#gate.cancel();\n this.#warnedTemplate = false;\n this.#beforeCache.activate();\n }\n\n /\n Releases the delegated listeners. The selection itself survives an in-page\n * move and is released only once the gate proves a real detach — revoking a\n * preview URL on a move would leave a live item pointing at a dead `blob:`.\n /\n override disconnect(): void {\n for (const list of this.listTargets) list.removeEventListener(\"click\", this.#onItemClick);\n this.#beforeCache.deactivate();\n this.#gate.disconnected(this, () => this.#teardown());\n }\n\n /\n Binds removal and restores client-only previews for every list this controller\n * renders into — the one present at connect and any Turbo puts in its place.\n * This is the only place the listener is attached, so the pair with\n * {@link listTargetDisconnected} keeps it from outliving the element it is on.\n /\n listTargetConnected(list: HTMLElement): void {\n this.#bindList(list);\n }\n\n /* Releases only the list target that actually disconnected. /\n listTargetDisconnected(list: HTMLElement): void {\n list.removeEventListener(\"click\", this.#onItemClick);\n }\n\n /* Binds delegated removal once and moves live preview items into the current list. /\n #bindList(list: HTMLElement): void {\n list.addEventListener(\"click\", this.#onItemClick);\n for (const entry of this.#entries) {\n if (!list.contains(entry.item)) list.appendChild(entry.item);\n }\n }\n\n /* Opens the native file dialog. Bound via `data-action` (trigger click). /\n openDialog(): void {\n if (this.#isDisabled) return;\n this.inputTarget.click();\n }\n\n /\n Adds the files chosen through the native dialog. The input holds only what\n * the dialog just returned, so the accepted set is written back over it once\n * the batch is validated.\n /\n onChange(): void {\n const files = this.inputTarget.files;\n if (files) this.#addFiles(files);\n else this.#syncInput();\n }\n\n /\n Marks the zone as a drop target and announces the affordance once per drag.\n * Bound via `data-action` (dragover). Leaving the default alone is what refuses\n * the drop, so a disabled field and a drag an inner dropzone already claimed\n * both fall through untouched.\n /\n onDragOver(event: DragEvent): void {\n if (event.defaultPrevented \|\| this.#isDisabled) return;\n event.preventDefault();\n if (this.#dragging) return;\n this.#dragging = true;\n if (this.hasZoneTarget) this.zoneTarget.setAttribute(DRAGOVER_ATTRIBUTE, \"\");\n // No file is involved yet, so only `{total}` resolves; the rest stay as authored.\n announce(fillTemplate(this.announceDragTextValue, { total: this.#entries.length }));\n }\n\n /\n Clears the drag-over flag when the pointer leaves the zone. Bound via\n * `data-action` (dragleave). `dragleave` bubbles from every descendant the\n * pointer crosses, so the flag only drops when the element being entered is\n * outside the zone (or there is none, the pointer having left the window).\n /\n onDragLeave(event: DragEvent): void {\n const next = event.relatedTarget;\n if (this.hasZoneTarget && next instanceof Node && this.zoneTarget.contains(next)) return;\n this.#endDrag();\n }\n\n /* Accepts dropped files, clearing the drag-over state. Bound via `data-action` (drop). /\n onDrop(event: DragEvent): void {\n if (event.defaultPrevented) return;\n this.#endDrag();\n if (this.#isDisabled) return;\n event.preventDefault();\n if (event.dataTransfer?.files) this.#addFiles(event.dataTransfer.files);\n }\n\n /\n Removes the file whose remove button was clicked. Delegated on the list\n * container rather than bound per item via `data-action`, so it works the instant\n * an item is appended without waiting on Stimulus to wire a freshly created element.\n * Only the item's declared `remove` target counts, so an authored second control\n * inside an item does what it says instead of silently discarding the file. The\n * button has to belong to a tracked item, which is what makes a list this\n * controller no longer renders into inert — its items moved out with it.\n /\n readonly #onItemClick = (event: MouseEvent): void => {\n const button = (event.target as HTMLElement).closest<HTMLButtonElement>(\n 'button[data-stimeo--file-dropzone-target~=\"remove\"]',\n );\n const index = this.#entries.findIndex((entry) => entry.item.contains(button));\n if (index !== -1) this.#removeAt(index);\n };\n\n /* Validates each incoming file, renders the accepted ones, and reports the batch. /\n #addFiles(files: FileList): void {\n this.#rehome();\n if (this.hasZoneTarget) this.zoneTarget.removeAttribute(INVALID_ATTRIBUTE);\n const rejected = new Map<RejectReason, RejectBatch>();\n const turnedAway: Array<{ file: File; reason: RejectReason }> = [];\n let addedName = \"\";\n let added = 0;\n for (const file of Array.from(files)) {\n const reason = this.#validate(file);\n if (reason !== null) {\n if (this.hasZoneTarget) this.zoneTarget.setAttribute(INVALID_ATTRIBUTE, \"\");\n const batch = rejected.get(reason);\n if (batch) batch.count += 1;\n else rejected.set(reason, { name: file.name, count: 1 });\n turnedAway.push({ file, reason });\n continue;\n }\n // Nothing is rendered when the template is unusable, so nothing was selected\n // either: the set must not report a change it did not make.\n if (!this.#appendFile(file)) continue;\n if (added === 0) addedName = file.name;\n added += 1;\n }\n this.#syncInput();\n // The batch reports what it took before what it turned away — the same order\n // the announcements use. A consumer that clears its rejection notice when a\n // file lands would otherwise wipe the notice for the very drop that raised it.\n if (added > 0) {\n this.#announce(this.announceAddedTextValue, addedName, added);\n this.dispatch(\"change\", { detail: { files: this.#files } });\n }\n for (const { file, reason } of turnedAway) {\n this.dispatch(\"reject\", { detail: { file, reason } });\n }\n for (const [reason, batch] of rejected) {\n this.#announce(this.#rejectText(reason), batch.name, batch.count);\n }\n }\n\n /\n Returns the rejection reason for `file`, or `null` when it is acceptable.\n * The file's own defects are decided first, so a full list still tells the user\n * which files it would never have taken.\n /\n #validate(file: File): RejectReason \| null {\n if (!this.#matchesAccept(file)) return \"type\";\n if (this.maxSizeValue > 0 && file.size > this.maxSizeValue) return \"size\";\n if (\n !this.allowDuplicatesValue &&\n this.#entries.some((entry) => this.#isSame(entry.file, file))\n ) {\n return \"duplicate\";\n }\n const limit = this.#effectiveMaxFiles;\n if (limit > 0 && this.#entries.length >= limit) return \"count\";\n return null;\n }\n\n /\n Whether two files are the same selection. `File` objects from separate picks\n * are never the same reference, so identity is the triple the platform exposes.\n /\n #isSame(a: File, b: File): boolean {\n return a.name === b.name && a.size === b.size && a.lastModified === b.lastModified;\n }\n\n /\n Builds one preview item (name, optional thumbnail, remove button) and reports\n * whether it was rendered.\n /\n #appendFile(file: File): boolean {\n if (!this.hasListTarget) return this.#warnTemplate('a \"list\" target to render into');\n if (!this.hasItemTemplateTarget) return this.#warnTemplate('an \"itemTemplate\" target');\n const fragment = this.itemTemplateTarget.content.cloneNode(true) as DocumentFragment;\n const item = this.#slot(fragment, \"item\");\n const name = this.#slot(fragment, \"name\");\n const thumb = this.#slot<HTMLImageElement>(fragment, \"thumb\");\n const button = fragment.querySelector<HTMLButtonElement>(\n 'button[data-stimeo--file-dropzone-target~=\"remove\"]',\n );\n const removeName = button?.getAttribute(\"aria-label\")?.trim() ?? \"\";\n if (!item) return this.#warnTemplate('an \"item\" root');\n if (!name) return this.#warnTemplate('a \"name\" element');\n if (!button) return this.#warnTemplate('a \"remove\" target <button>');\n if (removeName === \"\") {\n return this.#warnTemplate('a non-empty aria-label on its \"remove\" target');\n }\n name.textContent = file.name;\n // The authored label owns the wording and the language; only `{name}` is filled.\n button.setAttribute(\"aria-label\", fillTemplate(removeName, { name: file.name }));\n\n let url: string \| undefined;\n if (thumb && file.type.startsWith(\"image/\")) {\n url = URL.createObjectURL(file);\n thumb.src = url;\n thumb.alt = file.name;\n thumb.hidden = false;\n } else if (thumb) {\n thumb.hidden = true;\n }\n\n this.listTarget.appendChild(fragment);\n this.#entries.push({ file, item, url });\n return true;\n }\n\n /* Resolves one declared part inside a cloned item template. /\n #slot<T extends HTMLElement = HTMLElement>(fragment: DocumentFragment, name: string): T \| null {\n return fragment.querySelector<T>(`[data-stimeo--file-dropzone-target~=\"${name}\"]`);\n }\n\n /\n Reports an unusable item template to the author, once per connection.\n \n The addition itself stays a no-op — nothing about the selection, the native\n * input, the announcements, or the events changes. Without this line the only\n * symptom is a picker that accepts no file at all, and the causes the Inspector\n * cannot see statically (a server-rendered template, a name that renders empty\n * from a missing translation) would have no diagnostic anywhere.\n /\n #warnTemplate(missing: string): false {\n if (!this.#warnedTemplate) {\n this.#warnedTemplate = true;\n console.warn(\n `Stimeo UI: \"${this.identifier}\" added no file because its item template lacks ${missing}.`,\n );\n }\n return false;\n }\n\n /* Removes entry `index`, revokes its preview, and re-homes focus. /\n #removeAt(index: number): void {\n const entry = this.#entries[index];\n if (!entry) return;\n if (entry.url) URL.revokeObjectURL(entry.url);\n entry.item.remove();\n this.#entries.splice(index, 1);\n this.#syncInput();\n this.#announce(this.announceRemovedTextValue, entry.file.name, 1);\n this.dispatch(\"change\", { detail: { files: this.#files } });\n\n const buttons = this.#removeButtons;\n if (buttons.length === 0) {\n if (this.hasTriggerTarget) this.triggerTarget.focus();\n } else {\n (buttons[index] ?? buttons[buttons.length - 1])?.focus();\n }\n }\n\n /* Whether `file` satisfies the input's `accept` list (empty accepts all). /\n #matchesAccept(file: File): boolean {\n const accept = this.inputTarget.accept.trim();\n if (accept === \"\") return true;\n const name = file.name.toLowerCase();\n const type = file.type.toLowerCase();\n return accept.split(\",\").some((raw) => {\n const token = raw.trim().toLowerCase();\n if (token === \"\") return false;\n if (token.startsWith(\".\")) return name.endsWith(token);\n if (token.endsWith(\"/\")) return type.startsWith(token.slice(0, -1));\n return type === token;\n });\n }\n\n /*\n Sends one consumer-worded message to the page's shared announcer. `{name}` is\n * the file the message is about, `{count}` how many files it covers, and\n * `{total}` how many are selected once the batch has settled.\n /\n #announce(template: string, name: string, count: number): void {\n announce(fillTemplate(template, { name, count, total: this.#entries.length }));\n }\n\n /* The consumer's wording for one rejection reason. /\n #rejectText(reason: RejectReason): string {\n switch (reason) {\n case \"type\":\n return this.announceRejectedTypeTextValue;\n case \"size\":\n return this.announceRejectedSizeTextValue;\n case \"duplicate\":\n return this.announceRejectedDuplicateTextValue;\n case \"count\":\n return this.announceRejectedCountTextValue;\n }\n }\n\n /\n Mirrors the accepted set onto the native input, so a plain form submit carries\n * the dropped files. Skipped where `DataTransfer` cannot be constructed: the\n * widget keeps working and the consumer still receives every `File` on `change`.\n /\n #syncInput(): void {\n // The rewind runs from the shared before-cache pass, where a throw would rob\n // every later subscriber of its own rewind — and a morph can take the input\n // target away before that point.\n if (!this.hasInputTarget) return;\n const transfer = this.#newTransfer();\n if (!transfer) return;\n for (const entry of this.#entries) transfer.items.add(entry.file);\n this.inputTarget.files = transfer.files;\n }\n\n /* A usable empty `DataTransfer`, or `null` where the platform has none. /\n #newTransfer(): DataTransfer \| null {\n try {\n return new DataTransfer();\n } catch {\n // No constructor at all, or one that refuses construction.\n return null;\n }\n }\n\n /\n Moves surviving preview items back under the current list. A morph that\n * empties the list in place leaves the selection with no rendering, and the\n * files it holds cannot be rebuilt from the DOM, so the items are re-homed\n * rather than forgotten.\n /\n #rehome(): void {\n if (!this.hasListTarget) return;\n for (const entry of this.#entries) {\n if (!this.listTarget.contains(entry.item)) this.listTarget.appendChild(entry.item);\n }\n }\n\n /* Drops the drag-over state, whether the drag ended in a drop or left the zone. /\n #endDrag(): void {\n this.#dragging = false;\n if (this.hasZoneTarget) this.zoneTarget.removeAttribute(DRAGOVER_ATTRIBUTE);\n }\n\n /\n Discards the selection and every state attribute this controller wrote, so\n * neither a cached snapshot nor a stranded subtree keeps items whose files are\n * gone. Silent: `change` means a selection the user changed, and the cache\n * rewind reports itself as `reconcile` instead.\n /\n #rewindForCache(): void {\n const had = this.#entries.length > 0;\n this.#reset();\n // The rewind decides the selection is gone, so consumers that painted from\n // `change` (or from `reject`) can drop what they drew before the snapshot is\n // taken. Nothing to report when there was nothing to discard.\n if (had) this.dispatch(\"reconcile\", { detail: { files: this.#files } });\n }\n\n #reset(): void {\n for (const entry of this.#entries) {\n if (entry.url) URL.revokeObjectURL(entry.url);\n entry.item.remove();\n }\n this.#entries.length = 0;\n this.#syncInput();\n this.#endDrag();\n if (this.hasZoneTarget) this.zoneTarget.removeAttribute(INVALID_ATTRIBUTE);\n }\n\n /* Releases the selection once the disconnect is known to be a real detach. /\n #teardown(): void {\n this.#gate.cancel();\n this.#reset();\n }\n\n /* Whether the field refuses input, natively or through an ancestor `fieldset`. /\n get #isDisabled(): boolean {\n return this.inputTarget.disabled \|\| inheritsFieldsetDisabled(this.inputTarget);\n }\n\n /* Effective file cap: `maxFiles`, or 1 when the input is single-select. /\n get #effectiveMaxFiles(): number {\n if (this.maxFilesValue > 0) return this.maxFilesValue;\n return this.inputTarget.multiple ? 0 : 1;\n }\n\n /* The declared remove button of each rendered item, in selection order. /\n get #removeButtons(): HTMLButtonElement[] {\n const buttons: HTMLButtonElement[] = [];\n for (const entry of this.#entries) {\n const button = entry.item.querySelector<HTMLButtonElement>(\n 'button[data-stimeo--file-dropzone-target~=\"remove\"]',\n );\n if (button) buttons.push(button);\n }\n return buttons;\n }\n\n /* The accepted files in selection order. */\n get #files(): File[] {\n return this.#entries.map((entry) => entry.file);\n }\n}\n"]}
1	+ {"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/before_cache_reset.ts","../../src/utils/detach_gate.ts","../../src/utils/focus_candidate.ts","../../src/controllers/file_dropzone_controller.ts"],"names":[],"mappings":"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","file":"file_dropzone_controller.js","sourcesContent":["/*\n Sends one message to the page's shared `stimeo--announcer`.\n \n A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes after assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n \n The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n \n Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n \n @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n /\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n const text = message.trim();\n if (text.length === 0) return;\n window.dispatchEvent(\n new CustomEvent(\"stimeo--announcer:announce\", {\n detail: { message: text, assertive: options.assertive === true },\n }),\n );\n}\n\n/\n Fills `{name}` placeholders in an announcement template from `values`.\n \n The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n /\nexport function fillTemplate(template: string, values: Record<string, string \| number>): string {\n return template.replace(/\\{([a-zA-Z][a-zA-Z0-9])\\}/g, (match, name: string) => {\n const replacement = values[name];\n return replacement === undefined ? match : String(replacement);\n });\n}\n","/*\n Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n \n `disconnect()` cannot do this job, for two independent reasons. Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n \n Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. What to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way.\n \n Rewind state, not appearance. The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n \n Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n \n This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n \n @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n \n connect() { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n /\nexport class BeforeCacheReset {\n /* Every subscribed instance, iterated by the one shared document listener. /\n static readonly #subscribers = new Set<BeforeCacheReset>();\n\n /* The shared listener; installed while at least one instance is subscribed. /\n static readonly #onBeforeCache = (): void => {\n for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n };\n\n readonly #rewind: () => void;\n\n /* @param rewind - the pass that returns this controller's state to its initial form. /\n constructor(rewind: () => void) {\n this.#rewind = rewind;\n }\n\n /* Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. /\n activate(): void {\n const first = BeforeCacheReset.#subscribers.size === 0;\n BeforeCacheReset.#subscribers.add(this);\n if (first) {\n document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n }\n }\n\n /* Unsubscribes; call from `disconnect()`. Safe when never subscribed. /\n deactivate(): void {\n BeforeCacheReset.#subscribers.delete(this);\n if (BeforeCacheReset.#subscribers.size > 0) return;\n document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n }\n}\n","/\n Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n \n A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n \n - an in-page move — a consumer (sortable, a teleport) re-inserted the\n * element; Stimulus reconnects the SAME instance in the same mutation batch\n * and the controller's runtime state must survive;\n * - a detach that keeps the element — `data-controller` no longer lists the\n * identifier (a Turbo 8 morph), or the element moved outside the observed\n * root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n * ever come and the controller must tear down or it leaks its sessions,\n * document listeners, and moved nodes.\n \n Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n \n Policy stays with the consumer; this util owns the discrimination only:\n \n - Probe ({@link disconnected}) when the teardown must eventually happen —\n * live drag sessions, document listeners, teleported content. Call\n * {@link cancel} from `connect()` (a reconnect means in-page move) and from\n * the head of any direct teardown path (see below).\n * - Keep (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n * case would fight the controller's own effect: a controller that moves its\n * OWN element (portal's no-`content` form) exits a scoped observed root as\n * its normal job — a probe-driven teardown would restore the element into\n * the root, reconnect, re-teleport, and disconnect again, forever. Such\n * controllers keep their state on an ambiguous disconnect and tear down only\n * on {@link DetachGate.isDetached}.\n \n Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n /\n\n/* The slice of a Stimulus controller the gate inspects. /\nexport interface DetachGateHost {\n readonly element: Element;\n readonly identifier: string;\n}\n\n/\n Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n \n @example\n * ```ts\n * #gate = new DetachGate();\n \n connect(): void {\n * this.#gate.cancel(); // a reconnect: the element moved in-page\n * // …\n * }\n \n disconnect(): void {\n * this.#gate.disconnected(this, () => this.#teardown());\n * }\n \n #teardown(): void {\n * this.#gate.cancel(); // disarm a still-queued probe (double-run guard)\n * // …\n * }\n * ```\n /\nexport class DetachGate {\n /* Set while a probe is queued, waiting for a reconnect to cancel it. /\n #pending = false;\n\n /\n True while a probe is queued — the last disconnect was ambiguous and no\n * reconnect has cancelled it yet. Read it from `connect()` to tell the\n * reconnect half of an in-page move from a first connect: a controller whose\n * initialisation restarts a measurement (a min-duration floor, an elapsed\n * counter) must skip it for the move, where nothing actually restarted.\n /\n get pending(): boolean {\n return this.#pending;\n }\n\n /\n True when the disconnect is definitely a real detach — the element left\n * the document, or `data-controller` no longer lists the identifier. False\n * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n /\n static isDetached(host: DetachGateHost): boolean {\n if (!host.element.isConnected) return true;\n const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n return !tokens.includes(host.identifier);\n }\n\n /\n Call from `disconnect()`: runs `teardown` synchronously on a definite\n * detach (fast path), otherwise defers it one microtask — a reconnect\n * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n * One microtask is the whole probe window: Stimulus reconnects a moved\n * element within the same mutation batch, before the checkpoint drains.\n /\n disconnected(host: DetachGateHost, teardown: () => void): void {\n if (DetachGate.isDetached(host)) {\n // Also disarms a probe a previous ambiguous disconnect left queued\n // (defer, element removed, disconnect again) — exactly one teardown.\n this.#pending = false;\n teardown();\n return;\n }\n this.#pending = true;\n queueMicrotask(() => {\n if (!this.#pending) return;\n this.#pending = false;\n teardown();\n });\n }\n\n /\n Disarms a pending probe. Call from `connect()` (the reconnect that proves\n * an in-page move) and from the head of any teardown path not routed through\n * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n * never run the teardown a second time.\n /\n cancel(): void {\n this.#pending = false;\n }\n}\n","/\n Whether a disabled `<fieldset>` ancestor actually reaches `control`.\n \n HTML exempts the contents of a fieldset's first direct-child `<legend>`, and\n * the exemption is per fieldset — a control legal in one legend can still be\n * disabled by a second, outer fieldset, so the walk continues upward.\n \n Exported on its own for callers that need the disabled-inheritance rule without\n * the rest of {@link canTakeFocus} — a control's availability check, or a `hidden`\n * walk bounded at a widget root, which is a different rule to compose with.\n /\nexport function inheritsFieldsetDisabled(control: HTMLElement): boolean {\n let fieldset: Element \| null = control.closest(\"fieldset[disabled]\");\n while (fieldset) {\n const legend = Array.from(fieldset.children).find((child) => child.tagName === \"LEGEND\");\n if (!legend?.contains(control)) return true;\n fieldset = fieldset.parentElement?.closest(\"fieldset[disabled]\") ?? null;\n }\n return false;\n}\n\n/\n Whether an element can actually take focus, checked before `focus()` runs.\n \n A controller that must move focus off a control it is about to disable or hide\n * picks a destination and calls `focus()` on it. If that destination cannot take\n * focus, the call fails silently: `hidden` and natively `disabled` elements\n * swallow it, so the caret stays in the subtree that is disappearing and lands on\n * `<body>` a frame later — the exact outcome the rescue exists to prevent, minus\n * any signal that it happened.\n \n Testing after the fact is the obvious alternative and is deliberately not the\n * rule. Reading `document.activeElement` back only works in a real browser, and\n * looping over candidates that way performs a real focus move per failure —\n * observable to assistive technology. Checking first costs nothing and catches\n * the cases that actually occur.\n \n `aria-disabled` is not disqualifying. It is the attribute an author uses\n * for a control that must stay discoverable, and the roving contract keeps\n * such items reachable. Only the three conditions that make the platform refuse\n * focus are checked: `hidden` / `inert` (an ancestor's counts),\n * `input[type=\"hidden\"]`, the native `disabled` property, and `disabled`\n * inherited from an ancestor `fieldset`. CSS-only invisibility is handled by\n * {@link isRenderedForFocus} when a consumer needs sequential-focus semantics.\n \n Reading `:disabled` instead of walking the fieldset chain would be shorter, but\n * that pseudo-class is not evaluated consistently outside real browsers and this\n * has to be right headlessly too. happy-dom in particular focuses a `<button>`\n * inside a disabled fieldset where a real engine refuses, so the inheritance is\n * spelled out rather than delegated.\n \n What a consumer does when nothing survives is its own call: some fall back to\n * their landmark, while a widget whose caret already sits somewhere legitimate\n * refuses the move outright rather than relocating it.\n \n @example\n * ```ts\n * const target = candidates.find(canTakeFocus);\n * if (target) target.focus();\n * else {\n * this.#tabindex.lend(this.element); // nothing left: fall back to the landmark\n * this.element.focus();\n * }\n * ```\n \n @param element - the candidate destination\n /\nexport function canTakeFocus(element: HTMLElement): boolean {\n if (element.closest(\"[hidden], [inert]\")) return false;\n if (element instanceof HTMLInputElement && element.type === \"hidden\") return false;\n if (!(\"disabled\" in element)) return true;\n if ((element as HTMLElement & { disabled: boolean }).disabled) return false;\n return !inheritsFieldsetDisabled(element);\n}\n\n/* Elements whose semantics or authored attributes can place them in sequential focus order. /\nexport const TAB_STOP_CANDIDATE_SELECTOR = [\n \"a[href]\",\n \"area[href]\",\n \"button\",\n \"input\",\n \"select\",\n \"textarea\",\n \"summary\",\n \"iframe\",\n \"audio[controls]\",\n \"video[controls]\",\n \"[tabindex]\",\n \"[contenteditable]\",\n].join(\",\");\n\n/* Optional browser visibility API used to exclude CSS-hidden candidates. /\ninterface VisibilityCheckable {\n checkVisibility?: (options?: { visibilityProperty?: boolean }) => boolean;\n}\n\n/* Whether CSS visibility allows an otherwise eligible element to participate in focus order. /\nexport function isRenderedForFocus(element: HTMLElement): boolean {\n const check = (element as HTMLElement & VisibilityCheckable).checkVisibility;\n return typeof check === \"function\" ? check.call(element, { visibilityProperty: true }) : true;\n}\n\n/* Parses an authored `tabindex`; invalid syntax has no explicit focus-order meaning. /\nfunction authoredTabindex(element: HTMLElement): number \| null {\n const value = element.getAttribute(\"tabindex\");\n if (value === null \|\| !/^[+-]?\\d+$/.test(value.trim())) return null;\n return Number(value);\n}\n\n/* Whether the element's native semantics place it in sequential focus order. /\nfunction hasNativeTabStop(element: HTMLElement): boolean {\n if (element instanceof HTMLAnchorElement \|\| element instanceof HTMLAreaElement) {\n return element.hasAttribute(\"href\");\n }\n if (\n element instanceof HTMLButtonElement \|\|\n element instanceof HTMLSelectElement \|\|\n element instanceof HTMLTextAreaElement\n ) {\n return true;\n }\n if (element instanceof HTMLInputElement) return element.type !== \"hidden\";\n if (element instanceof HTMLIFrameElement) return true;\n if (element.tagName === \"AUDIO\" \|\| element.tagName === \"VIDEO\") {\n return element.hasAttribute(\"controls\");\n }\n if (element instanceof HTMLElement && element.tagName === \"SUMMARY\") {\n const details = element.parentElement;\n return (\n details instanceof HTMLDetailsElement &&\n Array.from(details.children).find((child) => child.tagName === \"SUMMARY\") === element\n );\n }\n return false;\n}\n\n/* Whether an explicit `contenteditable` value creates an editable tab stop. /\nfunction hasEditableTabStop(element: HTMLElement): boolean {\n const value = element.getAttribute(\"contenteditable\")?.toLowerCase();\n return value === \"\" \|\| value === \"true\" \|\| value === \"plaintext-only\";\n}\n\n/\n Whether an element is a usable sequential Tab stop right now.\n \n Native semantics, authored `tabindex`, editable hosts, inherited disabled state,\n * HTML `hidden`/`inert`, and CSS visibility are evaluated together. `aria-disabled`\n * remains focusable because it communicates unavailability without removing the\n * control from discovery order.\n /\nexport function isTabStop(element: HTMLElement): boolean {\n if (!canTakeFocus(element) \|\| !isRenderedForFocus(element)) return false;\n\n const tabindex = authoredTabindex(element);\n if (tabindex !== null) return tabindex >= 0;\n return hasNativeTabStop(element) \|\| hasEditableTabStop(element);\n}\n\n/* Returns every usable sequential Tab stop below `root` in document order. /\nexport function tabStopsWithin(root: ParentNode): HTMLElement[] {\n return Array.from(root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)).filter(\n isTabStop,\n );\n}\n\n/* Returns the first usable sequential Tab stop below `root`, if one exists. /\nexport function firstTabStop(root: ParentNode): HTMLElement \| null {\n for (const candidate of root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)) {\n if (isTabStop(candidate)) return candidate;\n }\n return null;\n}\n\n/* Whether `root` contains at least one usable sequential Tab stop. /\nexport function hasTabStop(root: ParentNode): boolean {\n return firstTabStop(root) !== null;\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { inheritsFieldsetDisabled } from \"../utils/focus_candidate\";\n\n/* Why one file was turned away, in the order the checks run. /\ntype RejectReason = \"type\" \| \"size\" \| \"duplicate\" \| \"count\";\n\n/* Present on the zone while a drag hovers it. /\nconst DRAGOVER_ATTRIBUTE = \"data-dragover\";\n\n/* Present on the zone from the first rejection of a batch until the next batch. /\nconst INVALID_ATTRIBUTE = \"data-stimeo--file-dropzone-invalid\";\n\n/* One selected file paired with its rendered item and any preview objectURL. /\ninterface Entry {\n readonly file: File;\n readonly item: HTMLElement;\n readonly url?: string;\n}\n\n/* One batch's rejections for a single reason, condensed into one announcement. /\ninterface RejectBatch {\n readonly name: string;\n count: number;\n}\n\n/\n Headless, accessible file drag-and-drop / upload field.\n \n Markup contract (identifier: `stimeo--file-dropzone`):\n * <div data-controller=\"stimeo--file-dropzone\"\n * data-stimeo--file-dropzone-max-size-value=\"5242880\"\n * data-stimeo--file-dropzone-announce-added-text-value=\"{name} added; {total} selected\">\n * <div data-stimeo--file-dropzone-target=\"zone\"\n * data-action=\"dragover->stimeo--file-dropzone#onDragOver\n * dragleave->stimeo--file-dropzone#onDragLeave\n * drop->stimeo--file-dropzone#onDrop\">\n * <button type=\"button\" data-stimeo--file-dropzone-target=\"trigger\"\n * data-action=\"click->stimeo--file-dropzone#openDialog\">Choose…</button>\n * <input type=\"file\" accept=\"image/\" multiple class=\"visually-hidden\"\n data-stimeo--file-dropzone-target=\"input\"\n * data-action=\"change->stimeo--file-dropzone#onChange\" />\n * </div>\n * <ul data-stimeo--file-dropzone-target=\"list\" aria-label=\"Selected files\"></ul>\n * <template data-stimeo--file-dropzone-target=\"itemTemplate\">\n * <li data-stimeo--file-dropzone-target=\"item\">\n * <img data-stimeo--file-dropzone-target=\"thumb\" alt=\"\" hidden />\n * <span data-stimeo--file-dropzone-target=\"name\"></span>\n * <button type=\"button\" aria-label=\"Remove {name}\"\n * data-stimeo--file-dropzone-target=\"remove\">×</button>\n * </li>\n * </template>\n * </div>\n \n There is no single APG pattern; the native `<input type=\"file\">` stays the\n * primary, keyboard-operable path and the drop zone is an enhancement, mapping to\n * WCAG 2.1.1, 2.4.7, 4.1.2, 4.1.3, and 1.4.1 (drag state is conveyed in words,\n * not color alone).\n \n Behavior provided:\n * - Click / keyboard via the `trigger` opens the native file dialog; drag-and-drop\n * over the `zone` adds files. The zone carries `data-dragover` for as long as the\n * pointer is anywhere inside it, descendants included — a `dragleave` whose\n * `relatedTarget` is still in the zone is the pointer crossing an inner element,\n * not leaving.\n * - Each file is validated in order against `accept`, `maxSize`, duplication, and\n * the file count (`maxFiles`, or 1 when the input is not `multiple`). The reason\n * is therefore the most specific one: a file the zone would refuse whatever the\n * count says reports its own defect rather than `count`. Rejects fire\n * `stimeo--file-dropzone:reject` and set `data-…-invalid`, which the next batch\n * clears.\n * - Two files count as the same when name, size, and last-modified time all match;\n * `allowDuplicates` turns the check off.\n * - Accepted files render from `itemTemplate`; the template's own remove-button\n * `aria-label` is kept and its `{name}` expanded, so the accessible name stays in\n * the consumer's language. A template missing a part renders nothing, changes no\n * state, and reports itself once per connection.\n * - The accepted set is mirrored onto the native input, so a plain form submit\n * carries the dropped files with no JavaScript from the consumer. Where\n * `DataTransfer` cannot be constructed the previews and events still work and the\n * input keeps whatever the native dialog last put there.\n * - Removing a file revokes its `objectURL` and moves focus to the next (else\n * previous) remove button, falling back to the trigger.\n * - Additions, rejections, removals, and the drag affordance are handed to the\n * page's shared `stimeo--announcer` as one polite message each, worded by the\n * consumer (`{name}` is the file this message is about, `{count}` how many files\n * it covers, `{total}` how many are selected afterwards). Empty templates stay\n * silent, keeping announcements opt-in and i18n-neutral. One batch produces at\n * most one message per outcome, so dropping twenty files never reads twenty lines.\n * - A drop into a disabled field is refused: with the input `disabled` or inside a\n * disabled `fieldset` the zone never becomes a drop target, matching what the\n * native click and keyboard paths already do.\n * - Replacing the `list` target rebinds delegated removal and moves the\n * client-only previews into the replacement; a morph that empties the list in\n * place moves them back on the next interaction.\n * `reject` dispatches `{ file: File, reason: \"type\" \| \"size\" \| \"duplicate\" \| \"count\" }`.\n * `change` and `reconcile` dispatch `{ files: File[] }`.\n \n @remarks\n * Previews are client-only state that no restored snapshot can revive — the `File`\n * objects and their `blob:` URLs die with the page. Just before Turbo caches the\n * page the generated items are removed, every `objectURL` revoked, and both state\n * attributes withdrawn, so a restored snapshot starts pristine instead of showing\n * rows that cannot be removed and do not count towards `maxFiles`. A `disconnect()`\n * that turns out to be an in-page move keeps the selection intact.\n /\nexport class FileDropzoneController extends Controller<HTMLElement> {\n static override targets = [\n \"zone\",\n \"trigger\",\n \"input\",\n \"list\",\n \"item\",\n \"itemTemplate\",\n \"name\",\n \"thumb\",\n \"remove\",\n ];\n static override values = {\n maxSize: { type: Number, default: 0 },\n maxFiles: { type: Number, default: 0 },\n allowDuplicates: { type: Boolean, default: false },\n announceDragText: { type: String, default: \"\" },\n announceAddedText: { type: String, default: \"\" },\n announceRemovedText: { type: String, default: \"\" },\n announceRejectedTypeText: { type: String, default: \"\" },\n announceRejectedSizeText: { type: String, default: \"\" },\n announceRejectedDuplicateText: { type: String, default: \"\" },\n announceRejectedCountText: { type: String, default: \"\" },\n };\n static actions = [\"onChange\", \"onDragLeave\", \"onDragOver\", \"onDrop\", \"openDialog\"] as const;\n static events = [\"change\", \"reject\", \"reconcile\"] as const;\n\n declare readonly inputTarget: HTMLInputElement;\n declare readonly listTarget: HTMLElement;\n declare readonly listTargets: HTMLElement[];\n declare readonly triggerTarget: HTMLElement;\n declare readonly itemTemplateTarget: HTMLTemplateElement;\n declare readonly hasInputTarget: boolean;\n declare readonly hasListTarget: boolean;\n declare readonly hasTriggerTarget: boolean;\n declare readonly hasItemTemplateTarget: boolean;\n declare readonly hasZoneTarget: boolean;\n declare readonly zoneTarget: HTMLElement;\n\n declare maxSizeValue: number;\n declare maxFilesValue: number;\n declare allowDuplicatesValue: boolean;\n declare announceDragTextValue: string;\n declare announceAddedTextValue: string;\n declare announceRemovedTextValue: string;\n declare announceRejectedTypeTextValue: string;\n declare announceRejectedSizeTextValue: string;\n declare announceRejectedDuplicateTextValue: string;\n declare announceRejectedCountTextValue: string;\n\n /* Selected files paired with their rendered item and any preview objectURL. /\n readonly #entries: Entry[] = [];\n /* Whether a drag is currently over the zone; the source for `data-dragover`. /\n #dragging = false;\n /* Whether this connection already reported its unusable item template. /\n #warnedTemplate = false;\n readonly #gate = new DetachGate();\n readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n\n /* Subscribes to the Turbo cache rewind and re-arms the template diagnostic. /\n override connect(): void {\n this.#gate.cancel();\n this.#warnedTemplate = false;\n this.#beforeCache.activate();\n }\n\n /\n Releases the delegated listeners. The selection itself survives an in-page\n * move and is released only once the gate proves a real detach — revoking a\n * preview URL on a move would leave a live item pointing at a dead `blob:`.\n /\n override disconnect(): void {\n for (const list of this.listTargets) list.removeEventListener(\"click\", this.#onItemClick);\n this.#beforeCache.deactivate();\n this.#gate.disconnected(this, () => this.#teardown());\n }\n\n /\n Binds removal and restores client-only previews for every list this controller\n * renders into — the one present at connect and any Turbo puts in its place.\n * This is the only place the listener is attached, so the pair with\n * {@link listTargetDisconnected} keeps it from outliving the element it is on.\n /\n listTargetConnected(list: HTMLElement): void {\n this.#bindList(list);\n }\n\n /* Releases only the list target that actually disconnected. /\n listTargetDisconnected(list: HTMLElement): void {\n list.removeEventListener(\"click\", this.#onItemClick);\n }\n\n /* Binds delegated removal once and moves live preview items into the current list. /\n #bindList(list: HTMLElement): void {\n list.addEventListener(\"click\", this.#onItemClick);\n for (const entry of this.#entries) {\n if (!list.contains(entry.item)) list.appendChild(entry.item);\n }\n }\n\n /* Opens the native file dialog. Bound via `data-action` (trigger click). /\n openDialog(): void {\n if (this.#isDisabled) return;\n this.inputTarget.click();\n }\n\n /\n Adds the files chosen through the native dialog. The input holds only what\n * the dialog just returned, so the accepted set is written back over it once\n * the batch is validated.\n /\n onChange(): void {\n const files = this.inputTarget.files;\n if (files) this.#addFiles(files);\n else this.#syncInput();\n }\n\n /\n Marks the zone as a drop target and announces the affordance once per drag.\n * Bound via `data-action` (dragover). Leaving the default alone is what refuses\n * the drop, so a disabled field and a drag an inner dropzone already claimed\n * both fall through untouched.\n /\n onDragOver(event: DragEvent): void {\n if (event.defaultPrevented \|\| this.#isDisabled) return;\n event.preventDefault();\n if (this.#dragging) return;\n this.#dragging = true;\n if (this.hasZoneTarget) this.zoneTarget.setAttribute(DRAGOVER_ATTRIBUTE, \"\");\n // No file is involved yet, so only `{total}` resolves; the rest stay as authored.\n announce(fillTemplate(this.announceDragTextValue, { total: this.#entries.length }));\n }\n\n /\n Clears the drag-over flag when the pointer leaves the zone. Bound via\n * `data-action` (dragleave). `dragleave` bubbles from every descendant the\n * pointer crosses, so the flag only drops when the element being entered is\n * outside the zone (or there is none, the pointer having left the window).\n /\n onDragLeave(event: DragEvent): void {\n const next = event.relatedTarget;\n if (this.hasZoneTarget && next instanceof Node && this.zoneTarget.contains(next)) return;\n this.#endDrag();\n }\n\n /* Accepts dropped files, clearing the drag-over state. Bound via `data-action` (drop). /\n onDrop(event: DragEvent): void {\n if (event.defaultPrevented) return;\n this.#endDrag();\n if (this.#isDisabled) return;\n event.preventDefault();\n if (event.dataTransfer?.files) this.#addFiles(event.dataTransfer.files);\n }\n\n /\n Removes the file whose remove button was clicked. Delegated on the list\n * container rather than bound per item via `data-action`, so it works the instant\n * an item is appended without waiting on Stimulus to wire a freshly created element.\n * Only the item's declared `remove` target counts, so an authored second control\n * inside an item does what it says instead of silently discarding the file. The\n * button has to belong to a tracked item, which is what makes a list this\n * controller no longer renders into inert — its items moved out with it.\n /\n readonly #onItemClick = (event: MouseEvent): void => {\n const button = (event.target as HTMLElement).closest<HTMLButtonElement>(\n 'button[data-stimeo--file-dropzone-target~=\"remove\"]',\n );\n const index = this.#entries.findIndex((entry) => entry.item.contains(button));\n if (index !== -1) this.#removeAt(index);\n };\n\n /* Validates each incoming file, renders the accepted ones, and reports the batch. /\n #addFiles(files: FileList): void {\n this.#rehome();\n if (this.hasZoneTarget) this.zoneTarget.removeAttribute(INVALID_ATTRIBUTE);\n const rejected = new Map<RejectReason, RejectBatch>();\n const turnedAway: Array<{ file: File; reason: RejectReason }> = [];\n let addedName = \"\";\n let added = 0;\n for (const file of Array.from(files)) {\n const reason = this.#validate(file);\n if (reason !== null) {\n if (this.hasZoneTarget) this.zoneTarget.setAttribute(INVALID_ATTRIBUTE, \"\");\n const batch = rejected.get(reason);\n if (batch) batch.count += 1;\n else rejected.set(reason, { name: file.name, count: 1 });\n turnedAway.push({ file, reason });\n continue;\n }\n // Nothing is rendered when the template is unusable, so nothing was selected\n // either: the set must not report a change it did not make.\n if (!this.#appendFile(file)) continue;\n if (added === 0) addedName = file.name;\n added += 1;\n }\n this.#syncInput();\n // The batch reports what it took before what it turned away — the same order\n // the announcements use. A consumer that clears its rejection notice when a\n // file lands would otherwise wipe the notice for the very drop that raised it.\n if (added > 0) {\n this.#announce(this.announceAddedTextValue, addedName, added);\n this.dispatch(\"change\", { detail: { files: this.#files } });\n }\n for (const { file, reason } of turnedAway) {\n this.dispatch(\"reject\", { detail: { file, reason } });\n }\n for (const [reason, batch] of rejected) {\n this.#announce(this.#rejectText(reason), batch.name, batch.count);\n }\n }\n\n /\n Returns the rejection reason for `file`, or `null` when it is acceptable.\n * The file's own defects are decided first, so a full list still tells the user\n * which files it would never have taken.\n /\n #validate(file: File): RejectReason \| null {\n if (!this.#matchesAccept(file)) return \"type\";\n if (this.maxSizeValue > 0 && file.size > this.maxSizeValue) return \"size\";\n if (\n !this.allowDuplicatesValue &&\n this.#entries.some((entry) => this.#isSame(entry.file, file))\n ) {\n return \"duplicate\";\n }\n const limit = this.#effectiveMaxFiles;\n if (limit > 0 && this.#entries.length >= limit) return \"count\";\n return null;\n }\n\n /\n Whether two files are the same selection. `File` objects from separate picks\n * are never the same reference, so identity is the triple the platform exposes.\n /\n #isSame(a: File, b: File): boolean {\n return a.name === b.name && a.size === b.size && a.lastModified === b.lastModified;\n }\n\n /\n Builds one preview item (name, optional thumbnail, remove button) and reports\n * whether it was rendered.\n /\n #appendFile(file: File): boolean {\n if (!this.hasListTarget) return this.#warnTemplate('a \"list\" target to render into');\n if (!this.hasItemTemplateTarget) return this.#warnTemplate('an \"itemTemplate\" target');\n const fragment = this.itemTemplateTarget.content.cloneNode(true) as DocumentFragment;\n const item = this.#slot(fragment, \"item\");\n const name = this.#slot(fragment, \"name\");\n const thumb = this.#slot<HTMLImageElement>(fragment, \"thumb\");\n const button = fragment.querySelector<HTMLButtonElement>(\n 'button[data-stimeo--file-dropzone-target~=\"remove\"]',\n );\n const removeName = button?.getAttribute(\"aria-label\")?.trim() ?? \"\";\n if (!item) return this.#warnTemplate('an \"item\" root');\n if (!name) return this.#warnTemplate('a \"name\" element');\n if (!button) return this.#warnTemplate('a \"remove\" target <button>');\n if (removeName === \"\") {\n return this.#warnTemplate('a non-empty aria-label on its \"remove\" target');\n }\n name.textContent = file.name;\n // The authored label owns the wording and the language; only `{name}` is filled.\n button.setAttribute(\"aria-label\", fillTemplate(removeName, { name: file.name }));\n\n let url: string \| undefined;\n if (thumb && file.type.startsWith(\"image/\")) {\n url = URL.createObjectURL(file);\n thumb.src = url;\n thumb.alt = file.name;\n thumb.hidden = false;\n } else if (thumb) {\n thumb.hidden = true;\n }\n\n this.listTarget.appendChild(fragment);\n this.#entries.push({ file, item, url });\n return true;\n }\n\n /* Resolves one declared part inside a cloned item template. /\n #slot<T extends HTMLElement = HTMLElement>(fragment: DocumentFragment, name: string): T \| null {\n return fragment.querySelector<T>(`[data-stimeo--file-dropzone-target~=\"${name}\"]`);\n }\n\n /\n Reports an unusable item template to the author, once per connection.\n \n The addition itself stays a no-op — nothing about the selection, the native\n * input, the announcements, or the events changes. Without this line the only\n * symptom is a picker that accepts no file at all, and the causes the Inspector\n * cannot see statically (a server-rendered template, a name that renders empty\n * from a missing translation) would have no diagnostic anywhere.\n /\n #warnTemplate(missing: string): false {\n if (!this.#warnedTemplate) {\n this.#warnedTemplate = true;\n console.warn(\n `Stimeo UI: \"${this.identifier}\" added no file because its item template lacks ${missing}.`,\n );\n }\n return false;\n }\n\n /* Removes entry `index`, revokes its preview, and re-homes focus. /\n #removeAt(index: number): void {\n const entry = this.#entries[index];\n if (!entry) return;\n if (entry.url) URL.revokeObjectURL(entry.url);\n entry.item.remove();\n this.#entries.splice(index, 1);\n this.#syncInput();\n this.#announce(this.announceRemovedTextValue, entry.file.name, 1);\n this.dispatch(\"change\", { detail: { files: this.#files } });\n\n const buttons = this.#removeButtons;\n if (buttons.length === 0) {\n if (this.hasTriggerTarget) this.triggerTarget.focus();\n } else {\n (buttons[index] ?? buttons[buttons.length - 1])?.focus();\n }\n }\n\n /* Whether `file` satisfies the input's `accept` list (empty accepts all). /\n #matchesAccept(file: File): boolean {\n const accept = this.inputTarget.accept.trim();\n if (accept === \"\") return true;\n const name = file.name.toLowerCase();\n const type = file.type.toLowerCase();\n return accept.split(\",\").some((raw) => {\n const token = raw.trim().toLowerCase();\n if (token === \"\") return false;\n if (token.startsWith(\".\")) return name.endsWith(token);\n if (token.endsWith(\"/\")) return type.startsWith(token.slice(0, -1));\n return type === token;\n });\n }\n\n /*\n Sends one consumer-worded message to the page's shared announcer. `{name}` is\n * the file the message is about, `{count}` how many files it covers, and\n * `{total}` how many are selected once the batch has settled.\n /\n #announce(template: string, name: string, count: number): void {\n announce(fillTemplate(template, { name, count, total: this.#entries.length }));\n }\n\n /* The consumer's wording for one rejection reason. /\n #rejectText(reason: RejectReason): string {\n switch (reason) {\n case \"type\":\n return this.announceRejectedTypeTextValue;\n case \"size\":\n return this.announceRejectedSizeTextValue;\n case \"duplicate\":\n return this.announceRejectedDuplicateTextValue;\n case \"count\":\n return this.announceRejectedCountTextValue;\n }\n }\n\n /\n Mirrors the accepted set onto the native input, so a plain form submit carries\n * the dropped files. Skipped where `DataTransfer` cannot be constructed: the\n * widget keeps working and the consumer still receives every `File` on `change`.\n /\n #syncInput(): void {\n // The rewind runs from the shared before-cache pass, where a throw would rob\n // every later subscriber of its own rewind — and a morph can take the input\n // target away before that point.\n if (!this.hasInputTarget) return;\n const transfer = this.#newTransfer();\n if (!transfer) return;\n for (const entry of this.#entries) transfer.items.add(entry.file);\n this.inputTarget.files = transfer.files;\n }\n\n /* A usable empty `DataTransfer`, or `null` where the platform has none. /\n #newTransfer(): DataTransfer \| null {\n try {\n return new DataTransfer();\n } catch {\n // No constructor at all, or one that refuses construction.\n return null;\n }\n }\n\n /\n Moves surviving preview items back under the current list. A morph that\n * empties the list in place leaves the selection with no rendering, and the\n * files it holds cannot be rebuilt from the DOM, so the items are re-homed\n * rather than forgotten.\n /\n #rehome(): void {\n if (!this.hasListTarget) return;\n for (const entry of this.#entries) {\n if (!this.listTarget.contains(entry.item)) this.listTarget.appendChild(entry.item);\n }\n }\n\n /* Drops the drag-over state, whether the drag ended in a drop or left the zone. /\n #endDrag(): void {\n this.#dragging = false;\n if (this.hasZoneTarget) this.zoneTarget.removeAttribute(DRAGOVER_ATTRIBUTE);\n }\n\n /\n Discards the selection and every state attribute this controller wrote, so\n * neither a cached snapshot nor a stranded subtree keeps items whose files are\n * gone. Silent: `change` means a selection the user changed, and the cache\n * rewind reports itself as `reconcile` instead.\n /\n #rewindForCache(): void {\n const had = this.#entries.length > 0;\n this.#reset();\n // The rewind decides the selection is gone, so consumers that painted from\n // `change` (or from `reject`) can drop what they drew before the snapshot is\n // taken. Nothing to report when there was nothing to discard.\n if (had) this.dispatch(\"reconcile\", { detail: { files: this.#files } });\n }\n\n #reset(): void {\n for (const entry of this.#entries) {\n if (entry.url) URL.revokeObjectURL(entry.url);\n entry.item.remove();\n }\n this.#entries.length = 0;\n this.#syncInput();\n this.#endDrag();\n if (this.hasZoneTarget) this.zoneTarget.removeAttribute(INVALID_ATTRIBUTE);\n }\n\n /* Releases the selection once the disconnect is known to be a real detach. /\n #teardown(): void {\n this.#gate.cancel();\n this.#reset();\n }\n\n /* Whether the field refuses input, natively or through an ancestor `fieldset`. /\n get #isDisabled(): boolean {\n return this.inputTarget.disabled \|\| inheritsFieldsetDisabled(this.inputTarget);\n }\n\n /* Effective file cap: `maxFiles`, or 1 when the input is single-select. /\n get #effectiveMaxFiles(): number {\n if (this.maxFilesValue > 0) return this.maxFilesValue;\n return this.inputTarget.multiple ? 0 : 1;\n }\n\n /* The declared remove button of each rendered item, in selection order. /\n get #removeButtons(): HTMLButtonElement[] {\n const buttons: HTMLButtonElement[] = [];\n for (const entry of this.#entries) {\n const button = entry.item.querySelector<HTMLButtonElement>(\n 'button[data-stimeo--file-dropzone-target~=\"remove\"]',\n );\n if (button) buttons.push(button);\n }\n return buttons;\n }\n\n /* The accepted files in selection order. */\n get #files(): File[] {\n return this.#entries.map((entry) => entry.file);\n }\n}\n"]}

package/dist/controllers/filter_controller.d.ts CHANGED Viewed

@@ -30,9 +30,12 @@ type FilterControl = HTMLElement;
  *
  * @remarks
  * Behavior only — the consumer owns all styling and the controls' own accessible
- * state (e.g. `aria-pressed`). Visibility is re-derived from the live DOM on
- * `connect()` (Morph/Turbo-safe) and on every native `change` that bubbles to the
- * root; button toggles that emit no native `change` wire their event to the `apply`
+ * state (e.g. `aria-pressed`); the one exception is `clear`, which writes those
+ * controls one way, to off. Visibility is re-derived from the live DOM on
+ * `connect()`, on every native `change` that bubbles to the root, on the `apply`
+ * and `clear` actions, and when `match` changes at runtime — the declaration
+ * decides what is shown, so an element kept across a morph still follows it.
+ * Button toggles that emit no native `change` wire their event to the `apply`
  * action (e.g. `stimeo--toggle-group:change->stimeo--filter#apply`).
  */
 declare class FilterController extends Controller<HTMLElement> {
@@ -53,6 +56,15 @@ declare class FilterController extends Controller<HTMLElement> {
     matchValue: string;
     connect(): void;
     disconnect(): void;
+    /**
+     * Re-evaluates when the match declaration changes at runtime.
+     *
+     * The declaration decides which items are shown, so an element kept across a
+     * morph — where `connect()` does not run again — still has to follow it instead
+     * of waiting for the next control interaction. The evaluation is the ordinary
+     * one, `change` included: a declaration swap is an evaluation like any other.
+     */
+    matchValueChanged(): void;
     /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */
     apply(): void;
     /** Turns every control off (uncheck / aria-pressed="false") and re-applies. */