@leavepulse/ui 0.43.4 → 0.44.0

package/src/components/LpFileTree.vue

@@ -38,10 +38,21 @@ import LpEmptyState from "./LpEmptyState.vue"
 import LpFileTreeNode from "./LpFileTreeNode.vue"
 import LpScrollArea from "./LpScrollArea.vue"
 import { useMergedAttrs } from "../composables/useMergedClass"
+import { useLabels } from "../composables/useLpConfig"
 
 export type { FileNode } from "./fileTree"
 
 /** Rolled-up stats for the ticked entries — what a backup picker summarises. */
+export interface FileTreeLabels {
+  [key: string]: string
+  empty: string
+  emptyDescription: string
+  file: string
+  files: string
+  folder: string
+  folders: string
+}
+
 export interface FileTreeSummary {
   /** Ticked files (directories excluded — they're containers, not payload). */
   files: number
@@ -84,6 +95,7 @@ const props = withDefaults(
     /** Empty-state copy when `nodes` is empty. */
     emptyLabel?: string
     emptyDescription?: string
+    labels?: Partial<FileTreeLabels>
   }>(),
   {
     sort: true,
@@ -93,8 +105,6 @@ const props = withDefaults(
     showModified: false,
     loading: false,
     skeletonRows: 8,
-    emptyLabel: "No files",
-    emptyDescription: "This folder is empty.",
   },
 )
 
@@ -131,6 +141,19 @@ watch(
   },
 )
 
+const text = useLabels<FileTreeLabels>(
+  "fileTree",
+  {
+    empty: "No files",
+    emptyDescription: "This folder is empty.",
+    file: "file",
+    files: "files",
+    folder: "folder",
+    folders: "folders",
+  },
+  () => props.labels,
+)
+
 const loadingSet = computed(() => new Set(props.loadingIds ?? []))
 
 // Same controlled/uncontrolled deal as `expanded`.
@@ -229,7 +252,7 @@ const summary = computed<FileTreeSummary>(() => {
   }
 })
 
-watch(summary, (value) => emit("summary", value), { deep: false })
+watch(summary, (value) => emit("summary", value), { immediate: true })
 
 function setChecked(next: Set<string>) {
   checkedIds.value = next
@@ -350,6 +373,9 @@ function expand(node: FileNode) {
 
 function collapse(node: FileNode) {
   if (!openIds.value.has(node.id)) return
+  // A fetch that failed left `children` unset; collapsing lets the next open
+  // ask again instead of showing an empty folder forever.
+  if (node.children === undefined && !loadingSet.value.has(node.id)) requested.delete(node.id)
   const next = new Set(openIds.value)
   next.delete(node.id)
   setExpanded(next)
@@ -506,8 +532,8 @@ const { class: rootClass, attrs: rest } = useMergedAttrs(
   <LpEmptyState
     v-else-if="!roots.length"
     icon="lucide:folder-search"
-    :title="emptyLabel"
-    :description="emptyDescription"
+    :title="emptyLabel ?? text.empty"
+    :description="emptyDescription ?? text.emptyDescription"
   />
 
   <!-- h-full so the tree fills whatever box the caller gave it and the scroll
@@ -558,9 +584,9 @@ const { class: rootClass, attrs: rest } = useMergedAttrs(
       class="shrink-0 border-t border-line px-2 py-1.5 text-xs text-muted"
     >
       <slot name="summary" v-bind="summary">
-        {{ summary.files }} {{ summary.files === 1 ? "file" : "files" }}<template
+        {{ summary.files }} {{ summary.files === 1 ? text.file : text.files }}<template
           v-if="summary.dirs"
-        >, {{ summary.dirs }} {{ summary.dirs === 1 ? "folder" : "folders" }}</template>
+        >, {{ summary.dirs }} {{ summary.dirs === 1 ? text.folder : text.folders }}</template>
         <template v-if="summary.bytes !== undefined"> · {{ summary.sizeLabel }}</template>
       </slot>
     </div>

package/src/components/LpFormField.vue

@@ -16,18 +16,41 @@ export default { inheritAttrs: false }
  * eased box, so the thing being typed into never moves.
  */
 import { Label } from "reka-ui"
-import { useId } from "vue"
+import { computed, useId, useSlots } from "vue"
 import LpShift from "./LpShift.vue"
+import { fieldMessageId, provideField } from "../composables/useField"
 import { useMergedAttrs } from "../composables/useMergedClass"
 
-defineProps<{
+const props = defineProps<{
   label?: string
   hint?: string
   error?: string
   required?: boolean
+  /** Id of the control; generated when unset. The label points at it. */
+  id?: string
+  invalid?: boolean
+  disabled?: boolean
 }>()
 
-const id = useId()
+const generated = useId()
+const id = computed(() => props.id ?? generated)
+const messageId = computed(() => fieldMessageId(id.value))
+const slots = useSlots()
+const hasMessage = computed(() => !!props.error || !!props.hint || !!slots.hint)
+
+// The control inside reads its id, description and states from here, so the
+// label, the message line and aria-invalid stay tied to it without the
+// consumer threading ids by hand.
+provideField(
+  computed(() => ({
+    id: id.value,
+    labelId: props.label ? `${id.value}-label` : undefined,
+    describedBy: hasMessage.value ? messageId.value : undefined,
+    invalid: !!props.invalid || !!props.error,
+    required: !!props.required,
+    disabled: !!props.disabled,
+  })),
+)
 
 // The field stacks label and control with a fixed gap; a denser form needs that gap smaller.
 const { class: rootClass, attrs: rest } = useMergedAttrs(
@@ -44,12 +67,12 @@ const { class: rootClass, attrs: rest } = useMergedAttrs(
   <div
     :class="rootClass"
     v-bind="rest">
-    <Label v-if="label" :for="id" class="text-sm font-medium text-ink">
+    <Label v-if="label" :id="`${id}-label`" :for="id" class="text-sm font-medium text-ink">
       {{ label }}
       <span v-if="required" class="text-danger">*</span>
     </Label>
 
-    <slot :id="id" />
+    <slot :id="id" :describedBy="hasMessage ? messageId : undefined" />
 
     <!-- Swapping hint→error changes the text but not the height, so the eased
          box only ever moves when a message appears or clears.
@@ -60,12 +83,12 @@ const { class: rootClass, attrs: rest } = useMergedAttrs(
          leave every message-less field a row taller than before — and would be
          a step the easing could not cover, since it exists even at height 0. -->
     <LpShift axis="height">
-      <p v-if="error" class="pt-1.5 text-xs text-danger">{{ error }}</p>
+      <p v-if="error" :id="messageId" class="pt-1.5 text-xs text-danger">{{ error }}</p>
       <!-- The hint is a slot as well as a prop: most are a sentence, but some
            carry a link or a unit in <code>, and a prop can only be text. Callers
            had been reaching for `#hint` on the assumption it existed — it
            rendered nothing, so the explanation silently went missing. -->
-      <p v-else-if="hint || $slots.hint" class="pt-1.5 text-xs text-muted">
+      <p v-else-if="hint || $slots.hint" :id="messageId" class="pt-1.5 text-xs text-muted">
         <slot name="hint">{{ hint }}</slot>
       </p>
     </LpShift>

package/src/components/LpImageEditor.vue

@@ -24,6 +24,8 @@ export default { inheritAttrs: false }
  * already know from every avatar cropper.
  */
 import { computed, onBeforeUnmount, ref, shallowRef, watch } from "vue"
+import { useLabels } from "../composables/useLpConfig"
+import { coverScale, cropGeometry, isSideways } from "./imageCrop"
 import { useHotkeys } from "../composables/useHotkeys"
 import { useReveal } from "../composables/useReveal"
 import { useZoomPan } from "../composables/useZoomPan"
@@ -81,15 +83,18 @@ const props = withDefaults(
 // mount. An editor inside a dialog that opens a minute later still draws.
 const { el: revealAnchor, revealed } = useReveal({ immediate: () => !props.animate })
 
-const text = computed(() => ({
-  rotateLeft: "Rotate left",
-  rotateRight: "Rotate right",
-  zoomIn: "Zoom in",
-  zoomOut: "Zoom out",
-  reset: "Reset",
-  canvas: "Crop area — arrows pan, +/− zoom, R rotates, Alt+wheel turns freely",
-  ...props.labels,
-}))
+const text = useLabels(
+  "imageEditor",
+  {
+    rotateLeft: "Rotate left",
+    rotateRight: "Rotate right",
+    zoomIn: "Zoom in",
+    zoomOut: "Zoom out",
+    reset: "Reset",
+    canvas: "Crop area — arrows pan, +/− zoom, R rotates, Alt+wheel turns freely",
+  },
+  () => props.labels,
+)
 
 const ASPECTS: Record<string, number | null> = {
   free: null,
@@ -105,7 +110,24 @@ const rotation = ref(0)
 const viewport = ref<HTMLElement | null>(null)
 const zoom = useZoomPan({ min: 1, max: 6 })
 
-watch(viewport, (el) => zoom.setViewport(el))
+const frameSize = ref<{ width: number; height: number } | null>(null)
+let frameObserver: ResizeObserver | null = null
+
+watch(viewport, (el) => {
+  zoom.setViewport(el)
+  frameObserver?.disconnect()
+  frameObserver = null
+  if (!el) return
+  // Fractional, not clientWidth: a rounded-down frame left a hairline of
+  // background showing along the edges of a turned picture.
+  frameSize.value = { width: el.clientWidth, height: el.clientHeight }
+  if (typeof ResizeObserver !== "undefined") {
+    frameObserver = new ResizeObserver(([entry]) => {
+      frameSize.value = { width: entry.contentRect.width, height: entry.contentRect.height }
+    })
+    frameObserver.observe(el)
+  }
+})
 
 /** Which way up it ends, 0-270, whatever the accumulated angle. */
 const upright = computed(() => ((rotation.value % 360) + 360) % 360)
@@ -114,14 +136,24 @@ const upright = computed(() => ((rotation.value % 360) + 360) % 360)
  *  back to where it started is not an edit, however far the dial travelled. */
 const edited = computed(() => upright.value !== 0 || zoom.scale.value !== 1)
 
+// Each file gets a generation: a slow decode of an earlier file must neither
+// replace the current picture nor leak the bitmap it produced.
+let generation = 0
+
 watch(
   () => props.file,
   async (file) => {
     revoke()
     rotation.value = 0
     zoom.reset()
+    const mine = ++generation
     objectUrl.value = URL.createObjectURL(file)
-    source.value = await decode(file, objectUrl.value)
+    const decoded = await decode(file, objectUrl.value)
+    if (mine !== generation) {
+      if (decoded instanceof ImageBitmap) decoded.close()
+      return
+    }
+    source.value = decoded
   },
   { immediate: true },
 )
@@ -172,7 +204,11 @@ function revoke() {
   source.value = null
 }
 
-onBeforeUnmount(revoke)
+onBeforeUnmount(() => {
+  generation++
+  revoke()
+  frameObserver?.disconnect()
+})
 
 function rotate(by: number) {
   // Accumulated, never wrapped to 0-359. Normalising made the fourth quarter
@@ -218,7 +254,9 @@ const boxRatio = computed(() => {
   if (ratio) return ratio
   const size = sourceSize.value
   if (!size) return 1
-  const turned = upright.value % 180 !== 0
+  // Snapped to the nearest quarter: a few degrees of levelling must not flip a
+  // landscape frame to portrait.
+  const turned = isSideways(rotation.value)
   const w = turned ? size.height : size.width
   const h = turned ? size.width : size.height
   return w / h
@@ -226,7 +264,31 @@ const boxRatio = computed(() => {
 
 const frameStyle = computed(() => ({ aspectRatio: String(boxRatio.value) }))
 
+/*
+ * The picture is sized to cover the frame AFTER its turn, and centred. Filling
+ * the frame with object-cover and then rotating the element left empty bands
+ * on any non-square frame turned sideways, and at a free angle bare corners.
+ */
+const sized = computed(() => {
+  const size = sourceSize.value
+  const frame = frameSize.value
+  if (!size || !frame || !frame.width || !frame.height) return null
+  const cover = coverScale(size.width, size.height, frame.width, frame.height, rotation.value)
+  const width = size.width * cover
+  const height = size.height * cover
+  return {
+    width: `${width}px`,
+    height: `${height}px`,
+    left: "50%",
+    top: "50%",
+    marginLeft: `${-width / 2}px`,
+    marginTop: `${-height / 2}px`,
+    maxWidth: "none",
+  }
+})
+
 const imageStyle = computed(() => ({
+  ...sized.value,
   ...zoom.style.value,
   // Rotation sits innermost, after the composable's scale and translate, so a
   // drag still moves the picture the way the pointer went once it is turned.
@@ -254,51 +316,31 @@ async function exportImage(): Promise<Blob | null> {
   if (!picture || !size || !frame) return null
   if (!edited.value && props.aspect === "free") return null
 
-  // Work in "upright space": the picture as the person sees it, already
-  // turned. The rotation is re-applied once, when drawing, which keeps the
-  // maths free of quarter-turn special cases.
-  const turned = upright.value % 180 !== 0
-  const uprightW = turned ? size.height : size.width
-  const uprightH = turned ? size.width : size.height
-
-  // object-cover: the picture fills the frame and the overflow is what panning
-  // reaches. One frame pixel is this many upright pixels.
-  const cover = Math.max(frame.clientWidth / uprightW, frame.clientHeight / uprightH)
-  const shown = cover * zoom.scale.value
-  const cropW = Math.min(uprightW, frame.clientWidth / shown)
-  const cropH = Math.min(uprightH, frame.clientHeight / shown)
-
-  // `offset` is in content pixels — the same space the cover scale maps from —
-  // so it converts with `cover`, not with the zoomed scale.
-  const centreX = clamp(
-    uprightW / 2 - zoom.offset.value.x / cover,
-    cropW / 2,
-    uprightW - cropW / 2,
-  )
-  const centreY = clamp(
-    uprightH / 2 - zoom.offset.value.y / cover,
-    cropH / 2,
-    uprightH - cropH / 2,
-  )
-
-  const scale = Math.min(1, props.maxEdge / Math.max(cropW, cropH))
+  // The crop in upright space, from the same geometry the preview is drawn
+  // with, then the whole source drawn through one transform: no per-quarter
+  // special cases, and a free angle comes out as it looked on screen.
+  const crop = cropGeometry({
+    sourceWidth: size.width,
+    sourceHeight: size.height,
+    frameWidth: frameSize.value?.width ?? frame.clientWidth,
+    frameHeight: frameSize.value?.height ?? frame.clientHeight,
+    rotation: rotation.value,
+    scale: zoom.scale.value,
+    offset: zoom.offset.value,
+  })
+
+  const scale = Math.min(1, props.maxEdge / Math.max(crop.width, crop.height))
   const canvas = document.createElement("canvas")
-  canvas.width = Math.max(1, Math.round(cropW * scale))
-  canvas.height = Math.max(1, Math.round(cropH * scale))
+  canvas.width = Math.max(1, Math.round(crop.width * scale))
+  canvas.height = Math.max(1, Math.round(crop.height * scale))
   const ctx = canvas.getContext("2d")
   if (!ctx) return null
 
   ctx.translate(canvas.width / 2, canvas.height / 2)
-  ctx.rotate((upright.value * Math.PI) / 180)
   ctx.scale(scale, scale)
-
-  // Back to source coordinates for the read: a quarter turn swaps the axes.
-  const readW = turned ? cropH : cropW
-  const readH = turned ? cropW : cropH
-  const readX = (turned ? centreY : centreX) - readW / 2
-  const readY = (turned ? centreX : centreY) - readH / 2
-
-  ctx.drawImage(picture, readX, readY, readW, readH, -readW / 2, -readH / 2, readW, readH)
+  ctx.translate(-crop.centre.x, -crop.centre.y)
+  ctx.rotate((rotation.value * Math.PI) / 180)
+  ctx.drawImage(picture, -size.width / 2, -size.height / 2)
 
   return await new Promise<Blob | null>((resolve) =>
     canvas.toBlob(resolve, outputType.value, props.quality),
@@ -312,10 +354,6 @@ const outputType = computed(() => {
   return ENCODABLE.has(props.file.type) ? props.file.type : "image/png"
 })
 
-function clamp(value: number, low: number, high: number) {
-  return Math.min(Math.max(value, low), Math.max(low, high))
-}
-
 /*
  * The wheel.
  *
@@ -425,8 +463,9 @@ const { class: rootClass, attrs: rest } = useMergedAttrs(
         :src="objectUrl"
         alt=""
         draggable="false"
-        class="lp-editor__image absolute inset-0 size-full select-none object-cover motion-reduce:transition-none"
+        class="lp-editor__image absolute select-none motion-reduce:transition-none"
         :class="[
+          sized ? '' : 'inset-0 size-full object-cover',
           zoom.panning.value ? 'cursor-grabbing' : 'cursor-grab',
           animate && !revealed ? 'lp-editor__image--waiting' : '',
         ]"

package/src/components/LpInput.vue

@@ -5,6 +5,7 @@ export default { inheritAttrs: false }
 <script setup lang="ts">
 import { tv, type VariantProps } from "tailwind-variants"
 import { computed, ref, useAttrs, useSlots } from "vue"
+import { useFieldControl } from "../composables/useField"
 import { useInputFilter } from "../composables/useInputFilter"
 import { mergeClass } from "../composables/useMergedClass"
 import LpFormField from "./LpFormField.vue"
@@ -78,7 +79,7 @@ const props = withDefaults(
 
 defineEmits<{ (e: "update:modelValue", value: string): void }>()
 
-const { isInvalid, onBeforeInput, onPaste } = useInputFilter({
+const { isInvalid, onBeforeInput, onInput: filterInput, onCompositionEnd, onPaste } = useInputFilter({
   pattern: () => props.pattern,
   restrict: () => props.restrict,
 })
@@ -93,9 +94,15 @@ const hasTrailing = computed(() => !!slots.trailing)
 const hasField = computed(
   () => !!props.label || !!props.hint || !!props.error,
 )
-const isInvalidState = computed(
-  () => props.invalid || !!props.error || patternInvalid.value,
-)
+const field = useFieldControl(() => ({
+  wrapped: hasField.value,
+  hasMessage: !!props.error || !!props.hint,
+  id: typeof attrs.id === "string" ? attrs.id : undefined,
+  invalid: props.invalid || !!props.error || patternInvalid.value,
+  required: props.required,
+  disabled: props.disabled,
+}))
+const isInvalidState = computed(() => field.value.invalid)
 const shellClass = computed(() =>
   shell({ size: props.size, invalid: isInvalidState.value }),
 )
@@ -126,6 +133,7 @@ defineExpose({
     :hint="hasField ? hint : undefined"
     :error="hasField ? error : undefined"
     :required="hasField ? required : undefined"
+    :id="hasField ? field.id : undefined"
     :class="hasField ? rootClass : undefined"
     :style="hasField ? rootStyle : undefined"
   >
@@ -140,12 +148,14 @@ defineExpose({
       <input
         ref="inputEl"
         v-bind="inputAttrs"
+        :id="field.id"
         :type="type"
         :value="modelValue"
         :placeholder="placeholder"
-        :disabled="disabled"
-        :required="required || undefined"
+        :disabled="field.disabled"
+        :required="field.required || undefined"
         :aria-invalid="isInvalidState || undefined"
+        :aria-describedby="field.describedBy"
         :class="[
           'lp-autofill min-w-0 flex-1 self-stretch bg-transparent outline-none placeholder:text-muted',
           hasLeading ? 'pl-2' : padX[size ?? 'md'],
@@ -153,7 +163,8 @@ defineExpose({
         ]"
         @beforeinput="onBeforeInput"
         @paste="onPaste"
-        @input="$emit('update:modelValue', ($event.target as HTMLInputElement).value)"
+        @compositionend="onCompositionEnd"
+        @input="filterInput($event); $emit('update:modelValue', ($event.target as HTMLInputElement).value)"
       />
       <slot name="trailing" />
     </div>